watcher/doc/source/dev/testing.rst

Testing

Unit tests

All unit tests should be run using tox. To run the same unit tests that are executing onto Gerrit which includes py34, py27 and pep8, you can issue the following command:

$ workon watcher
(watcher) $ pip install tox
(watcher) $ cd watcher
(watcher) $ tox

If you want to only run one of the aforementioned, you can then issue one of the following:

$ workon watcher
(watcher) $ tox -e py34
(watcher) $ tox -e py27
(watcher) $ tox -e pep8

You may pass options to the test programs using positional arguments. To run a specific unit test, you can pass extra options to os-testr after putting the -- separator. So using the -r option followed by a regex string, you can run the desired test:

$ workon watcher
(watcher) $ tox -e py27 -- -r watcher.tests.api

When you're done, deactivate the virtualenv:

$ deactivate