NAME

       datalad - comprehensive data management solution

SYNOPSIS

       datalad  [-l  LEVEL]  [--pbs-runner  {condor}]  [-C PATH] [--version] [--dbg] [--idbg] [-c KEY=VALUE] [-f
              {default,json,json_pp,tailored,'<template>'}]                                     [--report-status
              {success,failure,ok,notneeded,impossible,error}]   [--report-type   {dataset,file}]  [--on-failure
              {ignore,continue,stop}] [--cmd] [-h]  COMMAND  ...

DESCRIPTION

       DataLad provides a unified data distribution system built on the Git and Git-annex. DataLad command  line
       tools  allow  to  manipulate (obtain, create, update, publish, etc.) datasets and provide a comprehensive
       toolbox for joint management of data and code. Compared to Git/annex it primarly extends their  function‐
       ality to transparently and simultaneously work with multiple inter-related repositories.

OPTIONS

       {create, install, get, add, publish, uninstall, drop, remove, update, create-sibling, create-sibling-
       github, create-sibling-gitlab, unlock, save, search, metadata, aggregate-metadata, extract-metadata, wtf,
       test, ls, clean, add-archive-content, download-url, run, rerun, run-procedure, no-annex, export-to-
       figshare, add-readme, check-dates, export-archive, addurls, annotate-paths, clone, create-test-dataset,
       status, diff, siblings, sshrun, subdatasets}

       -l LEVEL, -\-log-level LEVEL
              set  logging  verbosity  level.  Choose  among critical, error, warning, info, debug. Also you can
              specify an integer <10 to provide even more debugging information

       -\-pbs-runner {condor}
              execute command by scheduling it via available PBS. For settings, config file will be consulted

       -C PATH
              run as if datalad was started in <path> instead of the current working directory. When multiple -C
              options are given, each subsequent non-absolute -C <path> is interpreted relative to the preceding
              -C <path>. This option affects the interpretations of the path names in that they are  made  rela‐
              tive to the working directory caused by the -C option

       -\-version
              show the program's version

       -\-dbg enter Python debugger when uncaught exception happens

       -\-idbg
              enter IPython debugger when uncaught exception happens

       -c KEY=VALUE
              configuration  variable  setting. Overrides any configuration read from a file, but is potentially
              overridden itself by configuration variables in the process environment.

       -f {default, json, json_pp, tailored,'<template>'}, -\-output-format {default, json, json_pp, tai‐
       lored,'<template>'}
              select format for returned command results. 'default' give one line per result  reporting  action,
              status,  path  and  an optional message; 'json' renders a JSON object with all properties for each
              result (one per line); 'json_pp' pretty-prints JSON spanning multiple lines; 'tailored' enables  a
              command-specific rendering style that is typically tailored to human consumption (no result output
              otherwise),  '<template>' reports any value(s) of any result properties in any format indicated by
              the template (e.g. '{path}'; compare with JSON output for all  key-value  choices).  The  template
              syntax follows the Python "format() language". It is possible to report individual dictionary val‐
              ues, e.g. '{metadata[name]}'. If a 2nd-level key contains a colon, e.g. 'music:Genre', ':' must be
              substituted by '#' in the template, like so: '{metadata[music#Genre]}'.

       -\-report-status {success, failure, ok, notneeded, impossible, error}
              constrain  command  result report to records matching the given status. 'success' is a synonym for
              'ok' OR 'notneeded', 'failure' stands for 'impossible' OR 'error'.

       -\-report-type {dataset, file}
              constrain command result report to records matching the given type. Can be given more than once to
              match multiple types.

       -\-on-failure {ignore, continue, stop}
              when an operation fails: 'ignore' and continue with remaining operations, the error is logged  but
              does not lead to a non-zero exit code of the command; 'continue' works like 'ignore', but an error
              causes  a non-zero exit code; 'stop' halts on first failure and yields non-zero exit code. A fail‐
              ure is any result with status 'impossible' or 'error'.

       -\-cmd syntactical helper that can be used to end the list of global command line options before the sub‐
              command label. Options taking an arbitrary number of arguments may require to  be  followed  by  a
              single --cmd in order to enable identification of the subcommand.

       -h, -\-help, -\-help-np
              show  this  help message. --help-np forcefully disables the use of a pager for displaying the help
              message

              "Be happy!"

AUTHORS

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

datalad 0.12.4                                     2020-04-06                                         datalad(1)