pytest-loop 1.0.4

pytest plugin for looping tests

pytest-loop is a plugin for pytest that makes it easy to loop a single test, or multiple tests, a specific number of times or for a certain duration of time. This plugin merges pytest-repeat and pytest-stress with a fix for test results.

Requirements

You will need the following prerequisites in order to use pytest-loop: - Python 3.6+ or PyPy - pytest 6 or newer

Only tested with Pytest version 6.2.5 and 7.0.1.

Installation

To install pytest-loop:

$ pip install pytest-loop

looping a test

Use the --loop command line option to specify how many times you want your test, or tests, to be run:

$ pytest --loop=10 test_file.py

Each test collected by pytest will be run n times.

If you want to mark a test in your code to be looped a number of times, you can use the @pytest.mark.loop(n) decorator:

import pytest


@pytest.mark.loop(3)
def test_loop_decorator():
    pass

looping a test until failure

If you are trying to diagnose an intermittent failure, it can be useful to run the same test over and over again until it fails. You can use pytest’s -x option in conjunction with pytest-loop to force the test runner to stop at the first failure. For example:

$ pytest --loop=1000 -x test_file.py

This will attempt to run test_file.py 1000 times, but will stop as soon as a failure occurs.

Resources

• Release Notes

• Issue Tracker

• Code