Skip to content

Document doctest repetition limits #100

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
ryanduguid wants to merge 1 commit into from
Closed

Document doctest repetition limits #100

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 8 additions & 1 deletion README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ your test, or tests, to be run:

$ pytest --count=10 test_file.py

Each test collected by pytest will be run :code:`count` times.
Each pytest test function collected by pytest will be run :code:`count` times.

If you want to mark a test in your code to be repeated a number of times, you
can use the :code:`@pytest.mark.repeat(count)` decorator:
Expand Down Expand Up @@ -88,6 +88,13 @@ For example:
This will attempt to run test_file.py 1000 times, but will stop as soon as a failure
occurs.

Doctests
--------

Doctests run once, even when :code:`--count` is greater than one. This applies
to doctests collected from Python modules or text files. In a mixed suite,
pytest test functions still repeat as usual.

UnitTest Style Tests
--------------------

Expand Down