pytest-spec

library6.0.0pypypiunverified

pytest-spec is a pytest plugin that transforms the standard test execution output into a clear, human-readable specification format, similar to RSpec or Mocha. It uses test names and docstrings to generate descriptive sentences about test behavior. The current version is 6.0.0, and it follows a release cadence tied to pytest and Python major version updates.

testing

pip install pytest-spec

github ↗package ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · PYTEST-SPEC

pytest-spec

testingpythonv6.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Create a test file (e.g., `test_example.py`) and simply run `pytest` from your terminal after installation. pytest-spec automatically modifies the output.

# test_example.py import pytest def test_feature_login_successful(): """When valid credentials are provided, it should allow a user to log in successfully.""" assert True def test_feature_login_failed(): """When invalid credentials are provided, it should deny access and show an error.""" assert False @pytest.mark.parametrize("input, expected", [("hello", "HELLO"), ("world", "WORLD")]) def test_string_uppercase_conversion(input, expected): """It should correctly convert a given string to uppercase.""" assert input.upper() == expected # To run these tests with pytest-spec, simply navigate to the directory # containing `test_example.py` in your terminal and run: # pytest

Debug

Known issues

breakingVersion 6.0.0 of pytest-spec drops support for Python 3.9. Users on Python 3.9 or older will experience compatibility issues.

fix

Upgrade your Python environment to 3.10 or newer. For example: `pyenv install 3.10.12 && pyenv local 3.10.12`.

affects: 6.0.0

breakingVersion 6.0.0 of pytest-spec drops support for pytest 4.x.x and 5.x.x. Running with these older pytest versions will lead to errors or incorrect behavior.

fix

Upgrade pytest to version 6.0.0 or newer. For example: `pip install 'pytest>=6.0.0,<10.0.0'`.

affects: 6.0.0

gotchaFor the most descriptive output, leverage docstrings in your test functions and methods. pytest-spec uses these to generate more readable specification descriptions.

fix

Add a clear, concise docstring to each test function or method explaining its purpose. Example: `def test_something(): """It should do X when Y."""`.

affects: all

gotchaIf you need to temporarily disable pytest-spec or are experiencing conflicts with other plugins, you can disable it directly from the command line.

fix

Run pytest with `pytest -p no:spec` to disable the plugin for that specific run. You can also add `addopts = -p no:spec` to your `pytest.ini` to disable it project-wide.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'pytest_spec'

The `pytest-spec` package has not been installed in your current Python environment.

fix

Run `pip install pytest-spec` to install the plugin.

No 'spec' output, just standard pytest dots or progress.

The `pytest-spec` plugin is either not active, has been explicitly disabled, or is being overridden by another pytest plugin.

fix

Ensure `pytest-spec` is installed. Check your `pytest.ini` for `addopts = -p no:spec`. You can run `pytest --trace-config` to see which plugins are loaded. If conflicts exist, try disabling other plugins, e.g., `pytest -p no:another_plugin`.

You need to install pytest>=6.0.0 to use this plugin with current Python version.

You are using an older version of pytest (pre-6.0.0) which is no longer supported by pytest-spec 6.0.0.

fix

Upgrade your pytest installation: `pip install 'pytest>=6.0.0,<10.0.0'`.

Upgrade

Version history

6.0.0latest on PyPI · released Feb 22, 2026

Audit

Dependencies

pytestrequiredRequired as it is a pytest plugin. Version 6.0.0+ is needed.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/pchomik/pytest-spec ↗

packagehttps://pypi.org/project/pytest-spec/ ↗

docshttps://pchomik.ovh/docs/pytest-spec/about ↗

changeloghttps://github.com/pchomik/pytest-spec/CHANGES.txt ↗