summaryrefslogtreecommitdiff
path: root/TESTING.rst
diff options
context:
space:
mode:
authorJames E. Blair <jeblair@redhat.com>2018-03-21 07:49:15 -0700
committerJames E. Blair <jeblair@redhat.com>2018-03-21 07:50:08 -0700
commite56801f2e8a04f08813125b05a4ff8c983beddbd (patch)
tree0151611f4ecd52ae88ae04fe375cf5d2e65a7382 /TESTING.rst
parent883223fdb84c2e0bcb867f2210ff34a300bbc343 (diff)
downloadzuul-e56801f2e8a04f08813125b05a4ff8c983beddbd.tar.gz
Revert "Switch to stestr"
There are several differences between this and testr which we need to discuss. Let's wait until after the v3 release so we don't delay it further. This reverts commit 68e02466ce13a5dbc01ada10b2704701544717dd. Change-Id: I873145c15fd88fe752cb987d0892c146c35041d8
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