pytest-reporter

What it is and what it does

pytest-reporter is a pytest plugin that acts as a bridge between test execution and custom report generation. Instead of producing fixed output formats, it collects test data and passes it to template implementations you provide or inherit. You specify a template directory and template name at runtime, and the plugin renders the report to your chosen output file.

The plugin exposes a rich context to templates—including test results, phases (setup, call, teardown), logs, warnings, and timing information—and delegates rendering logic to template implementations via a pytest hook. This design lets you generate any text-based format (HTML, LaTeX, CSV, plain text) by writing or reusing a template, without modifying the plugin itself. It's most useful when you need report formats beyond pytest's built-in options or want to standardize reporting across projects.

Use it for:

• Generate branded HTML reports for CI/CD pipelines using a custom or inherited template.
• Create LaTeX or PDF reports for formal test documentation and compliance artifacts.
• Export test results as CSV for further analysis or integration with external tools.
• Standardize test report format across multiple projects by sharing a template package.
• Extend existing templates (like pytest-reporter-html1) to add project-specific sections or styling.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A pytest plugin that generates customizable test reports from templates, supporting any text-based output format like HTML, LaTeX, or CSV.

Yes, if you need templated test reports and are comfortable maintaining a template implementation yourself or using a third-party template package. The plugin is stable and has no known vulnerabilities, but dormant maintenance means it will not track pytest API changes proactively. Best suited for teams with established test reporting workflows that won't require frequent updates.

Install

pytest-reporter on PyPI

pip install pytest-reporter

uv add pytest-reporter

poetry add pytest-reporter

Installing pytest-reporter

Before you install

Low install friction with a single runtime dependency on pytest. Maintenance is dormant—no releases in 898 days, though the repository remains active with a last commit in September 2024. Suitable for stable use cases but do not expect rapid bug fixes or feature updates.

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-reporter

pytest --template-dir=templates --template=report.html --report=report.html

Requires Python 3.8 or later. Template rendering is delegated to template implementations (e.g., Jinja2); the plugin itself provides only the hook interface.

Verify before relying

• Whether dormant status (no releases since February 2024) affects compatibility with recent pytest versions.
• Availability and maturity of template packages like pytest-reporter-html1 referenced in the documentation.

Package facts

Evidence: pytest_reporter-0.5.3-py3-none-any.whl

Tags

More Testing packages