---
id: pytest-rich
version: "0.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# pytest-rich — Leverage rich for richer test session output

License: permissive · Maintenance: active · Downloads: 143.6K/mo

## What it is and what it does

pytest-rich is a pytest plugin that integrates rich to enhance how test results are displayed in the terminal. It wraps pytest's output with rich's formatting capabilities to provide colored and structured test session reports. The plugin depends on pytest, rich, and attrs, and runs on Python 3.9 and later across CPython and PyPy implementations.

The maintainer explicitly describes this as a proof-of-concept seeking a new maintainer, indicating the plugin works but is not feature-complete and welcomes community contributions. It is actively maintained with recent activity. Installation is straightforward with no compiled dependencies or complex setup requirements.

Use it for:

- Improve readability of test output in local development by adding color and structure to pytest results.
- Make CI/CD test logs more scannable and visually distinct between passing, failing, and skipped tests.
- Enhance terminal-based test reporting for projects that run pytest in interactive shells.
- Experiment with pytest output customization as a foundation for building more advanced test reporting plugins.

## Worth the install?

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

A pytest plugin that uses rich to format and colorize test session output with enhanced terminal presentation.

Yes, if you want richer pytest output and are comfortable with a proof-of-concept plugin. The low install friction, active maintenance, MIT license, and lack of known vulnerabilities make it safe to try. However, be aware that the maintainer is seeking adoption and the feature set may evolve; it is not a mature, feature-locked tool.

## Install

pip install pytest-rich
uv add pytest-rich
poetry add pytest-rich

## Installing pytest-rich

Before you install: Low friction install with three straightforward runtime dependencies (attrs, pytest, rich). Actively maintained with recent commits as of August 2026.

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

Then run pytest normally:

pytest

Verify before relying:

- What specific output enhancements or formatting changes does the plugin apply to pytest results beyond basic colorization.
- Whether the plugin is compatible with pytest plugins that also modify output formatting or terminal behavior.
- Performance impact of rich formatting on large test suites or CI/CD environments.
- Current feature completeness and roadmap given the maintainer's stated search for adoption.

## Package facts

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

## Tags

pytest output formatting, rich test output, colored pytest results, pytest terminal display, pytest plugin rich, enhanced test reporting, pytest pretty output, pytest-plugin, terminal-ui, test-reporting

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