.. _rez-search:

==========
rez-search
==========

.. program:: rez-search

Usage
=====

.. code-block:: text

   rez search [-h] [-t {package,family,variant,auto}] [--nl] [--validate]
                     [--paths PATHS] [-f FORMAT] [--no-newlines] [-l] [-e] [--nw]
                     [--before BEFORE] [--after AFTER] [-v]
                     [PKG]
   

description
===========

Search for packages


Options
=======

.. option:: -t, --type 

   type of resource to search for. If ``auto``, either packages or package families are searched, depending on the value of PKG

   **Choices**: ``package``, ``family``, ``variant``, ``auto``

   **Default**: ``auto``

.. option:: --nl, --no-local 

   don't search local packages

.. option:: --validate 

   validate each resource that is found

.. option:: --paths 

   set package search path (ignores :option:`--no-local` if set)

.. option:: -f, --format 

   format package output, eg '{qualified_name} | {description}'. Valid fields include: authors, base, build_requires, changelog, commands, description, index, name, num_variants, post_commands, pre_commands, private_build_requires, qualified_name, release_message, requires, revision, root, timestamp, tools, uri, uuid, variants, version

.. option:: --no-newlines 

   print newlines as ``\n`` rather than actual newlines

.. option:: -l, --latest 

   when searching packages, only show the latest version of each package

.. option:: -e, --errors 

   only print packages containing errors (implies :option:`--validate`)

.. option:: --nw, --no-warnings 

   suppress warnings

.. option:: --before 

   only show packages released before the given time. Supported formats are: epoch time (eg 1393014494), or relative time (eg -10s, -5m, -0.5h, -10d)

   **Default**: ``0``

.. option:: --after 

   only show packages released after the given time. Supported formats are: epoch time (eg 1393014494), or relative time (eg -10s, -5m, -0.5h, -10d)

   **Default**: ``0``

.. option:: -v, --verbose 

   verbose mode, repeat for more verbosity