pytest-mergify
Pytest plugin for Mergify
Decision gist · record as of 2026-08-14
Yes, if you use Mergify and want to reduce CI time and improve test reliability. The plugin is actively maintained, has no known vulnerabilities, uses a permissive license, and requires only pytest and pytest-timeout. Install friction is medium due to compiled wheels, but the stable ABI (cp38-abi3) covers modern Python versions. The main gotcha is that MERGIFY_TOKEN must be set and test selection requires organization opt-in on Mergify's side, but these are configuration rather than blocker issues.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires MERGIFY_TOKEN environment variable to be set; plugin activates automatically in CI or when PYTEST_MERGIFY_ENABLE=true is set.
- Medium install friction due to compiled wheels across multiple platforms (cp38-abi3 stable ABI).
- Active maintenance with a release 9 days old.
License · maintenance · safety
Apache-2.0 (permissive) — Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
last release 2026-08-05 (9 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 76,654 downloads/mo, #14,603 on PyPI
Alternatives
Verify before relying
pip install pytest-mergify
# Set required environment variable
export MERGIFY_TOKEN=your_token
# Run pytest normally; plugin auto-discovers
pytest- Whether test selection feature requires explicit organization opt-in on Mergify's side beyond environment setup.
- Performance impact of OpenTelemetry tracing on large test suites.
- Compatibility with pytest fixtures and parametrization in flaky detection reruns.
What it is and what it does
pytest-mergify is a pytest plugin that connects your test runs to Mergify's Test Insights platform via OpenTelemetry tracing. It automatically detects flaky tests by intelligently rerunning them within budget constraints, quarantines failing tests to prevent CI blockage, and can selectively run only previously-failing tests when Mergify's merge queue reruns a job—reducing redundant test execution. The plugin requires pytest >= 6.0.0 and pytest-timeout, auto-discovers without manual registration, and activates when running in CI (detected via the CI environment variable) or when explicitly enabled via PYTEST_MERGIFY_ENABLE=true. Configuration is minimal: set the MERGIFY_TOKEN environment variable with your API token, and optionally customize the API endpoint or debug output.
Use it for
- Detect flaky tests in CI pipelines by automatically rerunning tests with budget constraints to identify intermittent failures.
- Reduce merge queue wait time by running only tests that failed in the previous attempt when Mergify reruns a job.
- Quarantine failing tests to prevent them from blocking CI while still capturing failure data for later analysis.
- Trace test execution with OpenTelemetry spans sent to Mergify for centralized test insights and performance monitoring.
- Opt out of test selection per-run by setting MERGIFY_TEST_SELECTION_DISABLE=true while keeping tracing and flaky detection active.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Mergify and want to reduce CI time and improve test reliability.
The plugin is actively maintained, has no known vulnerabilities, uses a permissive license, and requires only pytest and pytest-timeout. Install friction is medium due to compiled wheels, but the stable ABI (cp38-abi3) covers modern Python versions. The main gotcha is that MERGIFY_TOKEN must be set and test selection requires organization opt-in on Mergify's side, but these are configuration rather than blocker issues.
Install
pytest-mergify on PyPI
Before you install
Medium install friction due to compiled wheels across multiple platforms (cp38-abi3 stable ABI). Active maintenance with a release 9 days old. Requires pytest and pytest-timeout as runtime dependencies.
Requires MERGIFY_TOKEN environment variable to be set; plugin activates automatically in CI or when PYTEST_MERGIFY_ENABLE=true is set.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.
Quickstart
pip install pytest-mergify
# Set required environment variable
export MERGIFY_TOKEN=your_token
# Run pytest normally; plugin auto-discovers
pytestVerify before relying
- Whether test selection feature requires explicit organization opt-in on Mergify's side beyond environment setup.
- Performance impact of OpenTelemetry tracing on large test suites.
- Compatibility with pytest fixtures and parametrization in flaky detection reruns.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 2 packagespytestpytest-timeout |
| Maintenance | Actively maintained 9 days since the last release |
| First released | |
| Downloads | 76,654 / month, #14,603 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: pytest_mergify-2026.8.5.3-cp38-abi3-macosx_10_12_x86_64.whl; pytest_mergify-2026.8.5.3-cp38-abi3-macosx_11_0_arm64.whl; pytest_mergify-2026.8.5.3-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl; pytest_mergify-2026.8.5.3-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl; pytest_mergify-2026.8.5.3-cp38-abi3-musllinux_1_2_aarch64.whl; pytest_mergify-2026.8.5.3-cp38-abi3-musllinux_1_2_x86_64.whl; pytest_mergify-2026.8.5.3-cp38-abi3-win_amd64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “pytest mergify integration”
- pytest-mergifyA pytest plugin that integrates with Mergify to trace tests via…
- mergify-cliMergify CLI is a command-line tool for managing stacked pull…
- pytest-integrationA pytest plugin that organizes tests into unit, integration, and slow…
Give your agent the search over MCP, or paste the wish link into any chat.
More Testing packages
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
virtualenv creates isolated Python environments where packages can be installed independently without affecting the system Python or other projects.
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
pytest-asyncio is a pytest plugin that enables writing and running async test functions using the asyncio library, allowing developers to await code directly within test cases.
Install it if you write tests for any asyncio-based code.
A pytest plugin that generates test reports in Common Test Report Format (CTRF) as JSON, compatible with pytest-xdist and pytest-playwright for distributed and browser-based testing.
Install it if you need CTRF-formatted test output for CI/CD integration or cross-tool reporting.
See also mergify-cli · pytest-retry · flaky · pytest-rerunfailures · pytest-sentry · opentelemetry-instrumentation-celery · opentelemetry-instrumentation-remoulade · pytest-opentelemetry · opentelemetry-instrumentation-pika · azure-monitor-opentelemetry-exporter