diff options
author | Clark Boylan <clark.boylan@gmail.com> | 2023-01-24 10:13:35 -0800 |
---|---|---|
committer | Clark Boylan <clark.boylan@gmail.com> | 2023-03-13 10:19:07 -0700 |
commit | 12a0aca425ead764d722ae23f5a12ae2ec0b4a3f (patch) | |
tree | 3bd0721515d7ca47c91179a77b541c9acdbdbfab /CONTRIBUTING.rst | |
parent | f02b41df74e9ed674a879fdcedd16108a3f269da (diff) | |
download | git-review-12a0aca425ead764d722ae23f5a12ae2ec0b4a3f.tar.gz |
Switch from tox to nox
Recent tox releases have put us on a config treadmill. Avoid these
issues entirely by using nox. Nox is a tox alternative that uses
standard tools like pip and should be simpler to use for us.
Change-Id: Ie79845bbed7ca1254aec466bd5219186fefcdac9
Diffstat (limited to 'CONTRIBUTING.rst')
-rw-r--r-- | CONTRIBUTING.rst | 19 |
1 files changed, 9 insertions, 10 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 9b43ec7..7877dce 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -20,13 +20,13 @@ tools, or review ``bindep.txt`` by hand. 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 +The testing system is based on a combination of nox and testr. The canonical +approach to running tests is to simply run the command `nox`. This will create virtual environments, populate them with dependencies 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 +the tests that OpenStack CI systems run. Behind the scenes, nox is running +`stestr run`, but is set up such that you can supply any additional +stestr arguments that are needed to nox. For example, you can run: +`nox -s tests -- --analyze-isolation` to cause nox to tell testr to add --analyze-isolation to its argument list. It is also possible to run the tests inside of a virtual environment @@ -38,7 +38,6 @@ test-requirements.txt. Installing them via pip, for instance, is simply:: pip install -r requirements.txt -r test-requirements.txt In you go this route, 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: -https://testrepository.readthedocs.io/en/latest/ +Running `stestr run` will run the entire test suite. +More information about testr can be found at: +https://stestr.readthedocs.io/en/latest/README.html |