# 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.

this page last updated: 2026-05-26 14:30:00

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug