pytest-custom-report

What it is and what it does

pytest-custom-report is a pytest plugin that replaces the default single-character and verbose outcome symbols with custom text or Unicode glyphs. By default, pytest shows test results as single letters (`.` for passed, `F` for failed, `s` for skipped, etc.); this plugin lets you override those with any character or string—commonly used for emoji like 💩 for failures or ✔ for passes—either via command-line flags or persistent configuration in pytest.ini.

The plugin hooks into pytest's terminal reporting and applies your custom symbols to both compact and verbose output modes. Configuration is straightforward: set options in a pytest config file or pass them as command-line arguments. The plugin is always loaded once installed but remains inert unless you define custom symbols, so it has minimal overhead if you don't use it.

Use it for:

• Replace pytest's default letters with emoji or Unicode symbols to make test output more visually distinctive and easier to scan.
• Customize verbose test output strings (e.g., `FAILED` → `OH CRAP`) for team-specific or humorous reporting.
• Standardize test report appearance across a team by storing symbol choices in a shared pytest.ini.
• Make CI/CD logs more readable by using distinctive glyphs for pass/fail outcomes in terminal output.

Worth the install?

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

A pytest plugin that lets you customize the symbols and strings displayed for test outcomes (passed, failed, skipped, etc.) in terminal reports.

Yes, if you want to customize pytest's terminal symbols and don't mind the lack of active maintenance. The plugin is simple, has no security vulnerabilities, and low install friction. However, be aware it is abandoned—test compatibility with your pytest version before relying on it in production, and do not expect updates if pytest introduces breaking changes.

Install

pytest-custom-report on PyPI

pip install pytest-custom-report

uv add pytest-custom-report

poetry add pytest-custom-report

Installing pytest-custom-report

Before you install

Low install friction with a pure-Python wheel. However, the package is abandoned—last release was 2019-01-30 and last commit 2022-04-07, with no active maintenance. It may work with current pytest versions but will not receive updates for breaking changes.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart

pip install pytest-custom-report

# In pytest.ini:
[pytest]
report_failed = 💩
report_passed = ✔

# Then run:
pytest

Requires pytest to be installed. Terminal must support Unicode if using emoji or special characters.

Verify before relying

• Whether the plugin remains compatible with recent pytest versions (no updates since 2019).
• Whether all Unicode characters render correctly depends on terminal and font support, not the package itself.

Package facts

Evidence: pytest_custom_report-1.0.1-py2.py3-none-any.whl

Tags

More Testing packages