---
id: pytest-custom-report
version: "1.0.1"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pytest-custom-report — Configure the symbols displayed for test outcomes

License: permissive · Maintenance: abandoned · Downloads: 188.5K/mo

## 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 above — 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

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

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

## Tags

pytest custom test symbols, pytest report formatting, customize pytest output, pytest emoji test results, pytest terminal report customization, pytest-plugin, terminal-output

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