datalad remove(1) | General Commands Manual | datalad remove(1) |
datalad remove - remove components from datasets
datalad remove [-h] [-d DATASET] [-r] [--nocheck] [--nosave] [-m MESSAGE] [--if-dirty {fail,save-before,ignore}] [PATH ...]
This command can remove subdatasets and paths, including non-empty directories, from datasets. Removing a component implies dropping present content and uninstalling associated subdatasets. Subsequently, the component is "unregistered" from the respective dataset. This means that the component is no longer present on the file system.
By default, the availability of at least one remote copy is verified before file content is dropped. As these checks could lead to slow operation (network latencies, etc), they can be disabled.
Permanently remove a subdataset from a dataset and wipe out the subdataset association too::
% datalad remove -d <path/to/dataset> <path/to/subds>
Permanently remove a dataset and all subdatasets::
% datalad remove -d <path/to/dataset/> -r
Permanently remove a dataset and all subdatasets even if there are fewer than the configured minimum number of (remote) sources for data::
% datalad remove -d <path/to/dataset/> -r --nocheck
datalad is developed by The DataLad Team and Contributors <team@datalad.org>.
2021-02-04 | datalad remove 0.14.0 |