robotframework-retryfailed

What it is and what it does

robotframework-retryfailed is a listener plugin for Robot Framework that intercepts test failures and automatically reruns them based on retry configuration. You attach it to your test execution via command-line arguments and control retry behavior either globally (by passing a retry count to the listener) or per-test (by tagging individual tests with `test:retry(N)` or `task:retry(N)` to specify how many times they should be retried on failure).

The package is minimal and focused: it depends only on robotframework itself and requires Python 3.8 or later. It is useful for handling flaky tests in continuous integration or local test runs without modifying test code. However, the package has not been updated since its initial release in October 2022, so you should verify compatibility with your current Robot Framework version before adopting it.

Use it for:

• Automatically retry flaky integration tests in CI pipelines without modifying test code.
• Tag specific tests with `test:retry(3)` to retry them up to 3 times on failure.
• Set a global retry count via `--listener RetryFailed:2` to retry all failing tests uniformly.
• Handle transient failures in acceptance tests caused by timing or external service issues.
• Reduce false negatives in test suites by distinguishing between real failures and intermittent flakes.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Robot Framework listener that automatically retries failed tests or tasks based on tags or a global retry count parameter.

Yes, if your Robot Framework version is compatible and you need automatic retry logic without modifying test code. The low install friction and permissive license make it a low-risk addition. However, the lack of updates since October 2022 is a concern—verify that it works with your current Robot Framework version before committing to it in production.

Install

robotframework-retryfailed on PyPI

pip install robotframework-retryfailed

uv add robotframework-retryfailed

poetry add robotframework-retryfailed

Installing robotframework-retryfailed

Before you install

Low install friction with a single runtime dependency on robotframework. The package is aging—last release was in October 2022 with no updates since—but the repository remains active and unarchived as of December 2025.

License in practice

Licensed under Apache Software License (permissive), which allows use, modification, and distribution with minimal restrictions.

Quickstart

pip install robotframework-retryfailed

robot --listener RetryFailed:2

*** Test Cases ***
Test Case
    [Tags]    test:retry(2)
    Log    This test will be retried 2 times if it fails

Requires robotframework to be installed and Python 3.8 or later.

Verify before relying

• Whether the package works with Robot Framework versions released after October 2022.
• Current compatibility with Python 3.10, 3.11, or 3.12 despite classifiers listing only 3.8 and 3.9.

Package facts

Evidence: robotframework_retryfailed-0.2.0-py3-none-any.whl

Tags

More Testing packages