floraachy
/
pytest2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: updating the docs to make --lfnf more clear

This commit is contained in:
Sean Malloy 2023-08-28 14:51:27 -07:00
parent 722b4877da
commit 75e815f6c1
3 changed files with 13 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
doc/en/how-to/cache.rst
View File

@ -176,17 +176,14 @@ with more recent files coming first.
Behavior when no tests failed in the last run Behavior when no tests failed in the last run
--------------------------------------------- ---------------------------------------------
When no tests failed in the last run, or when no cached ``lastfailed`` data was This option governs the behavior of ``--last-failed``.
found, ``pytest`` can be configured either to run all of the tests or no tests, Determines whether to execute tests when there are no previously (known)
using the ``--last-failed-no-failures`` option, which takes one of the following values: failures or when no cached ``lastfailed`` data was found.
.. code-block:: bash .. code-block:: bash
pytest --last-failed --last-failed-no-failures all # run all tests (default behavior) pytest --last-failed --last-failed-no-failures all # run the full test suite again (default behavior)
pytest --last-failed --last-failed-no-failures none # run no tests and exit pytest --last-failed --last-failed-no-failures none # runs no tests, emits a message about no known failures and exits successfully
The ``--last-failed-no-failures`` option governs the behavior of ``--if``.
Default ``all`` runs all tests with no known failures. ``none`` avoids tests and exits successfully when there are no known failures.
The new config.cache object The new config.cache object
-------------------------------- --------------------------------

7
doc/en/reference/reference.rst
View File

@ -1892,12 +1892,11 @@ All the command-line flags can be obtained by running ``pytest --help``::
tests. Optional argument: glob (default: '*'). tests. Optional argument: glob (default: '*').
--cache-clear Remove all cache contents at start of test run --cache-clear Remove all cache contents at start of test run
--lfnf={all,none}, --last-failed-no-failures={all,none} --lfnf={all,none}, --last-failed-no-failures={all,none}
Determines whether to execute tests when there With ``--lf``, determines whether to execute tests when there
are no previously (known) failures or when no are no previously (known) failures or when no
cached ``lastfailed`` data was found. cached ``lastfailed`` data was found.
This option governs the behavior of ``--if``. ``all`` (the default) runs the full test suite again.
Default ``all`` runs all tests with no known failures. ``none`` just emits a message about no known failures and exits successfully.
``none`` avoids tests and exits if no failures.
--sw, --stepwise Exit on test failure and continue from last failing --sw, --stepwise Exit on test failure and continue from last failing
test next time test next time
--sw-skip, --stepwise-skip --sw-skip, --stepwise-skip

10
src/_pytest/cacheprovider.py
View File

@ -499,11 +499,11 @@ def pytest_addoption(parser: Parser) -> None:
dest="last_failed_no_failures", dest="last_failed_no_failures",
choices=("all", "none"), choices=("all", "none"),
default="all", default="all",
help="Determines whether to execute tests when there are no previously (known)" help="With ``--lf``, determines whether to execute tests when there"
"failures or when no cached ``lastfailed`` data was found." "are no previously (known) failures or when no"
"This option governs the behavior of ``--if``." "cached ``lastfailed`` data was found."
"Default ``all`` runs all tests with no known failures." "``all`` (the default) runs the full test suite again."
"``none`` avoids tests and exits if no failures.", "``none`` just emits a message about no known failures and exits successfully.",
) )