space:download¶

Download files from a space to your local file system. By default, all files in the source directory will be downloaded.

Tip

You can copy the first part of this command from the CONVERGE Horizon web interface. In your space, navigate to the directory containing the files to download and click . Select horizon space:download to copy the command for downloading from that directory. The copied string will be missing the <destination> argument, which you must provide. You can also edit the string to add any options you want to apply.

Usage

horizon space:download [options] <space> <source> <destination>

Examples

# Download output directory from My Space to current working directory
horizon space:download "My Space" "/my/case/dir_bcb634650910/" .

# Skip files that already exist in current working directory
horizon space:download --resume "My Space" "/my/case/dir_bcb634650910/" .

# Exclude files in _preview directory
horizon space:download --exclude=*_preview* "My Space" "/my/case/dir_bcb634650910/" .

# Download only .log and .out files
horizon space:download --include=*.log --include=*.out "My Space" "/my/case/dir_bcb634650910/" .

# Download only .h5 files, excluding files with "post0003" in the path
horizon space:download --include=*.h5 --exclude=*post0003* "My Space" "/my/case/dir_bcb634650910/" .

Arguments

<space>: The name or ID of the space from which files will be downloaded. You can get the space ID by running space:list or by navigating to the space in the web interface and clicking in the File Manager.
<source>: The path to the directory in the space from which files will be downloaded. You can copy the path by navigating to the directory in the web interface and clicking in the File Manager. To download all files in the space, specify "/".
<destination>: The path to the directory on your local file system to which files will be downloaded (relative to current directory).

Options

This command supports the general CLI options in addition to those listed below.

--exclude=PATTERN, -e PATTERN: Exclude files with paths that match PATTERN (use * to match any character in the file path). The PATTERN is compared to the entire file path, not just the file name. If you use this option in conjunction with --include, the included files are processed before the excluded files.
--include=PATTERN, -i PATTERN: Download only the files with paths that match PATTERN (use * to match any character in the file path). The PATTERN is compared to the entire file path, not just the file name. If you use this option in conjunction with --exclude, the included files are processed before the excluded files.
--resume, -R: Do not download files from <source> that already exist in <destination>. This option is useful for resuming downloads that were not completed.