diff options
author | Monty Taylor <mordred@inaugust.com> | 2018-01-23 10:07:28 -0600 |
---|---|---|
committer | Monty Taylor <mordred@inaugust.com> | 2018-03-18 10:41:40 -0500 |
commit | 68e02466ce13a5dbc01ada10b2704701544717dd (patch) | |
tree | a7f861da7a16996dad71e1821e159f73466075dc /TESTING.rst | |
parent | 35732351ca2e7c35da9e9ec969fdf0873ee8c5e9 (diff) | |
download | zuul-68e02466ce13a5dbc01ada10b2704701544717dd.tar.gz |
Switch to stestr
stestr is actively maintained. OpenStack is migrating to stestr,
go ahead and follow suit.
As part of this, shift the default values for STDOUT capture into the
tox.ini file. This preserves the current behavior of tox doing
capture and running tests directly not capturing.
Remove the depend on python-subunit... stestr takes care of that for us.
Change-Id: I90ae343a5db966f74e888bb98aab0bf39dcdd2cb
Diffstat (limited to 'TESTING.rst')
-rw-r--r-- | TESTING.rst | 27 |
1 files changed, 11 insertions, 16 deletions
diff --git a/TESTING.rst b/TESTING.rst index 289af5c2b..24da82da9 100644 --- a/TESTING.rst +++ b/TESTING.rst @@ -50,6 +50,7 @@ Run The Tests *Navigate to the project's root directory and execute*:: tox + Note: completing this command may take a long time (depends on system resources) also, you might not see any output until tox is complete. @@ -68,9 +69,9 @@ Tox will run your entire test suite in the environments specified in the project To run the test suite in just one of the environments in envlist execute:: tox -e <env> -so for example, *run the test suite in py26*:: +so for example, *run the test suite in py35*:: - tox -e py26 + tox -e py35 Run One Test ------------ @@ -79,20 +80,20 @@ To run individual tests with tox:: tox -e <env> -- path.to.module.Class.test -For example, to *run the basic Zuul test*:: +For example, to *run a single Zuul test*:: - tox -e py27 -- tests.unit.test_scheduler.TestScheduler.test_jobs_executed + tox -e py35 -- tests.unit.test_scheduler.TestScheduler.test_jobs_executed To *run one test in the foreground* (after previously having run tox to set up the virtualenv):: - .tox/py27/bin/python -m testtools.run tests.unit.test_scheduler.TestScheduler.test_jobs_executed + .tox/py35/bin/stestr run -t tests.unit.test_scheduler.TestScheduler.test_jobs_executed List Failing Tests ------------------ - .tox/py27/bin/activate - testr failing --list + .tox/py35/bin/activate + stestr failing --list Hanging Tests ------------- @@ -100,8 +101,8 @@ Hanging Tests The following will run each test in turn and print the name of the test as it is run:: - . .tox/py27/bin/activate - testr run --subunit | subunit2pyunit + . .tox/py35/bin/activate + stestr run You can compare the output of that to:: @@ -110,10 +111,4 @@ You can compare the output of that to:: Need More Info? --------------- -More information about testr: https://wiki.openstack.org/wiki/Testr - -More information about nose: https://nose.readthedocs.org/en/latest/ - - -More information about testing OpenStack code can be found here: -https://wiki.openstack.org/wiki/Testing +More information about stestr: http://stestr.readthedocs.io/en/latest/ |