---
id: pytest-emoji
version: "0.2.0"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# pytest-emoji — A pytest plugin that adds emojis to your test result report

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

## What it is and what it does

pytest-emoji is a pytest plugin that replaces the standard test result symbols (PASSED, FAILED, SKIPPED, etc.) with emoji in your test output. It adds a `--emoji` CLI flag to pytest that works in both normal and verbose modes, displaying emoji like 😃 for passed tests, 😰 for failures, 🙄 for skipped tests, and others for different outcomes.

The plugin allows customization through pytest hooks in a conftest.py file, letting you replace the default emoji with your own choices. It has a single runtime dependency on pytest and installs with low friction. However, the package has not been actively maintained since February 2019, with the last commit in September 2021, which means it may have compatibility issues with pytest versions released in recent years.

Use it for:

- Make test output more visually scannable and engaging during local development and CI/CD runs.
- Customize emoji per project to match team preferences or add thematic flair to test reports.
- Reduce cognitive load when scanning large test suites by using visual emoji indicators instead of text.
- Add a light-hearted element to test reporting in team environments to encourage testing culture.

## Worth the install?

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

Adds emoji indicators to pytest test result reports, replacing standard pass/fail/skip/error symbols with customizable emoji in both normal and verbose output modes.

No—not without verification. While the plugin is simple and has no security vulnerabilities, it has been abandoned for over four years with no updates to address pytest compatibility. Install only if you can verify it works with your specific pytest version and are willing to maintain a fork if needed. For active projects, consider whether the cosmetic benefit justifies the maintenance risk.

## Install

pip install pytest-emoji
uv add pytest-emoji
poetry add pytest-emoji

## Installing pytest-emoji

Before you install: Installs cleanly with a single runtime dependency on pytest 4.2.1 or higher. However, the package has been abandoned since 2019 with no updates for over four years, raising questions about compatibility with modern pytest versions.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart:

pip install pytest-emoji

# In your test run:
pytest --emoji

# Or with verbose output:
pytest --verbose --emoji

Requires pytest 4.2.1 or higher; package has not been maintained since 2019 and may have compatibility issues with recent pytest releases.

Verify before relying:

- Whether the plugin remains compatible with pytest versions released after 2019.
- Whether customization hooks via conftest.py still function as documented.
- Current test coverage and whether the plugin handles all modern pytest result types.

## Package facts

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

## Tags

pytest emoji test results, colorful test output, pytest plugin decorative, test report emojis, pytest cli formatting, fun test reporting, pytest-plugin, cosmetic-output

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