Changelog

16.7 (2026-09-17)

Features

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

Bug Fixes

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

Misc

  • Keep the test suite passing when pytest-randomly is installed, including when the outer pytest is started with -p no:randomly. (#218)

  • Test the free-threaded Python 3.14 build in CI, via a new py314t tox environment and a matching workflow job. (#361)

16.6.1 (2026-09-03)

Bug Fixes

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

Misc

  • Replace deprecated Config.getvalue() calls with Config.getoption(). (#345)

16.6 (2026-08-17)

Features

  • Add a repeatable --rerun-exclude-path option to exclude test files or directories from reruns. (#232)

Bug Fixes

  • Fix a regression in version 16.5 which made --pdb unusable even when no reruns were configured. (#342)

16.5 (2026-08-13)

Features

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

Bug Fixes

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

16.4 (2026-07-01)

Breaking changes

  • Drop support for pytest 8.1. Minimum pytest version is now 8.2.

Features

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

16.3 (2026-05-22)

Features

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

16.2 (2026-05-13)

Breaking changes

  • Drop support for pytest 8.0. Minimum pytest version is now 8.1.

Features

  • Add support for pytest 9.0.

Bug fixes

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

16.1 (2025-10-10)

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

16.0.1 (2025-09-02)

  • Reverted the ability to access error attributes because of an incompatibility with pytest-xdist. Fixes #302, #303.

16.0 (2025-08-29)

Breaking changes

  • Drop support for pytest < 8.

Features

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

15.1 (2025-05-08)

Bug fixes

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

Other changes

  • Change exception filtering logic to match AssertionError raised via assert statements when filtering by “AssertionError”. (#292)

15.0 (2024-11-20)

Breaking changes

  • Drop support for Python 3.8.

  • Drop support for pytest < 7.4.

Features

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

14.0 (2024-03-13)

Bug fixes

  • Fix missing teardown for non-function scoped fixtures when using only_rerun or rerun_except queries. (#234) and (#241)

Breaking changes

  • Drop support for Python 3.7.

  • Drop support for pytest < 7.2.

Features

  • Add support for pytest 8.0, 8.1.

13.0 (2023-11-22)

Breaking changes

  • Drop support for pytest < 7.0.

Features

  • Add support for Python 3.12.

Bug fixes

  • Fix crashitem names mismatch between client and server. (#172)

  • Fix crash when setup fails with –rerun-except flag. (#230)

12.0 (2023-07-05)

Breaking changes

  • Drop support for pytest < 6.2.

Features

  • Add only_rerun and rerun_except arguments to @pytest.mark.flaky marker.

  • Add support for pytest 7.3, 7.4.

Bug fixes

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

11.1.2 (2023-03-09)

Bug fixes

  • Execute teardown when test was skipped in setup phase of a fixture.

11.1.1 (2023-02-17)

Bug fixes

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

11.1 (2023-02-09)

Bug fixes

  • Run teardown of session, class, … scoped fixtures only once after rerunning tests

Features

  • Expose reruns and reruns_delay through pytest.ini file.

11.0 (2023-01-12)

Breaking changes

  • Drop support for Python 3.6.

  • Drop support for pytest < 6.

Bug fixes

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

Features

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

10.2 (2021-09-17)

Features

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

10.1 (2021-07-02)

Features

  • Allows using a str as condition for @pytest.mark.flaky(condition) which gets evaluated dynamically similarly to @pytest.mark.skipif(condition). (#162 provided by @15klli)

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