.. _rez-test:

========
rez-test
========

.. program:: rez-test

Usage
=====

.. code-block:: text

   rez test [-h] [-l] [--dry-run] [-s] [--inplace]
                   [--extra-packages PKG [PKG ...]] [--paths PATHS] [--nl] [-v]
                   PKG [TEST ...]
   

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

Run tests listed in a package's definition file.


Options
=======

.. option:: -l, --list 

   list package's tests and exit

.. option:: --dry-run 

   dry-run mode: show what tests would have been run, but do not run them

.. option:: -s, --stop-on-fail 

   stop on first test failure

.. option:: --inplace 

   run tests in the current environment. Any test whose requirements are not met by the current environment is skipped

.. option:: --extra-packages <pkg>

   extra packages to add to test environment

.. option:: --paths 

   set package search path

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

   don't load local packages

.. option:: -v, --verbose 

   verbose mode, repeat for more verbosity