NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #505 most downloaded on PyPI
pytest plugin to re-run tests to eliminate flaky failures
Last release 17 days ago
17 Sep 2026
Release timing varies
gaps range from 8 days to 8 months
Nearly every release is documented
notes for 41 of 44 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
44 releases · first in 2012
Allow configuring only_rerun regular expressions in pytest.ini files. (#165 _)
Allow configuring only_rerun regular expressions in pytest.ini files. (#165)
Show each rerun attempt and its final outcome in the rerun test summary info section. (#191)
Allow flaky marker conditions to inspect the exception that caused a failed test phase, including when running with pytest-xdist. (#230)
Match only_rerun against the full exception chain (__cause__ and __context__), not only the outermost exception. Match rerun_except against explicit __cause__ links only, so implicit except / finally context does not suppress reruns. (#353)
Fix INTERNALERROR when only_rerun or rerun_except is given a bare exception class instead of a list. (#362)
Fix subtest reruns with newer pytest versions that use structured NodeId values internally. (#363)
Mark teardown failures from an attempt that is rerun as reruns, so a later successful attempt is not reported as an error. (#366)
One column per quarter.
Replace deprecated Config.getvalue() calls with Config.getoption(). (#345 _)
Ensure teardown reports are passed to pytest_runtest_logreport for rerun attempts. (#237)
Prevent superseded built-in subtest failures from remaining in the final test result when rerunning tests with pytest-xdist. (#350)
Restore module, class, and session scoped fixture teardown when a flaky marker condition is falsy. (#351)
Restore module, class, and session scoped fixture teardown when an error raised during teardown rules out a re-run. (#356)
Keep module, class, and session scoped fixtures alive across re-runs of a test whose call phase failed through subtests only. (#357)
Authenticate xdist StatusDB connections with a per-session token. (#358)
Ensure negative rerun counts do not skip the initial test execution. (#359)
Replace deprecated Config.getvalue() calls with Config.getoption(). (#345)
Add a repeatable --rerun-exclude-path option to exclude test files or directories from reruns. (#232 _)
Add --max-suite-reruns option to cap the total number of reruns across the entire test suite. Once the limit is reached, no further reruns occur regar
Add --max-suite-reruns option to cap the total number of reruns across the entire test suite. Once the limit is reached, no further reruns occur regardless of per-test --reruns or @pytest.mark.flaky settings. (#298)
Create a new test class instance for each rerun. Previously the instance of the failed attempt was reused, so state stored on self leaked into the rerun and broke test isolation. Fixtures cached at class scope or higher are still not re-executed. (#268)
Prevent a rerun when a fixture teardown raises an error matching --rerun-except. Previously only the error from the current test stage was considered, so a --rerun-except-matching error raised during teardown was ignored and the test was rerun anyway. (#270)
Breaking changes ++++++++++++++++
Drop support for pytest 8.1. Minimum pytest version is now 8.2.
Add support for pytest 9.1.
Rerun tests with failed subtests. This feature is only available on pytest 9.0 and later. The pytest-subtests plugin is not supported. Fixes #315.
Add --reruns-delay-backoff-factor option (and the matching reruns_delay_backoff_factor marker kwarg / ini setting) to grow the rerun delay after each attempt for an exponential backoff. The delay before the n-th re-run is reruns_delay * reruns_delay_backoff_factor ** (n - 1). The default factor is 1.0, so existing behaviour (a constant delay) is unchanged.
Add --reruns-mode option (strict or append). With append, marker reruns and the global --reruns / reruns ini setting are summed instead of the marker
Add --reruns-mode option (strict or append). With append, marker reruns and the global --reruns / reruns ini setting are summed instead of the marker taking strict priority. Default is strict so existing behaviour is unchanged. Fixes #321.
Add --rerun-show-tracebacks option to display tracebacks from failed attempts that were retried, including tests that eventually passed. The rerun summary section is emitted automatically when the flag is set, so -rR is no longer required to see the tracebacks. Fixes #156.
Breaking changes ++++++++++++++++
Drop support for pytest 8.0. Minimum pytest version is now 8.1.
Add support for pytest 9.0.
Fix missing teardown for session and module scoped fixtures when fixture teardown fails. Fixes #314.
Clear fixture finalizers when removing cached results from failed fixtures to fix compatibility with pytest >= 9, which asserts that _finalizers is empty before executing a fixture. Fixes #323.
Accept exception classes (not only regex strings) in the only_rerun and rerun_except marker keyword arguments instead of crashing with an internal error. Fixes #275.
Changed "localhost" to "127.0.0.1" to avoid bad hostname resolution.
Drop support for Python 3.9.
Changed "localhost" to "127.0.0.1" to avoid bad hostname resolution.
Added --force-reruns to override rerun count globally. Fixes #306.
Reverted the ability to access error attributes because of an incompatibility with pytest-xdist _. Fixes #302 _, #303 _.
Reverted the ability to access error attributes because of an incompatibility with pytest-xdist. Fixes #302, #303.
Breaking changes ++++++++++++++++
Drop support for pytest < 8.
Add support for pytest 8.4.x.
Add support for upcoming Python 3.14.
Allow @pytest.mark.flaky(condition) to accept a callable or a string to be evaluated. The evaluated string has access to the exception instance via the error object. (#230)
Fix --fail-on-flaky option to fail the test run with custom exit code only when reruns are detected. (#287 _)
Fix --fail-on-flaky option to fail the test run with custom exit code only when reruns are detected. (#287)
Switched to using the SPDX license identifier in the project metadata.
Change exception filtering logic to match AssertionError raised via assert statements when filtering by "AssertionError". (#292)
Breaking changes ++++++++++++++++
Drop support for Python 3.8.
Drop support for pytest < 7.4.
Fix compatibility with pytest 8.2. (#267)
Add support for pytest 8.2, 8.3.
Add --fail-on-flaky option to fail the test run with custom exit code when test passed on rerun.
Breaking changes ++++++++++++++++
Breaking changes ++++++++++++++++
Breaking changes ++++++++++++++++
Drop support for pytest < 6.2.
Add only_rerun and rerun_except arguments to @pytest.mark.flaky marker.
Add support for pytest 7.3, 7.4.
Failures are now rerun only if they match at least one --only-rerun pattern (if given) and none of the --rerun-except patterns. Previously, using both --only-rerun and --rerun-except together could cause failures to be rerun even if they did not match any --only-rerun pattern, and when using multiple --rerun-except patterns, all failures would be rerun unless they matched every pattern. (#225)
Execute teardown when test was skipped in setup phase of a fixture.
Execute teardown when test was skipped in setup phase of a fixture.
Fix crash during teardown when runtest protocol hook is overwritten by another plugin.
Fix crash during teardown when runtest protocol hook is overwritten by another plugin.
Fix crash during teardown when TestCase class is used as base class.
Run teardown of session, class, ... scoped fixtures only once after rerunning tests
Run teardown of session, class, ... scoped fixtures only once after rerunning tests
Expose reruns and reruns_delay through pytest.ini file.
Breaking changes ++++++++++++++++
Drop support for Python 3.6.
Drop support for pytest < 6.
Fix crash when pytest-xdist is installed but disabled. (Thanks to @mgorny for the PR.)
Fix crash when xfail(strict=True) mark is used with --rerun-only flag.
Added option --rerun-except to rerun failed tests those are other than the mentioned Error.
Add support for Python 3.11.
Add support for pytest 7.0, 7.1, 7.2.
Nothing published for this version
Allow recovery from crashed tests with pytest-xdist.
Allow recovery from crashed tests with pytest-xdist.
Add support for Python 3.10 (as of Python 3.10.rc2). (Thanks to @hugovk for the PR.)
Allows using a str as condition for @pytest.mark.flaky(condition) which gets evaluated dynamically similarly to @pytest.mark.skipif(condition). (#162
Backwards incompatible changes ++++++++++++++++++++++++++++++
Drop support for Python 3.5.
Drop support for pytest < 5.3.
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.)
Check for the resultlog by feature and not by version as pytest master does not provide a consistent version.
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.
Add a new flag --only-rerun to allow for users to rerun only certain errors.
Add a new flag --only-rerun to allow for users to rerun only certain errors.
Drop dependency on mock.
Add support for pre-commit and add a linting tox target. (#117) (PR from @gnikonorov)
Backwards incompatible changes ++++++++++++++++++++++++++++++
Drop support for pytest version 4.4, 4.5 and 4.6.
Drop support for Python 2.7.
Add support for pytest 5.4.
Add support for Python 3.8.
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.
Add support for pytest version 4.4, 4.5, 4.6, 5.0, 5.1 and 5.2.
Explicitly depend on setuptools to ensure installation when working in environments without it. (#98) (PR from @Eric-Arellano)
Backwards incompatible changes ++++++++++++++++++++++++++++++
Drop support for pytest version 3.8 and 3.9.
Add support for pytest version 4.2 and 4.3.
Fixed #83 issue about ignored pytest_runtest_logfinish hooks. (#83) (PR from @KillAChicken)
Backwards incompatible changes ++++++++++++++++++++++++++++++
Drop support for pytest version 3.6 and 3.7.
Add support for pytest version 4.0 and 4.1.
Fixed #77 regression issue introduced in 4.2 related to the rerun attribute on the test report. (#77) (Thanks to @RibeiroAna for the PR).
Drop support for pytest versions < 3.6 to reduce the maintenance burden.
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)
Fixed #64 issue related to setup_class and fixture executions on rerun (Thanks to @OlegKuzovkov_ for the PR).
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).
Add support for pytest 3.6 by using Node.get_closest_marker() (Thanks to @The-Compiler_ for the PR).
Add support for pytest 3.6 by using Node.get_closest_marker() (Thanks to @The-Compiler for the PR).
Added option to add a delay time between test re-runs (Thanks to @Kanguros_ for the PR).
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.
Restored compatibility with pytest-xdist. (Thanks to @davehunt_ for the PR)
Restored compatibility with pytest-xdist. (Thanks to @davehunt for the PR)
Add support for pytest 2.9 up to 3.2
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.
Ensure that other plugins can run after this one, in case of a global setting --rerun=0. (Thanks to @sublee_ for the PR)
Ensure that other plugins can run after this one, in case of a global setting --rerun=0. (Thanks to @sublee for the PR)
Add default value of reruns=1 if pytest.mark.flaky() is called without arguments.
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)
Prepare CLI options to pytest 3.0, to avoid a deprecation warning.
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.
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.)
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.)
Add support for --resultlog option by parsing reruns accordingly.
Add support for --resultlog option by parsing reruns accordingly. (#28)
Improve package description and include CHANGELOG into description.
Improve package description and include CHANGELOG into description.
Rewrite to use newer API of pytest >= 2.3.0
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.)
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →