fovus storage download¶

Download a file or folder from Fovus Storage, including shared files or folders.

Only new or updated files will be downloaded.

For files or folders under My Files, FOVUS_PATH is the relative path with respect to /fovus_storage/files/. For example, the FOVUS_PATH for the file under path “/fovus_storage/files/examples/file.txt” should be just “examples/file.txt”

For shared files or folders under “Shared with me” or “Shared with workspace”, FOVUS_PATH is the full path that can be copied from the web UI with the format “/fovus-storage/shared/ACCESS_TOKEN/PATH/TO/FILE_OR_FOLDER/”

LOCAL_PATH is the local directory where the files will be downloaded to. If not provided, the current working directory will be used.

Usage

fovus storage download [OPTIONS] FOVUS_PATH [LOCAL_PATH]

Options

--include-paths <include_paths>¶

The relative paths to files or folders inside the FOVUS_PATH that will be downloaded. Paths are provided with support for Unix shell-style wildcards.

You can only provide either –include-paths or –exclude-paths, not both.

Supported wildcards: * - matches any number of characters ? - matches any single character

E.g. taskName/out?/*.txt matches any .txt file in folders taskName/out1, taskName/out2, etc.

E.g. taskName???/folder/file.txt matches taskName001/folder/file.txt, taskName123/folder/file.txt, etc.

To specify multiple paths, this option may be provided multiple times or deliminated by a comma (,). To escape a comma, use two commas (,,).

E.g. –include-paths “path1” –include-paths “path2”

E.g. –include-paths “path1,path2”

--exclude-paths <exclude_paths>¶

The relative paths to files or folders inside the FOVUS_PATH that will not be downloaded. Paths are provided with support for Unix shell-style wildcards.

You can only provide either –include-paths or –exclude-paths, not both.

Supported wildcards: * - matches any number of characters ? - matches any single character

E.g. taskName/out?/*.txt matches any .txt file in folders taskName/out1, taskName/out2, etc.

E.g. taskName???/folder/file.txt matches taskName001/folder/file.txt, taskName123/folder/file.txt, etc.

To specify multiple paths, this option may be provided multiple times or deliminated by a comma (,). To escape a comma, use two commas (,,).

E.g. –exclude-paths “path1” –exclude-paths “path2”

E.g. –exclude-paths “path1,path2”

Arguments

FOVUS_PATH¶: Required argument

LOCAL_PATH¶: Optional argument