pytest-mergify

Pytest plugin for Mergify Test Insights.

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
Test selection — Runs only the previously-failing tests when Mergify's merge queue reruns a job

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	—
`MERGIFY_TEST_SELECTION_DISABLE`	Opt out of test selection (see below)	`false`

For detailed documentation, see the official guide.

Test selection

When Mergify's merge queue reruns a job — a retry, or a step of a batch bisection — only the tests that failed on the previous attempt are informative. The plugin asks Mergify whether the current run is such a rerun and, if so, runs only those tests; the rest are reported as deselected.

Nothing to configure: the plugin uses the token and job identity it already has, and Mergify decides. Any other situation — a normal run, a rerun Mergify has no previous results for, an unreachable API — runs the full suite, so the feature can only remove work, never coverage. The feature is also enabled per organization on Mergify's side, so it stays inactive until your organization is opted in.

Set MERGIFY_TEST_SELECTION_DISABLE=true in your CI to opt out: the plugin then always runs the full suite and never queries the endpoint. It is scoped to this feature only — test tracing, flaky detection and quarantine keep working (unset MERGIFY_TOKEN to turn the plugin off entirely).

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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

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_mergify-2026.8.5.1-cp38-abi3-win_amd64.whl (2.3 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+Windows x86-64

pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_x86_64.whl (2.6 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+musllinux: musl 1.2+ x86-64

pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_aarch64.whl (2.4 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+musllinux: musl 1.2+ ARM64

pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.3 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+manylinux: glibc 2.17+ x86-64

pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.2 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+manylinux: glibc 2.17+ ARM64

pytest_mergify-2026.8.5.1-cp38-abi3-macosx_11_0_arm64.whl (2.1 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+macOS 11.0+ ARM64

pytest_mergify-2026.8.5.1-cp38-abi3-macosx_10_12_x86_64.whl (2.2 MB view details)

Uploaded Aug 5, 2026 CPython 3.8+macOS 10.12+ x86-64

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-win_amd64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-win_amd64.whl
Upload date: Aug 5, 2026
Size: 2.3 MB
Tags: CPython 3.8+, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-win_amd64.whl
Algorithm	Hash digest
SHA256	`d3aa2d7deece9427d15e28f830414a33e63059b4a164dce38f05ca88bcfe16db`
MD5	`a52283c5e51723c6ff6e174fb8531530`
BLAKE2b-256	`949605086426d15cd3621ac497f425af0defe61f8a4c71431faafb6554b5a946`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-win_amd64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-win_amd64.whl
- Subject digest: d3aa2d7deece9427d15e28f830414a33e63059b4a164dce38f05ca88bcfe16db
- Sigstore transparency entry: 2344855134
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_x86_64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_x86_64.whl
Upload date: Aug 5, 2026
Size: 2.6 MB
Tags: CPython 3.8+, musllinux: musl 1.2+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_x86_64.whl
Algorithm	Hash digest
SHA256	`7e552c6efc388d78aac30dec8a68a05353a111762ba88a431c12bf7114d68232`
MD5	`68a15bd5651318325a2c69a8bd05fefb`
BLAKE2b-256	`025b4b55e777582586d898291aea787c45553ffb8b39900dad37fd26fa539c90`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_x86_64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_x86_64.whl
- Subject digest: 7e552c6efc388d78aac30dec8a68a05353a111762ba88a431c12bf7114d68232
- Sigstore transparency entry: 2344854911
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_aarch64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_aarch64.whl
Upload date: Aug 5, 2026
Size: 2.4 MB
Tags: CPython 3.8+, musllinux: musl 1.2+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_aarch64.whl
Algorithm	Hash digest
SHA256	`7122a7af3ca7c7539329aceb46287eced32cf1be32f0ea7ba287bd5ef1271433`
MD5	`a8af0adedd5b3b0c9a65fc2fc879abec`
BLAKE2b-256	`fa78cb473a8b84544d10cc01cb5864ac290663d85212171fe5f705585b628051`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_aarch64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-musllinux_1_2_aarch64.whl
- Subject digest: 7122a7af3ca7c7539329aceb46287eced32cf1be32f0ea7ba287bd5ef1271433
- Sigstore transparency entry: 2344855388
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Upload date: Aug 5, 2026
Size: 2.3 MB
Tags: CPython 3.8+, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`0a5e1da2a1d7dc28c77bc566fc5279f2d3b41887aa0c55aafa463895b1627d1e`
MD5	`143820b4aea433434ae1ee8bacdee63d`
BLAKE2b-256	`d43bf1b8bd6f68ff51fa8cdd93a6a6bcdd321385a009ba09f80ce602134ef987`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Subject digest: 0a5e1da2a1d7dc28c77bc566fc5279f2d3b41887aa0c55aafa463895b1627d1e
- Sigstore transparency entry: 2344855275
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Upload date: Aug 5, 2026
Size: 2.2 MB
Tags: CPython 3.8+, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm	Hash digest
SHA256	`6bf410a0fd5c652a8c8da0f6d862900b7779b410ddbb35ae2abee4e45852f26c`
MD5	`62a236ee049b4f3ffe7d10a6e7e04172`
BLAKE2b-256	`8f48f7811fc3b51f1c525b5a0831bee322c77ac0b53092e27f01ca15a1b957da`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Subject digest: 6bf410a0fd5c652a8c8da0f6d862900b7779b410ddbb35ae2abee4e45852f26c
- Sigstore transparency entry: 2344854817
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-macosx_11_0_arm64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-macosx_11_0_arm64.whl
Upload date: Aug 5, 2026
Size: 2.1 MB
Tags: CPython 3.8+, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`ebf2f5b64631ebf47e062cc7318be408a2e453c38c27d837cca5f168a040bf1b`
MD5	`c8fe5c7a18e9fe9806ac8b0626aac4e4`
BLAKE2b-256	`8997c24f4207270f5ec63cdafb5fb9ccfcf86a36adc3d684178e7afc4cd4278a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-macosx_11_0_arm64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-macosx_11_0_arm64.whl
- Subject digest: ebf2f5b64631ebf47e062cc7318be408a2e453c38c27d837cca5f168a040bf1b
- Sigstore transparency entry: 2344855046
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

File details

Details for the file pytest_mergify-2026.8.5.1-cp38-abi3-macosx_10_12_x86_64.whl.

File metadata

Download URL: pytest_mergify-2026.8.5.1-cp38-abi3-macosx_10_12_x86_64.whl
Upload date: Aug 5, 2026
Size: 2.2 MB
Tags: CPython 3.8+, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for pytest_mergify-2026.8.5.1-cp38-abi3-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`d683dcd335ec70b854367cd8f419309f99a5bcbe5a86ba705fa5f3c614c1e7d9`
MD5	`89021f5cdc79e3017d76dee87e1159f0`
BLAKE2b-256	`c47bc699fe5438b278a4b841c8be4f4f528e227531ef9339d543040d4ecceb90`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytest_mergify-2026.8.5.1-cp38-abi3-macosx_10_12_x86_64.whl:

Publisher: release-pytest-mergify.yml on Mergifyio/mergify-ci-integrations

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_mergify-2026.8.5.1-cp38-abi3-macosx_10_12_x86_64.whl
- Subject digest: d683dcd335ec70b854367cd8f419309f99a5bcbe5a86ba705fa5f3c614c1e7d9
- Sigstore transparency entry: 2344854684
- Sigstore integration time: Aug 5, 2026
Source repository:
- Permalink: Mergifyio/mergify-ci-integrations@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Branch / Tag: refs/tags/pytest-mergify-v2026.8.5.1
- Owner: https://github.com/Mergifyio
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-pytest-mergify.yml@bb27f6648127ec5b1d6df2feebb549f27a3971b5
- Trigger Event: release

Release history Release notifications | RSS feed

2026.8.5.3

Aug 5, 2026

2026.8.5.2

Aug 5, 2026

This release

2026.8.5.1

Aug 5, 2026

2026.8.4.1

Aug 4, 2026

2026.8.3.1

Aug 3, 2026

2026.7.29.1

Jul 29, 2026

2026.7.7.1

Jul 7, 2026

2026.7.6.1

Jul 6, 2026

2026.5.27.1

May 27, 2026

2026.4.7.1

Apr 7, 2026

2026.1.26.1

Jan 26, 2026

2026.1.20.1

Jan 20, 2026

2026.1.12.1

Jan 12, 2026

2026.1.9.1

Jan 9, 2026

2025.12.29.1

Dec 29, 2025

2025.12.1.1

Dec 1, 2025

2025.11.28.1

Nov 28, 2025

2025.11.25.1

Nov 25, 2025

2025.11.19.1

Nov 19, 2025

2025.11.14.2

Nov 14, 2025

2025.11.14.1

Nov 14, 2025

2025.11.6.1

Nov 6, 2025

2025.10.23.1

Oct 23, 2025

2025.10.16.2

Oct 16, 2025

2025.10.16.1

Oct 16, 2025

2025.10.14.1

Oct 14, 2025

2025.10.13.1

Oct 13, 2025

2025.10.7.1

Oct 7, 2025

2025.10.3.1

Oct 3, 2025

2025.9.24.2

Sep 24, 2025

2025.9.24.1

Sep 24, 2025

2025.9.23.1

Sep 23, 2025

2025.9.10.1

Sep 10, 2025

2025.9.4.1

Sep 4, 2025

2025.8.20.1

Aug 20, 2025

2025.8.5.1

Aug 5, 2025

2025.8.1.1

Aug 1, 2025

2025.7.31.2

Jul 31, 2025

2025.7.31.1

Jul 31, 2025

2025.7.21.1

Jul 21, 2025

2025.7.18.1

Jul 18, 2025

2025.7.17.1

Jul 17, 2025

2025.7.8.1

Jul 8, 2025

2025.7.7

Jul 7, 2025

2025.6.12.1

Jun 12, 2025

2025.5.13.1

May 13, 2025

2025.4.10.1

Apr 10, 2025

2025.3.31.1

Mar 31, 2025

2025.3.27.1

Mar 27, 2025

2025.3.25.1

Mar 25, 2025

2025.3.14.2

Mar 14, 2025

2025.3.14.1

Mar 14, 2025

2025.2.19.2

Feb 19, 2025

2025.2.19.1

Feb 19, 2025

2025.2.14.1

Feb 14, 2025

2025.2.13.1

Feb 13, 2025

2025.2.10.1

Feb 10, 2025

2025.2.6.1

Feb 6, 2025

2025.1.23.1

Jan 23, 2025

2024.12.27.2

Dec 27, 2024

2024.12.27.1

Dec 27, 2024

2024.12.20.1

Dec 20, 2024

2024.12.19.1

Dec 19, 2024

2024.12.17.2

Dec 17, 2024

2024.12.17.1

Dec 17, 2024

2024.12.11.1

Dec 11, 2024

pytest-mergify 2026.8.5.1

pytest-mergify

Features

Installation

Configuration

Environment Variables

Test selection

Development

Prerequisites

Setup

Running Tests

Linting

License

Key dates

Owner

Credits

License expression

Requires

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed