From 6ed6fb5af55e9ba643fa973b37eeaa4ae020763c Mon Sep 17 00:00:00 2001 From: Soniya Vyas Date: Tue, 26 Nov 2019 13:24:11 +0530 Subject: [PATCH] Replaced testr with stestr The officially supported test runner for Tempest is stestr. overview.rst has frequently used testr as Tempest runner. Hence, there is need to replace it. Change-Id: Ie9f9557ebb791225cb2a9f7dabba67f92a1ac376 Signed-off-by:- Soniya Vyas --- doc/source/overview.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/doc/source/overview.rst b/doc/source/overview.rst index 423214db09..e51b90b96c 100644 --- a/doc/source/overview.rst +++ b/doc/source/overview.rst @@ -116,7 +116,7 @@ as it is simpler, and quicker to work with. $ stestr run --black-regex '\[.*\bslow\b.*\]' '^tempest\.(api|scenario)' will run the same set of tests as the default gate jobs. Or you can - use `unittest`_ compatible test runners such as `testr`_, `pytest`_ etc. + use `unittest`_ compatible test runners such as `stestr`_, `pytest`_ etc. Tox also contains several existing job configurations. For example:: @@ -130,7 +130,6 @@ as it is simpler, and quicker to work with. to run the tests tagged as smoke. .. _unittest: https://docs.python.org/3/library/unittest.html -.. _testr: https://testrepository.readthedocs.org/en/latest/MANUAL.html .. _stestr: https://stestr.readthedocs.org/en/latest/MANUAL.html .. _pytest: https://docs.pytest.org/en/latest/ @@ -269,14 +268,14 @@ and reference data to be used in testing. will have a configuration file already set up to work with your DevStack installation. -Tempest is not tied to any single test runner, but `testr`_ is the most commonly +Tempest is not tied to any single test runner, but `stestr`_ is the most commonly used tool. Also, the nosetests test runner is **not** recommended to run Tempest. After setting up your configuration file, you can execute the set of Tempest -tests by using ``testr`` :: +tests by using ``stestr``. By default, ``stestr`` runs tests in parallel :: - $ testr run --parallel + $ stestr run To run one single test serially :: - $ testr run tempest.api.compute.servers.test_servers_negative.ServersNegativeTestJSON.test_reboot_non_existent_server + $ stestr run --serial tempest.api.compute.servers.test_servers_negative.ServersNegativeTestJSON.test_reboot_non_existent_server