datalad wtf - generate a report about the DataLad
installation and configuration
datalad wtf [-h] [-d DATASET]
[-s {some|all}] [-S SECTION] [--flavor {full|short}]
[-D {html_details}] [-c] [--version]
IMPORTANT: Sharing this report with untrusted parties (e.g. on the
web) should be done with care, as it may include identifying information,
and/or credentials or access tokens.
- -h, --help,
--help-np
- show this help message. --help-np forcefully disables the use of a pager
for displaying the help message
- -d DATASET,
--dataset DATASET
- "specify the dataset to report on. no dataset is given, an attempt is
made to identify the dataset based on the current working directory.
Constraints: Value must be a Dataset or a valid identifier of a Dataset
(e.g. a path) or value must be NONE
- -s {some|all},
--sensitive {some|all}
- if set to 'some' or 'all', it will display sections such as config and
metadata which could potentially contain sensitive information
(credentials, names, etc.). If 'some', the fields which are known to be
sensitive will still be masked out. Constraints: value must be one of
('some', 'all')
- -S SECTION, --section
SECTION
- section to include. If not set - depends on flavor. '*' could be used to
force all sections. If there are subsections like section.subsection
available, then specifying just 'section' would select all subsections for
that section. This option can be given multiple times. Constraints: value
must be one of ('configuration', 'credentials', 'datalad', 'dataset',
'dependencies', 'environment', 'extensions', 'git-annex', 'location',
'metadata', 'metadata.extractors', 'metadata.filters',
'metadata.indexers', 'python', 'system', '*')
- --flavor
{full|short}
- Flavor of WTF. 'full' would produce markdown with exhaustive list of
sections. 'short' will provide a condensed summary only of datalad and
dependencies by default. Use --section to list other sections.
Constraints: value must be one of ('full', 'short') [Default: 'full']
- -D {html_details},
--decor {html_details}
- decoration around the rendering to facilitate embedding into issues etc,
e.g. use 'html_details' for posting collapsible entry to GitHub issues.
Constraints: value must be one of ('html_details',)
- -c,
--clipboard
- if set, do not print but copy to clipboard (requires pyperclip
module).
- --version
- show the module and its version which provides the command
datalad is developed by The DataLad Team and Contributors
<team@datalad.org>.