Scroll to navigation

datalad add-archive-content(1) datalad datalad add-archive-content(1)


datalad add-archive-content - add content of an archive under git annex control.


datalad add-archive-content [-h] [--annex ANNEX] [--add-archive-leading-dir] [--strip-leading-dirs] [--leading-dirs-depth LEADING_DIRS_DEPTH] [--leading-dirs-consider LEADING_DIRS_CONSIDER] [--use-current-dir] [-d] [--key] [-e EXCLUDE] [-r RENAME] [--existing {fail,overwrite,archive-suffix,numeric-suffix}] [-o ANNEX_OPTIONS] [--copy] [--no-commit] [--allow-dirty] [--stats STATS] [--drop-after] [--delete-after] archive


This results in the files within archive (which must be already under annex control itself) added under annex referencing original archive via custom special remotes mechanism


annex-repo$ datalad add-archive-content my_big_tarball.tar.gz


archive file or a key (if --key specified). Constraints: value must be a string

-h, --help, --help-np
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
--annex ANNEX
annex instance to use. [Default: None]
flag to place extracted content under a directory which would correspond to archive name with suffix stripped. E.g. for archive EXAMPLE.ZIP its content will be extracted under a directory EXAMPLE/. [Default: False]
flag to move all files directories up, from how they were stored in an archive, if that one contained a number (possibly more than 1 down) single leading directories. [Default: False]
--leading-dirs-depth LEADING_DIRS_DEPTH
maximal depth to strip leading directories to. If not specified (None), no limit. [Default: None]
--leading-dirs-consider LEADING_DIRS_CONSIDER
regular expression(s) for directories to consider to strip away. Constraints: value must be a string [Default: None]
flag to extract archive under the current directory, not the directory where archive is located. Note that it will be of no effect if --key is given. [Default: False]
-d, --delete
flag to delete original archive from the filesystem/git in current tree. Note that it will be of no effect if --key is given. [Default: False]
flag to signal if provided archive is not actually a filename on its own but an annex key. [Default: False]
-e EXCLUDE, --exclude EXCLUDE
regular expressions for filenames which to exclude from being added to annex. Applied after --rename if that one is specified. For exact matching, use anchoring. Constraints: value must be a string [Default: None]
-r RENAME, --rename RENAME
regular expressions to rename files before being added under git. First letter defines how to split provided string into two parts: Python regular expression (with groups), and replacement string. Constraints: value must be a string [Default: None]
--existing {fail, overwrite, archive-suffix, numeric-suffix}
what operation to perform a file from archive tries to overwrite an existing file with the same name. 'fail' (default) leads to RuntimeError exception. 'overwrite' silently replaces existing file. 'archive-suffix' instructs to add a suffix (prefixed with a '-') matching archive name from which file gets extracted, and if that one present, 'numeric-suffix' is in effect in addition, when incremental numeric suffix (prefixed with a '.') is added until no name collision is longer detected. [Default: 'fail']
additional options to pass to git-annex. Constraints: value must be a string [Default: None]
flag to copy the content of the archive instead of moving. [Default: False]
flag to not commit upon completion. [Default: True]
flag that operating on a dirty repository (uncommitted or untracked content) is ok. [Default: False]
--stats STATS
ActivityStats instance for global tracking. [Default: None]
drop extracted files after adding to annex. [Default: False]
extract under a temporary directory, git-annex add, and delete after. To be used to "index" files within annex without actually creating corresponding files under git. Note that `annex dropunused` would later remove that load. [Default: False]


datalad is developed by The DataLad Team and Contributors <>.