---
id: pytest-plus
version: "0.8.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# pytest-plus — PyTest Plus Plugin :: extends pytest functionality

License: permissive · Maintenance: aging · Downloads: 77.6K/mo

## What it is and what it does

pytest-plus is a pytest plugin that bundles several optional safety and CI-integration features designed to catch common testing mistakes and improve test reproducibility. It enforces that test function names are unique across a project, validates test IDs to ensure they contain only safe characters and stay within a reasonable length, and allows you to pin the exact number of tests that should pass in CI via the PYTEST_REQPASS environment variable—preventing accidental test skipping. It also collects pytest log files into a project-accessible directory for CI artifact collection.

The plugin is designed to degrade gracefully: if you remove it, your tests continue to run normally. Most of its checks can be disabled via environment variables (PYTEST_CHECK_TEST_DUPLICATE, PYTEST_CHECK_TEST_ID_REGEX, PYTEST_MAX_TEST_ID_LENGTH), making it flexible for different project needs. It targets CI workflows and development practices where catching test-naming collisions and ensuring test counts remain stable are valuable safeguards.

Use it for:

- Enforce exact test counts in CI pipelines to catch accidental test skipping or disabling.
- Prevent duplicate test function names across a project to make failed tests easier to reproduce locally.
- Validate test IDs to ensure they can be safely copy-pasted from CI logs into a terminal.
- Collect pytest logs from temporary directories into a project-accessible location for CI artifact archival.
- Add optional pytest safety checks without breaking existing test infrastructure if the plugin is later removed.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A pytest plugin that adds optional test-count validation, duplicate test-name detection, test-ID safety checks, and CI log collection to help catch common testing issues.

Yes, if you run tests in CI and want to catch test-naming collisions or accidental test skipping. The plugin is low-friction, permissively licensed, and gracefully degrades if removed. However, maintenance is aging (558 days since last release), so evaluate whether the specific checks it offers match your project's needs before adopting it as a critical CI dependency.

## Install

pip install pytest-plus
uv add pytest-plus
poetry add pytest-plus

## Installing pytest-plus

Before you install: Low install friction with a single runtime dependency on pytest. Maintenance status is aging—last release was 558 days ago and the repository shows minimal activity (12 stars), though it remains active and not archived.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install pytest-plus

# In your test environment, set environment variable:
export PYTEST_REQPASS=123

# Then run pytest normally:
pytest

Requires Python 3.10 or later; plugin gracefully downgrades if removed, so no hard runtime dependency beyond pytest itself.

Verify before relying:

- Whether the duplicate test-name check works across all project structures or has known edge cases.
- Performance impact of test-ID regex validation on large test suites.
- Compatibility with pytest plugins that also modify test collection or reporting.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 77.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest plugin extensions, test count validation, duplicate test names, pytest CI helpers, test ID validation, pytest log collection, pytest-plugin, ci-testing, test-validation

[View on SkillFed](https://skillfed.io/packages/pytest-plus) · [View on PyPI](https://pypi.org/project/pytest-plus/)