diff options
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 31 |
1 files changed, 4 insertions, 27 deletions
@@ -24,34 +24,11 @@ them as quickly as possible. You can read more in `the documentation`_. -Running Tests -============= -The testing system is based on a combination of `tox`_ and `testr`_. The canonical -approach to running tests is to simply run the command ``tox``. This will -create virtual environments, populate them with dependencies and run all of -the tests that OpenStack CI systems run. Behind the scenes, tox is running -``testr run --parallel``, but is set up such that you can supply any additional -testr arguments that are needed to tox. For example, you can run: -``tox -- --analyze-isolation`` to cause tox to tell testr to add -``--analyze-isolation`` to its argument list. +Bugs are tracked using launchpad_. -It is also possible to run the tests inside of a virtual environment -you have created, or it is possible that you have all of the dependencies -installed locally already. If you'd like to go this route, the requirements -are listed in ``requirements.txt`` and the requirements for testing are in -``test-requirements.txt``. Installing them via pip, for instance, is simply:: - - pip install -r requirements.txt -r test-requirements.txt - -In you go this route, you can interact with the testr command directly. -Running ``testr run`` will run the entire test suite. ``testr run --parallel`` -will run it in parallel (this is the default incantation tox uses). More -information about testr can be found at: http://wiki.openstack.org/testr - -.. _OpenStack: https://www.openstack.org/ -.. _`the documentation`: http://docs.openstack.org/developer/pbr/ -.. _tox: http://tox.testrun.org/ .. _d2to1: https://pypi.python.org/pypi/d2to1 .. _distutils2: https://pypi.python.org/pypi/Distutils2 .. _PEP 426: http://legacy.python.org/dev/peps/pep-0426/ -.. _testr: https://wiki.openstack.org/wiki/Testr +.. _OpenStack: https://www.openstack.org/ +.. _`the documentation`: http://docs.openstack.org/developer/pbr/ +.. _launchpad: https://launchpad.net/pbr |