Add note on running single tests to HACKING.rst

I haven't done this in a while, and I went through a number of false
starts forgetting the "--", trying to specify "filename:TestClass"
etc. before I got it to work.  Hopefully this saves someone else some
time.

Change-Id: I94590009157cce8d42002089304c66c164bcd6ec
This commit is contained in:
Ian Wienand 2014-10-31 20:14:59 +11:00
parent 17c68382a7
commit 32d63f1de8
1 changed files with 8 additions and 0 deletions

View File

@ -68,6 +68,14 @@ Python packages may also have dependencies that are outside of tox's ability
to install. Please refer to doc/source/devref/development.environment.rst for
a list of those packages on Ubuntu, Fedora and Mac OS X.
To run a single or restricted set of tests, pass a regex that matches
the class name containing the tests as an extra ``tox`` argument;
e.g. ``tox -- TestWSGIServer`` (note the double-hypen) will test all
WSGI server tests from ``nova/tests/test_wsgi.py``; ``--
TestWSGIServer.test_uri_length_limit`` would run just that test, and
``-- TestWSGIServer|TestWSGIServerWithSSL`` would run tests from both
classes.
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