Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

pytest plugin to re-run tests to eliminate flaky failures

Project Description


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


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

  • Python 2.7, 3.4, 3.5, 3.6, PyPy, or PyPy3
  • pytest 2.8.7 or newer


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

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 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:

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])


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

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

    def test_fail():
>       assert False
E       assert False AssertionError
============================ rerun test summary info =========================
============================ short test summary info =========================
======================= 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.


  • 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.



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

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.)

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(9.1 kB) Copy SHA256 Hash SHA256
py2.py3 Wheel Dec 23, 2017
(8.8 kB) Copy SHA256 Hash SHA256
Source Dec 23, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting