pytest-mergify
Pytest plugin for Mergify Test Insights.
More information at https://mergify.com
Features
- Test tracing — Sends OpenTelemetry traces for every test to Mergify's API
- Flaky test detection — Intelligently reruns tests to detect flakiness with budget constraints
- Test quarantine — Quarantines failing tests so they don't block CI
Installation
Install the package alongside pytest (>= 6.0.0):
pip install pytest-mergify
The plugin is auto-discovered by pytest — no manual registration required.
Configuration
Set the MERGIFY_TOKEN environment variable with your Mergify API token.
The plugin activates automatically when running in CI (detected via the CI environment variable). To enable outside CI, set PYTEST_MERGIFY_ENABLE=true.
Environment Variables
| Variable | Description | Default |
|---|---|---|
MERGIFY_TOKEN |
Mergify API authentication token | (required) |
MERGIFY_API_URL |
Mergify API endpoint | https://api.mergify.com |
PYTEST_MERGIFY_ENABLE |
Force-enable outside CI | false |
PYTEST_MERGIFY_DEBUG |
Print spans to console | false |
MERGIFY_TRACEPARENT |
W3C distributed trace context | — |
MERGIFY_TEST_JOB_NAME |
Mergify test job name | — |
For detailed documentation, see the official guide.
Development
Prerequisites
- Python >= 3.8
- uv
Setup
uv sync
Running Tests
uv run poe test
Linting
uv run poe linters
License
GPL-3.0-only
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pytest_mergify-2026.7.6.1.tar.gz.
File metadata
- Download URL: pytest_mergify-2026.7.6.1.tar.gz
- Upload date:
- Size: 86.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a52f76ba073aac05c0f4244bd7a65ae8343c75f25091e38b76c0f65a6d3dbbda
|
|
| MD5 |
54790b32878d193090a3f6890c412da0
|
|
| BLAKE2b-256 |
0da5b067c84c3017dee22dacbfe6577602b80f8ae75705d32aad2ade4ffd74c8
|
Provenance
The following attestation bundles were made for pytest_mergify-2026.7.6.1.tar.gz:
Publisher:
release.yml on Mergifyio/pytest-mergify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pytest_mergify-2026.7.6.1.tar.gz -
Subject digest:
a52f76ba073aac05c0f4244bd7a65ae8343c75f25091e38b76c0f65a6d3dbbda - Sigstore transparency entry: 2085045916
- Sigstore integration time:
-
Permalink:
Mergifyio/pytest-mergify@7c81bfc7ab6f7bdec06d4b50ae04710315535aea -
Branch / Tag:
refs/tags/2026.7.6.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7c81bfc7ab6f7bdec06d4b50ae04710315535aea -
Trigger Event:
release
-
Statement type:
File details
Details for the file pytest_mergify-2026.7.6.1-py3-none-any.whl.
File metadata
- Download URL: pytest_mergify-2026.7.6.1-py3-none-any.whl
- Upload date:
- Size: 36.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e99a6260cc0ad7131b426e3ea6f043567cb963ace867e9d48f2cbb51a5b1061
|
|
| MD5 |
0a23566e99bdc5a1ad9ecb1083a0349b
|
|
| BLAKE2b-256 |
484da50b5e1830e554bf81a3bd346a3b799f79c20390eae2e74886f04b2d764e
|
Provenance
The following attestation bundles were made for pytest_mergify-2026.7.6.1-py3-none-any.whl:
Publisher:
release.yml on Mergifyio/pytest-mergify
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pytest_mergify-2026.7.6.1-py3-none-any.whl -
Subject digest:
0e99a6260cc0ad7131b426e3ea6f043567cb963ace867e9d48f2cbb51a5b1061 - Sigstore transparency entry: 2085045982
- Sigstore integration time:
-
Permalink:
Mergifyio/pytest-mergify@7c81bfc7ab6f7bdec06d4b50ae04710315535aea -
Branch / Tag:
refs/tags/2026.7.6.1 - Owner: https://github.com/Mergifyio
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@7c81bfc7ab6f7bdec06d4b50ae04710315535aea -
Trigger Event:
release
-
Statement type:
