Skip to content

Commit

Permalink
Add a new Execute Tests section to the Guide
Browse files Browse the repository at this point in the history
Move the `Run` section from examples to the guide.
Also move the misplaced `Rerunning failed tests` section here.
  • Loading branch information
psss committed Jul 12, 2024
1 parent 8eeab56 commit 5c59179
Showing 1 changed file with 34 additions and 26 deletions.
60 changes: 34 additions & 26 deletions docs/guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -830,6 +830,40 @@ copied to the guest.
``finish`` steps yet.


.. _execute-tests:

Execute Tests
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

TODO: Here goes content of examples/run:
https://tmt.readthedocs.io/en/stable/examples.html#run

Rerunning failed tests of previously executed runs
------------------------------------------------------------------

Executing failed tests again after fixing them is now possible
with `tmt run --all --again tests --failed-only`.

This is only possible when you have the run directory available
and `--id` argument provided (or use `--last`) as it needs the data from
execute step to select only failed test cases. After new execute step,
tmt will again merge the results from the previous run with the new ones
to keep all the data for full report.

.. code-block:: shell
$ tmt run
# Some tests fail, some pass
$ tmt run --last --again discover tests --failed-only
# Discover tests to rerun
$ tmt run --all --last --again tests --failed-only
# Run all failed tests again
.. versionadded:: 1.34


.. _multihost-testing:

Multihost Testing
Expand Down Expand Up @@ -909,32 +943,6 @@ test result.

__ https://github.com/teemtee/tmt/tree/main/tests/multihost/complete/data

Rerunning failed tests of previously executed runs
------------------------------------------------------------------

Executing failed tests again after fixing them is now possible
with `tmt run --all --again tests --failed-only`.

This is only possible when you have the run directory available
and `--id` argument provided (or use `--last`) as it needs the data from
execute step to select only failed test cases. After new execute step,
tmt will again merge the results from the previous run with the new ones
to keep all the data for full report.

.. code-block:: shell
$ tmt run
# Some tests fail, some pass
$ tmt run --last --again discover tests --failed-only
# Discover tests to rerun
$ tmt run --all --last --again tests --failed-only
# Run all failed tests again
.. versionadded:: 1.34


Synchronization Libraries
------------------------------------------------------------------

Expand Down

0 comments on commit 5c59179

Please sign in to comment.