watcher/doc/source/contributor/testing.rst

Developer Testing

Unit tests

All unit tests should be run using tox. Before running the unit tests, you should download the latest watcher from the github. To run the same unit tests that are executing onto Gerrit which includes py36, py37 and pep8, you can issue the following command:

$ git clone https://opendev.org/openstack/watcher
$ cd watcher
$ pip install tox
$ tox

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

$ tox -e py36
$ tox -e py37
$ tox -e pep8

If you only want to run specific unit test code and don't like to waste time waiting for all unit tests to execute, you can add parameters -- followed by a regex string:

$ tox -e py37 -- watcher.tests.api

Tempest tests

Tempest tests for Watcher has been migrated to the external repo watcher-tempest-plugin.