experimental/sources/: pytest-forked-1.6.0 metadata and description
run tests in isolated forked subprocesses
| author | pytest-dev |
| author_email | pytest-dev@python.org |
| classifiers |
|
| description_content_type | text/x-rst |
| license | MIT |
| platform |
|
| requires_python | >=3.7 |
| File | Tox results | History |
|---|---|---|
pytest-forked-1.6.0.tar.gz
|
|
This plugin does not work on Windows because there’s no fork support.
--forked: run each test in a forked subprocess to survive SEGFAULTS or otherwise dying processes.
Installation
Install the plugin with:
pip install pytest-forked
or use the package in develope/in-place mode with a checkout of the pytest-forked repository
pip install -e .
Usage examples
If you have tests involving C or C++ libraries you might have to deal with tests crashing the process. For this case you may use the boxing options:
pytest --forked
which will run each test in a subprocess and will report if a test crashed the process. You can also combine this option with running multiple processes via pytest-xdist to speed up the test run and use your CPU cores:
pytest -n3 --forked
this would run 3 testing subprocesses in parallel which each create new forked subprocesses for each test.
You can also fork for individual tests:
@pytest.mark.forked
def test_with_leaky_state():
run_some_monkey_patches()
This test will be unconditionally boxed, regardless of CLI flag.