Appearance
systemslab artifact download-all
| Description | Download artifacts under an experiment, context, or job. |
|---|---|
| Usage | systemslab artifact download-all [OPTIONS] [EXPERIMENTS]... |
Description
The systemslab artifact download-all command downloads all artifacts matching the given criteria into an organized directory structure. Artifacts are organized into folders by experiment name (or UUID) and job name.
Options
| Option | Default | Description |
|---|---|---|
[EXPERIMENTS]... | The experiments for which to download artifacts. Required unless --context is provided. | |
--context | Download artifacts from all experiments in this context. Conflicts with providing experiment IDs directly. | |
--job | Restrict to artifacts from a specific job. | |
--run | A specific job run to restrict artifacts to. If not specified then this command will download artifacts for the latest run. | |
--type | Restrict to only artifacts with the provided type. | |
--name | Restrict to only artifacts with the provided name. This can be any POSIX regex. | |
--tag | Restrict to only artifacts which have a tag matching this regex. This can be any POSIX regex. | |
-o, --output | . | The output directory. |
-j, --parallel | 1 | Allow this many downloads to happen in parallel. |
-c, --compression | Compress downloaded artifacts with this compression algorithm. Valid values: bzip, gzip, xz, zstd. | |
--level | default | The compression level to use. The meaning of this value depends on the compression algorithm selected. Can be best, fastest, default, or a numeric value. |
-f, --force | Download artifacts over existing folder structures should they exist. | |
--uuid-folder-names | Use experiment UUIDs as folder names instead of experiment names. By default, folders are named using the experiment name. When this flag is set, folders will always be named using the experiment UUID, ensuring unique and predictable folder names for automated processing. |
Common Options
| Option | Default | Description |
|---|---|---|
--systemslab-url | The URL at which to access the systemslab server. | |
--color | auto | Controls when color is used in the output. Possible values are auto, always, and never. |
--output-format | long | Output format to use when outputting messages. long will result output designed to be human-readable while short is short output meant to be used within scripts. |
Environment Variables
| Variable | Description |
|---|---|
SYSTEMSLAB_URL | Specify the URL used to contact the SystemsLab server. Equivalent to --systemslab-url. |