summaryrefslogtreecommitdiff
path: root/TESTING.rst
diff options
context:
space:
mode:
Diffstat (limited to 'TESTING.rst')
-rw-r--r--TESTING.rst27
1 files changed, 16 insertions, 11 deletions
diff --git a/TESTING.rst b/TESTING.rst
index 24da82da9..289af5c2b 100644
--- a/TESTING.rst
+++ b/TESTING.rst
@@ -50,7 +50,6 @@ 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.
@@ -69,9 +68,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 py35*::
+so for example, *run the test suite in py26*::
- tox -e py35
+ tox -e py26
Run One Test
------------
@@ -80,20 +79,20 @@ To run individual tests with tox::
tox -e <env> -- path.to.module.Class.test
-For example, to *run a single Zuul test*::
+For example, to *run the basic Zuul test*::
- tox -e py35 -- tests.unit.test_scheduler.TestScheduler.test_jobs_executed
+ tox -e py27 -- 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/py35/bin/stestr run -t tests.unit.test_scheduler.TestScheduler.test_jobs_executed
+ .tox/py27/bin/python -m testtools.run tests.unit.test_scheduler.TestScheduler.test_jobs_executed
List Failing Tests
------------------
- .tox/py35/bin/activate
- stestr failing --list
+ .tox/py27/bin/activate
+ testr failing --list
Hanging Tests
-------------
@@ -101,8 +100,8 @@ Hanging Tests
The following will run each test in turn and print the name of the
test as it is run::
- . .tox/py35/bin/activate
- stestr run
+ . .tox/py27/bin/activate
+ testr run --subunit | subunit2pyunit
You can compare the output of that to::
@@ -111,4 +110,10 @@ You can compare the output of that to::
Need More Info?
---------------
-More information about stestr: http://stestr.readthedocs.io/en/latest/
+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