aboutsummaryrefslogtreecommitdiff
path: root/docs/devel/testing.rst
diff options
context:
space:
mode:
authorWillian Rampazzo <willianr@redhat.com>2021-09-23 13:11:40 -0300
committerPhilippe Mathieu-Daudé <philmd@redhat.com>2021-09-27 19:06:47 +0200
commit6676f18fa5e09c437e8aa160befa096415e09aae (patch)
treed1482d86856e0f0cd12cc6065c6d98c6e3681523 /docs/devel/testing.rst
parent23022794dee93f7bc3213e42cb613c4fc78b90ec (diff)
downloadqemu-6676f18fa5e09c437e8aa160befa096415e09aae.zip
qemu-6676f18fa5e09c437e8aa160befa096415e09aae.tar.gz
qemu-6676f18fa5e09c437e8aa160befa096415e09aae.tar.bz2
docs/devel/testing: add instruction to run a single acceptance test
Add instructions to the Acceptance tests section about running a single test file or a test within the test file. Signed-off-by: Willian Rampazzo <willianr@redhat.com> Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com> Signed-off-by: Philippe Mathieu-Daudé <philmd@redhat.com> Message-Id: <20210923161141.232208-3-willianr@redhat.com>
Diffstat (limited to 'docs/devel/testing.rst')
-rw-r--r--docs/devel/testing.rst28
1 files changed, 28 insertions, 0 deletions
diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst
index d1841e3..c9f6b97 100644
--- a/docs/devel/testing.rst
+++ b/docs/devel/testing.rst
@@ -754,6 +754,34 @@ may be invoked by running:
tests/venv/bin/avocado run $OPTION1 $OPTION2 tests/acceptance/
+Note that if ``make check-acceptance`` was not executed before, it is
+possible to create the Python virtual environment with the dependencies
+needed running:
+
+ .. code::
+
+ make check-venv
+
+It is also possible to run tests from a single file or a single test within
+a test file. To run tests from a single file within the build tree, use:
+
+ .. code::
+
+ tests/venv/bin/avocado run tests/acceptance/$TESTFILE
+
+To run a single test within a test file, use:
+
+ .. code::
+
+ tests/venv/bin/avocado run tests/acceptance/$TESTFILE:$TESTCLASS.$TESTNAME
+
+Valid test names are visible in the output from any previous execution
+of Avocado or ``make check-acceptance``, and can also be queried using:
+
+ .. code::
+
+ tests/venv/bin/avocado list tests/acceptance
+
Manual Installation
-------------------