.TH "datalad extract-metadata" "1" "2022\-12\-14" "datalad extract-metadata 0.17.10"
.SH NAME
\fBdatalad extract-metadata\fR \- run one or more of DataLad's metadata extractors on a dataset or file.
.SH SYNOPSIS
.nh
.HP
\fBdatalad extract\-metadata\fR [-h] --type NAME [-d\~DATASET] [--version] [FILE ...]


.hy
.SH DESCRIPTION

The result(s) are structured like the metadata DataLad would extract
during metadata aggregation. There is one result per dataset/file.
.PP
Examples:
.PP
Extract metadata with two extractors from a dataset in the current directory
and also from all its files::
.PP
  $ datalad extract\-metadata \-d . \-\-type frictionless_datapackage \-\-type datalad_core
.PP
Extract XMP metadata from a single PDF that is not part of any dataset::
.PP
  $ datalad extract\-metadata \-\-type xmp Downloads/freshfromtheweb.pdf
.SH OPTIONS
.TP
FILE
Path of a file to extract metadata from. Constraints: value must be a string or value must be NONE

.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--type\fR NAME
Name of a metadata extractor to be executed. This option can be given more than once.
.TP
\fB-d\fR \fI\s-1DATASET\s0\fR, \fB--dataset\fR \fI\s-1DATASET\s0\fR
"Dataset to extract metadata from. If no FILE is given, metadata is extracted from all files of the dataset. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) or value must be NONE
.TP
\fB--version\fR
show the module and its version which provides the command
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.