pytest-html

pytest plugin for generating HTML reports

pytest-html Copyleft license MPL-2.0 Active ★ 775 v4.2.0 released 2026-01-19

Install

pytest-html on PyPI

pip

pip install pytest-html

uv

uv add pytest-html

poetry

poetry add pytest-html

Package facts

License	MPL-2.0 (copyleft)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	3 — jinja2, pytest-metadata, pytest
Maintenance	actively maintained — 206 days since the last release
Last repo commit	2026-08-10
First released	2015-04-20
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: pytest_html-4.2.0-py3-none-any.whl

Keywords: html, pytest, report

Development Status :: 5 - Production/StableFramework :: PytestIntended Audience :: DevelopersLicense :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)Natural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Software Development :: Quality AssuranceTopic :: Software Development :: TestingTopic :: Utilities

About pytest-html

from the package's own PyPI description — quoted content, verbatim

pytest-html

pytest-html is a plugin for pytest <http://pytest.org>_ that generates a HTML report for test results.

.. image:: https://img.shields.io/badge/license-MPL%202.0-blue.svg :target: https://github.com/pytest-dev/pytest-html/blob/master/LICENSE :alt: License .. image:: https://img.shields.io/pypi/v/pytest-html.svg :target: https://pypi.python.org/pypi/pytest-html/ :alt: PyPI .. image:: https://img.shields.io/conda/vn/conda-forge/pytest-html.svg :target: https://anaconda.org/conda-forge/pytest-html :alt: Conda Forge .. image:: https://github.com/pytest-dev/pytest-html/workflows/gh/badge.svg :target: https://github.com/pytest-dev/pytest-html/actions :alt: CI .. image:: https://img.shields.io/requires/github/pytest-dev/pytest-html.svg :target: https://requires.io/github/pytest-dev/pytest-html/requirements/?branch=master :alt: Requirements .. image:: https://codecov.io/gh/pytest-dev/pytest-html/branch/master/graph/badge.svg?token=Y0myNKkdbi :target: https://codecov.io/gh/pytest-dev/pytest-html :alt: Codecov

Resources

Documentation <https://pytest-html.readthedocs.io/en/latest/>_
`Release Notes...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

pytest-html is a pytest plugin that generates HTML reports summarizing test results, including pass/fail status, timing, and metadata for each test execution.

Low friction install with three stable runtime dependencies (pytest, jinja2, pytest-metadata). Actively maintained with recent commits and production-stable status; supports Python 3.9–3.14 and both CPython and PyPy.

Licensed under MPL-2.0 (copyleft), which requires derivative works to disclose source and license under the same terms; acceptable for internal testing but review required if bundling or modifying for distribution.

Usage

pip install pytest-html
pytest --html=report.html --self-contained-html

Requires pytest to be installed; pytest-html acts as a plugin and cannot run standalone.

Verdict: pytest-html is a mature, well-maintained testing utility in the top 1000 PyPI packages with no known vulnerabilities. Its copyleft license is standard for testing tools and poses no barrier to typical development use. Recommended for teams needing shareable HTML test reports.

Needs verification

Whether the HTML report supports interactive features (filtering, sorting) beyond static display.
Performance characteristics with very large test suites (thousands of tests).
Customization options for report styling and layout beyond what jinja2 templating provides.

pytest html report generatortest report html outputpytest test results visualizationhtml test reporting pluginpytest report generationtest summary htmlpytest testing dashboard