Add a --force-reruns to override rerun count globally (#307)

* Add a `--force-reruns` to override rerun count globally

Add a new `--force-reruns` command-line option that can be used to
override the rerun count globally, irrespectively of individual test
markers.

Fixes #306.

Signed-off-by: Michał Górny <mgorny@gentoo.org>

---------

Signed-off-by: Michał Górny <mgorny@gentoo.org>
Co-authored-by: Michael Howitz <icemac@gmx.net>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

CHANGES.rst

@@ -9,6 +9,9 @@ Changelog
 - Drop support for Python 3.9.
 
 
+- Added ``--force-reruns`` to override rerun count globally.
+  Fixes `#306 <https://github.com/pytest-dev/pytest-rerunfailures/issues/306>`_.
+
 16.0.1 (2025-09-02)
 -------------------
 

README.rst

@@ -190,6 +190,16 @@ You can use ``@pytest.mark.flaky(condition)`` similarly as ``@pytest.mark.skipif
 
 Note that the test will re-run for any ``condition`` that is truthy.
 
+Force rerun count
+-----------------
+
+To force a specific re-run count globally, irrespective of the number
+of re-runs specified in test markers, pass ``--force-reruns``:
+
+.. code-block:: bash
+
+   $ pytest --force-reruns 5
+
 Output
 ------
 
@@ -241,6 +251,9 @@ which one takes priority?
 * Second priority is what's specified on the command line, like ``--reruns=2``
 * Last priority is the ``pyproject.toml`` (or ``pytest.ini``) file setting, like ``reruns = 3``
 
+Additionally, all three can be overridden by passing ``--force-reruns`` argument
+on the command line.
+
 .. END-PRIORITY
 
 

docs/cli.rst

@@ -1,6 +1,22 @@
 Command Line Interface Options
 ==============================
 
+.. option:: --force-reruns
+
+   **Description**:
+       Force specified number of reruns, irrespective of the number passed to pytest markers.
+
+   **Type**:
+       Integer
+
+   **Default**:
+       Not set (must be provided)
+
+   **Example**:
+       .. code-block:: bash
+
+           pytest --force-reruns 5
+
 .. option:: --only-rerun
 
    **Description**:

src/pytest_rerunfailures.py

@@ -51,6 +51,14 @@ def pytest_addoption(parser):
     group = parser.getgroup(
         "rerunfailures", "re-run failing tests to eliminate flaky failures"
     )
+    group._addoption(
+        "--force-reruns",
+        action="store",
+        dest="force_reruns",
+        type=int,
+        help="Force rerunning all tests the specified number of times,"
+        " irrespective of individual test markers.",
+    )
     group._addoption(
         "--only-rerun",
         action="append",
@@ -112,6 +120,10 @@ def _get_marker(item):
 
 
 def get_reruns_count(item):
+    reruns = item.session.config.getvalue("force_reruns")
+    if reruns is not None:
+        return reruns
+
     rerun_marker = _get_marker(item)
     # use the marker as a priority over the global setting.
     if rerun_marker is not None:

tests/test_pytest_rerunfailures.py

@@ -1357,3 +1357,19 @@ def test_1(session_fixture, function_fixture):
     result = testdir.runpytest()
     assert_outcomes(result, passed=0, failed=1, rerun=1)
     result.stdout.fnmatch_lines("session teardown")
+
+
+@pytest.mark.parametrize("mark_params", ["", "reruns=1"])
+def test_force_reruns(testdir, mark_params):
+    testdir.makepyfile(
+        f"""
+        import pytest
+
+        @pytest.mark.flaky({mark_params})
+        def test_fail():
+            assert False
+    """
+    )
+
+    result = testdir.runpytest("--force-reruns", "3")
+    assert_outcomes(result, passed=0, failed=1, rerun=3)