pytest-forked

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytest_forked-1.7.5.tar.gz (13.0 kB view details)

Uploaded Aug 8, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pytest_forked-1.7.5-py3-none-any.whl (6.3 kB view details)

Uploaded Aug 8, 2026 Python 3

File details

Details for the file pytest_forked-1.7.5.tar.gz.

File metadata

Download URL: pytest_forked-1.7.5.tar.gz
Upload date: Aug 8, 2026
Size: 13.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pytest_forked-1.7.5.tar.gz
Algorithm	Hash digest
SHA256	`00f2bee51612f29b8e6b81eed2c3b2975e824c2693394f5bdaf7a1369078ba5f`
MD5	`fa0d304ffbff03dcfa8ce5503c2d5d94`
BLAKE2b-256	`999298bd460b998f9ec053acba2e3efbbca12a9a408ec8648bd55abd2df784f0`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_forked-1.7.5.tar.gz:

Publisher: deploy.yml on pytest-dev/pytest-forked

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pytest_forked-1.7.5.tar.gz
- Subject digest: 00f2bee51612f29b8e6b81eed2c3b2975e824c2693394f5bdaf7a1369078ba5f
- Sigstore transparency entry: 2383988021
- Sigstore integration time: Aug 8, 2026
Source repository:
- Permalink: pytest-dev/pytest-forked@3e8450ba17b184b7070c7e93de140db2f87d9239
- Branch / Tag: refs/tags/v1.7.5
- Owner: https://github.com/pytest-dev
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: deploy.yml@3e8450ba17b184b7070c7e93de140db2f87d9239
- Trigger Event: push