.TH "datalad add-archive-content" "1" "2019\-02\-08" ""datalad add-archive-content 0.11.2""
.SH NAME
\fBdatalad add-archive-content\fR \- add content of an archive under git annex control.
.SH SYNOPSIS
.nh
.HP
\fBdatalad add\-archive\-content\fR [-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


.hy
.SH DESCRIPTION

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
.PP
Example:
.PP
  annex\-repo$ datalad add\-archive\-content my_big_tarball.tar.gz
.SH OPTIONS
.TP
archive
archive file or a key (if --key specified). Constraints: value must be a string

.TP
\fB-h\fR, \fB--help\fR, \fB--help-np\fR
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
.TP
\fB--annex\fR \fI\s-1ANNEX\s0\fR
annex instance to use. [Default: None]
.TP
\fB--add-archive-leading-dir\fR
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]
.TP
\fB--strip-leading-dirs\fR
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]
.TP
\fB--leading-dirs-depth\fR \fI\s-1LEADING_DIRS_DEPTH\s0\fR
maximal depth to strip leading directories to. If not specified (None), no limit. [Default: None]
.TP
\fB--leading-dirs-consider\fR \fI\s-1LEADING_DIRS_CONSIDER\s0\fR
regular expression(s) for directories to consider to strip away. Constraints: value must be a string [Default: None]
.TP
\fB--use-current-dir\fR
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]
.TP
\fB-d\fR, \fB--delete\fR
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]
.TP
\fB--key\fR
flag to signal if provided archive is not actually a filename on its own but an annex key. [Default: False]
.TP
\fB-e\fR \fI\s-1EXCLUDE\s0\fR, \fB--exclude\fR \fI\s-1EXCLUDE\s0\fR
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]
.TP
\fB-r\fR \fI\s-1RENAME\s0\fR, \fB--rename\fR \fI\s-1RENAME\s0\fR
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]
.TP
\fB--existing\fR {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']
.TP
\fB-o\fR \fI\s-1ANNEX_OPTIONS\s0\fR, \fB--annex-options\fR \fI\s-1ANNEX_OPTIONS\s0\fR
additional options to pass to git-annex. Constraints: value must be a string [Default: None]
.TP
\fB--copy\fR
flag to copy the content of the archive instead of moving. [Default: False]
.TP
\fB--no-commit\fR
flag to not commit upon completion. [Default: True]
.TP
\fB--allow-dirty\fR
flag that operating on a dirty repository (uncommitted or untracked content) is ok. [Default: False]
.TP
\fB--stats\fR \fI\s-1STATS\s0\fR
ActivityStats instance for global tracking. [Default: None]
.TP
\fB--drop-after\fR
drop extracted files after adding to annex. [Default: False]
.TP
\fB--delete-after\fR
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]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.