pytest-rerunfailures 10.0

pytest plugin to re-run tests to eliminate flaky failures

Contents

• pytest-rerunfailures

  • Requirements

  • Installation

  • Re-run all failures

  • Re-run all failures matching certain expressions

  • Re-run individual failures

  • Output

  • Compatibility

  • Resources

  • Development

• Changelog

  • 10.0 (2021-05-26)

    • Backwards incompatible changes

    • Features

    • Other changes

  • 9.1.1 (2020-09-29)

  • 9.1 (2020-08-26)

    • Features

    • Other changes

  • 9.0 (2020-03-18)

    • Backwards incompatible changes

    • Features

  • 8.0 (2019-11-18)

    • Backwards incompatible changes

    • Features

    • Bug fixes

  • 7.0 (2019-03-28)

    • Backwards incompatible changes

    • Features

    • Bug fixes

  • 6.0 (2019-01-08)

    • Backwards incompatible changes

    • Features

    • Bug fixes

  • 5.0 (2018-11-06)

  • 4.2 (2018-10-04)

  • 4.1 (2018-05-23)

  • 4.0 (2017-12-23)

  • 3.1 (2017-08-29)

  • 3.0 (2017-08-17)

  • 2.2 (2017-06-23)

  • 2.1.0 (2016-11-01)

  • 2.0.1 (2016-08-10)

  • 2.0.0 (2016-04-06)

  • 1.0.2 (2016-03-29)

  • 1.0.1 (2016-02-02)

  • 1.0.0 (2016-02-02)

pytest-rerunfailures

pytest-rerunfailures is a plugin for pytest that re-runs tests to eliminate intermittent failures.

Requirements

You will need the following prerequisites in order to use pytest-rerunfailures:

• Python 3.6, up to 3.9, or PyPy3

• pytest 5.3 or newer

This package is currently tested against the last 5 minor pytest releases. In case you work with an older version of pytest you should consider updating or use one of the earlier versions of this package.

Installation

To install pytest-rerunfailures:

$ pip install pytest-rerunfailures

Re-run all failures

To re-run all test failures, use the --reruns command line option with the maximum number of times you’d like the tests to run:

$ pytest --reruns 5

Failed fixture or setup_class will also be re-executed.

To add a delay time between re-runs use the --reruns-delay command line option with the amount of seconds that you would like wait before the next test re-run is launched:

$ pytest --reruns 5 --reruns-delay 1

Re-run all failures matching certain expressions

To re-run only those failures that match a certain list of expressions, use the --only-rerun flag and pass it a regular expression. For example, the following would only rerun those errors that match AssertionError:

$ pytest --reruns 5 --only-rerun AssertionError

Passing the flag multiple times accumulates the arguments, so the following would only rerun those errors that match AssertionError or ValueError:

$ pytest --reruns 5 --only-rerun AssertionError --only-rerun ValueError

Re-run individual failures

To mark individual tests as flaky, and have them automatically re-run when they fail, add the flaky mark with the maximum number of times you’d like the test to run:

@pytest.mark.flaky(reruns=5)
def test_example():
    import random
    assert random.choice([True, False])

Note that when teardown fails, two reports are generated for the case, one for the test case and the other for the teardown error.

You can also specify the re-run delay time in the marker:

@pytest.mark.flaky(reruns=5, reruns_delay=2)
def test_example():
    import random
    assert random.choice([True, False])

You can also specify an optional condition in the re-run marker:

@pytest.mark.flaky(reruns=5, condition=sys.platform.startswith("win32"))
def test_example():
   import random
   assert random.choice([True, False])

Note that the test will re-run for any condition that is truthy.

Output

Here’s an example of the output provided by the plugin when run with --reruns 2 and -r aR:

test_report.py RRF

================================== FAILURES ==================================
__________________________________ test_fail _________________________________

    def test_fail():
>       assert False
E       assert False

test_report.py:9: AssertionError
============================ rerun test summary info =========================
RERUN test_report.py::test_fail
RERUN test_report.py::test_fail
============================ short test summary info =========================
FAIL test_report.py::test_fail
======================= 1 failed, 2 rerun in 0.02 seconds ====================

Note that output will show all re-runs. Tests that fail on all the re-runs will be marked as failed.

Compatibility

• This plugin may not be used with class, module, and package level fixtures.

• This plugin is not compatible with pytest-xdist’s –looponfail flag.

• This plugin is not compatible with the core –pdb flag.

Resources

• Issue Tracker

• Code

Development

• Test execution count can be retrieved from the execution_count attribute in test item’s object. Example:

  @hookimpl(tryfirst=True)
  def pytest_runtest_makereport(item, call):
      print(item.execution_count)

Changelog

10.0 (2021-05-26)

Backwards incompatible changes

• Drop support for Python 3.5.

• Drop support for pytest < 5.3.

Features

• Add condition keyword argument to the re-run marker. (Thanks to @BeyondEvil for the PR)

• Add support for Python 3.9. (Thanks to @digitronik for the PR)

• Add support for pytest 6.3. (Thanks to @bluetech for the PR)

• Add compatibility with pytest-xdist >= 2.0. (Thanks to @bluetech for the PR)

Other changes

• Check for the resultlog by feature and not by version as pytest master does not provide a consistent version.

9.1.1 (2020-09-29)

Compatibility fix.

• Ignore --result-log command line option when used together with pytest >= 6.1.0, as it was removed there. This is a quick fix, use an older version of pytest, if you want to keep this feature for now. (Thanks to @ntessore for the PR)

• Support up to pytest 6.1.0.

9.1 (2020-08-26)

Features

• Add a new flag --only-rerun to allow for users to rerun only certain errors.

Other changes

• Drop dependency on mock.

• Add support for pre-commit and add a linting tox target. (#117) (PR from @gnikonorov)

9.0 (2020-03-18)

Backwards incompatible changes

• Drop support for pytest version 4.4, 4.5 and 4.6.

• Drop support for Python 2.7.

Features

• Add support for pytest 5.4.

• Add support for Python 3.8.

8.0 (2019-11-18)

Backwards incompatible changes

• Drop support for pytest version 3.10, 4.0, 4.1, 4.2 and 4.3

• Drop support for Python 3.4.

Features

• Add support for pytest version 4.4, 4.5, 4.6, 5.0, 5.1 and 5.2.

Bug fixes

• Explicitly depend on setuptools to ensure installation when working in environments without it. (#98) (PR from @Eric-Arellano)

7.0 (2019-03-28)

Backwards incompatible changes

• Drop support for pytest version 3.8 and 3.9.

Features

• Add support for pytest version 4.2 and 4.3.

Bug fixes

• Fixed #83 issue about ignored pytest_runtest_logfinish hooks. (#83) (PR from @KillAChicken)

6.0 (2019-01-08)

Backwards incompatible changes

• Drop support for pytest version 3.6 and 3.7.

Features

• Add support for pytest version 4.0 and 4.1.

Bug fixes

• Fixed #77 regression issue introduced in 4.2 related to the rerun attribute on the test report. (#77) (Thanks to @RibeiroAna for the PR).

5.0 (2018-11-06)

• Drop support for pytest versions < 3.6 to reduce the maintenance burden.

• Add support up to pytest version 3.10. Thus supporting the newest 5 pytest releases.

• Add support for Python 3.7.

• Fix issue can occur when used together with pytest-flake8 (#73)

4.2 (2018-10-04)

• Fixed #64 issue related to setup_class and fixture executions on rerun (Thanks to @OlegKuzovkov for the PR).

• Added new execution_count attribute to reflect the number of test case executions according to #67 issue. (Thanks to @OlegKuzovkov for the PR).

4.1 (2018-05-23)

• Add support for pytest 3.6 by using Node.get_closest_marker() (Thanks to @The-Compiler for the PR).

4.0 (2017-12-23)

• Added option to add a delay time between test re-runs (Thanks to @Kanguros for the PR).

• Added support for pytest >= 3.3.

• Drop support for pytest < 2.8.7.

3.1 (2017-08-29)

• Restored compatibility with pytest-xdist. (Thanks to @davehunt for the PR)

3.0 (2017-08-17)

• Add support for Python 3.6.

• Add support for pytest 2.9 up to 3.2

• Drop support for Python 2.6 and 3.3.

• Drop support for pytest < 2.7.

2.2 (2017-06-23)

• Ensure that other plugins can run after this one, in case of a global setting --rerun=0. (Thanks to @sublee for the PR)

2.1.0 (2016-11-01)

• Add default value of reruns=1 if pytest.mark.flaky() is called without arguments.

• Also offer a distribution as universal wheel. (Thanks to @tltx for the PR)

2.0.1 (2016-08-10)

• Prepare CLI options to pytest 3.0, to avoid a deprecation warning.

• Fix error due to missing CHANGES.rst when creating the source distribution by adding a MANIFEST.in.

2.0.0 (2016-04-06)

• Drop support for Python 3.2, since supporting it became too much of a hassle. (Reason: Virtualenv 14+ / PIP 8+ do not support Python 3.2 anymore.)

1.0.2 (2016-03-29)

• Add support for –resultlog option by parsing reruns accordingly. (#28)

1.0.1 (2016-02-02)

• Improve package description and include CHANGELOG into description.

1.0.0 (2016-02-02)

• Rewrite to use newer API of pytest >= 2.3.0

• Improve support for pytest-xdist by only logging the final result. (Logging intermediate results will finish the test rather rerunning it.)