.. _rez-selftest:

============
rez-selftest
============

.. program:: rez-selftest

Usage
=====

.. code-block:: text

   rez selftest [-h] [-s SHELL] [--keep-tmpdirs] [--bind] [--build]
                       [--cli] [--commands] [--completion] [--config] [--context]
                       [--copy_package] [--formatter] [--imports]
                       [--package_cache] [--package_filter]
                       [--package_repository] [--packages] [--packages_order]
                       [--pip_utils] [--plugin_manager] [--release]
                       [--resources_] [--rex] [--schema] [--shells] [--solver]
                       [--suites] [--test] [--util] [--utils] [--utils_elf]
                       [--utils_filesystem] [--utils_formatting]
                       [--utils_resolve_graph] [--version] [-v]
                       [NAMED_TEST ...]
   

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

Run unit tests. Use pytest if available.


Options
=======

.. option:: -s, --only-shell <shell>

   limit shell-dependent tests to the specified shell. Note: This flag shadowed pytest ``--capture=no`` shorthand :option:`-s`, so the long name must be used for disabling stdout/err capturing in pytest.

.. option:: --keep-tmpdirs 

   Keep temporary directories.

.. option:: --bind 

   test package_bind module

.. option:: --build 

   test the build system

.. option:: --cli 

   test running of all commandline tools (just :option:`-h` on each)

.. option:: --commands 

   test package commands

.. option:: --completion 

   test completions

.. option:: --config 

   test configuration settings

.. option:: --context 

   test resolved contexts

.. option:: --copy_package 

   test package copying

.. option:: --formatter 

   test rex string formatting

.. option:: --imports 

   test importing of all source

.. option:: --package_cache 

   Test package caching

.. option:: --package_filter 

   Test cases for package_filter.py (package filtering)

.. option:: --package_repository 

   Test package repository plugin

.. option:: --packages 

   test package iteration, serialization etc

.. option:: --packages_order 

   Test cases for package_order.py (package ordering)

.. option:: --pip_utils 

   test the pip utilities

.. option:: --plugin_manager 

   test rezplugins manager behaviors

.. option:: --release 

   test the release system

.. option:: --resources_ 

   test core resource system

.. option:: --rex 

   test the rex command generator API

.. option:: --schema 

   unit tests for ``schema`` module

.. option:: --shells 

   test shell invocation

.. option:: --solver 

   test dependency resolving algorithm

.. option:: --suites 

   test suites

.. option:: --test 

   test rez package.py unit tests

.. option:: --util 

   unit tests for ``util`` module

.. option:: --utils 

   unit tests for ``utils.filesystem`` module

.. option:: --utils_elf 

   unit tests for ``rez.utils.elf`` module

.. option:: --utils_filesystem 

   unit tests for ``rez.utils.filesystem`` module

.. option:: --utils_formatting 

   unit tests for ``utils.formatting`` module

.. option:: --utils_resolve_graph 

   unit tests for ``utils.resolve_graph`` module

.. option:: --version 

   unit tests for ``rez.version`` module

.. option:: -v, --verbose 

   verbose mode, repeat for more verbosity