---
id: pytest-pspec
version: "0.0.4"
license: unclear
license_treatment: permissive
maintenance: aging
---

# pytest-pspec — A rspec format reporter for Python ptest

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

## What it is and what it does

pytest-pspec is a pytest plugin that changes how test results are displayed in the terminal. Instead of the default pytest output, it renders tests in RSpec-style format—a BDD-oriented report that reads like plain English specifications. Each test appears as a bullet point with a checkmark or cross, and the description comes from your test method's docstring, making the output more narrative and business-friendly.

The plugin is lightweight, requiring only pytest and six as dependencies. You enable it by passing the `--pspec` flag to pytest or adding it to your pytest configuration file. It supports both plaintext and UTF-8 output formats, and works with unittest-style test classes. The aging maintenance status means it has not been actively developed since 2020, so compatibility with very recent pytest releases may be uncertain.

Use it for:

- Generate human-readable test reports for stakeholders or documentation that read like specifications rather than technical output.
- Write BDD-style tests in Python where test names and docstrings describe behavior in plain language, then display them in that same readable format.
- Replace pytest's default output format in CI/CD pipelines to produce cleaner, more narrative test summaries.
- Document test coverage and behavior through the test output itself, using docstrings as living specification.

## Worth the install?

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

Formats pytest test output in RSpec-style (pspec) format, showing test descriptions and results in a human-readable BDD-like report.

Yes, if you want readable BDD-style test output and are working with pytest versions compatible with the 2020-06-02 release. The low install friction and permissive license make it a low-risk addition. However, be cautious if you rely on very recent pytest features or versions—the aging maintenance status means you may need to maintain a fork or switch reporters if incompatibilities arise.

## Install

pip install pytest-pspec
uv add pytest-pspec
poetry add pytest-pspec

## Installing pytest-pspec

Before you install: Low install friction; depends only on pytest and six. Maintenance is aging—last release was 2020-06-02 and no commits since 2026-01-29, so expect limited active support for newer pytest versions.

License in practice: MIT license (permissive); you can use, modify, and distribute freely with minimal restrictions.

Quickstart:

pip install pytest-pspec

# In your test file:
class TestExample(unittest.TestCase):
    "My test suite"
    def test_should_work(self):
        "it does something"
        assert True

# Run with:
pytest --pspec your-tests/

Requires pytest to be installed; docstrings on test classes and methods are used to generate the pspec output, so tests without docstrings will show generic names.

Verify before relying:

- Compatibility with pytest versions released after 2020-06-02 is unclear given the aging maintenance status.
- Whether the package works correctly with modern Python versions beyond those listed in classifiers (3.5 and earlier).

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 81.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest output formatting, rspec style test reporter, bdd test reporting, pytest pspec plugin, readable test output, test report formatting, bdd-reporting, test-output-formatting

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