diff options
author | Monty Taylor <mordred@inaugust.com> | 2013-01-08 06:26:00 +0000 |
---|---|---|
committer | Monty Taylor <mordred@inaugust.com> | 2013-02-03 10:54:52 +1100 |
commit | fe4b3498b9cb76c2f6255ce52ebe9b657f5cefda (patch) | |
tree | 0408f52219605f60fd0d28047429e20f5a12cf2c /HACKING.rst | |
parent | 2bca8ee4407aee03a83592395d3191f097c459a5 (diff) | |
download | python-neutronclient-fe4b3498b9cb76c2f6255ce52ebe9b657f5cefda.tar.gz |
Migrate from nose to testr
Part of blueprint grizzly-testtools
Change-Id: Ia53b0987b1e890a96b190f4b1a47dde4bf84fb6f
Diffstat (limited to 'HACKING.rst')
-rw-r--r-- | HACKING.rst | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/HACKING.rst b/HACKING.rst index d99a07f..c764323 100644 --- a/HACKING.rst +++ b/HACKING.rst @@ -185,3 +185,22 @@ For every new feature, unit tests should be created that both test and bug that had no unit test, a new passing unit test should be added. If a submitted bug fix does have a unit test, be sure to add a new one that fails without the patch and passes with the patch. + +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 depenedencies 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. + +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. In this case, 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 |