.TH datalad-search 1 2016\-11\-10 "datalad-search 0.4.1"
.SH SYNOPSIS
 \fBdatalad\-search\fR [--version] [-h] [-l LEVEL] [-p {condor}] [-d DATASET]
               [-s PROPERTY] [-r PROPERTY] [-R] [-f FORMAT] [--regex]
               STRING [STRING ...]


.SH DESCRIPTION
Search within available in datasets' meta data
.br

.br
Yields
.br
\-\-\-\-\-\-
.br
location : str
.br
    (relative) path to the dataset
.br
report : dict
.br
    fields which were requested by REPORT option
.SH OPTIONS
  STRING                a string (or a regular expression if --regex) to
                        search for in all meta data values. If multiple
                        provided, all must have a match among some fields of a
                        dataset.

  \fB--version\fR       show the program's version and license information
  \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
  \fB-l\fR LEVEL, \fB--log-level\fR 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
  \fB-p\fR {condor}, \fB--pbs-runner\fR {condor}
                        execute command by scheduling it via available PBS.
                        For settings, config file will be consulted
  \fB-d\fR \fI\s-1DATASET\s0\fR, \fB--dataset\fR \fI\s-1DATASET\s0\fR
                        specify the dataset to perform the query operation on.
                        If no dataset is given, an attempt is made to identify
                        the dataset based on the current working directory
                        and/or the PATH given. Constraints: Value must be a
                        Dataset or a valid identifier of a Dataset (e.g. a
                        path) [Default: None]
  \fB-s\fR PROPERTY, \fB--search\fR PROPERTY
                        name of the property to search for any match. This
                        option can be given multiple times. By default, all
                        properties are searched. [Default: None]
  \fB-r\fR PROPERTY, \fB--report\fR PROPERTY
                        name of the property to report for any match. This
                        option can be given multiple times. If '*' is given,
                        all properties are reported. [Default: None]
  \fB-R\fR, \fB--report-matched\fR
                        flag to report those fields which have matches. If
                        REPORT option values are provided, union of matched
                        and those in REPORT will be output. [Default: False]
  \fB-f\fR \fI\s-1FORMAT\s0\fR, \fB--format\fR \fI\s-1FORMAT\s0\fR
                        format for output. Constraints: value must be one of
                        ('custom', 'json', 'yaml') [Default: 'custom']
  \fB--regex\fR         flag for STRING to be used as a (Python) regular
                        expression which should match the value. [Default:
                        False]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.