---
id: pytest-html-merger
version: "0.1.0"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# pytest-html-merger — Pytest HTML reports merging utility

License: unclear · Maintenance: dormant · Downloads: 374.4K/mo

## What it is and what it does

pytest-html-merger is a command-line utility that takes multiple HTML test reports produced by the pytest-html plugin and combines them into a single merged report. It depends on beautifulsoup4 for HTML parsing and packaging for version handling. The tool assumes CSS is embedded in the input reports; if not, it looks for an 'assets' directory in the input folder containing the necessary CSS files.

The package is a narrow, focused tool for test report consolidation. It offers a simple CLI interface with options to specify input and output directories, set a custom report title, and view version information. With only two runtime dependencies and low install friction, it integrates easily into existing test workflows. However, the project is dormant—no commits since 2024-07-12—so it receives no active maintenance and may not work reliably with newer versions of pytest-html or pytest itself.

Use it for:

- Merge test reports from parallel test runs across multiple machines into a single report for CI/CD dashboards.
- Consolidate HTML reports from different test suites or environments into one unified report for stakeholder review.
- Aggregate pytest-html reports from different stages of a pipeline into a final summary report.
- Combine test results from multiple test runs or configurations into a single browsable HTML document.

## Worth the install?

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

Merges multiple pytest HTML reports generated by the pytest-html plugin into a single consolidated HTML report, handling embedded CSS or external asset directories.

Yes, if you have a specific need to merge pytest-html reports and can tolerate dormant maintenance. The low install friction and absence of known vulnerabilities make it safe to try. However, verify license terms first, and test compatibility with your version of pytest-html before relying on it in production. The lack of recent updates means you should not expect bug fixes or support for newer pytest-html output formats.

## Install

pip install pytest-html-merger
uv add pytest-html-merger
poetry add pytest-html-merger

## Installing pytest-html-merger

Before you install: Low install friction with only two runtime dependencies. Maintenance is dormant—last commit was 2024-07-12 with no recent activity—so expect no active bug fixes or feature updates.

License in practice: License status is unclear; no SPDX identifier or raw license text is available. Verify the actual license before use in proprietary or restricted contexts.

Quickstart:

pip install pytest-html-merger

pytest_html_merger -i /path/to/html/reports -o /path/to/merged.html

Requires Python 3.6.0 or later. If CSS is not embedded in input HTML reports, an 'assets' directory containing CSS files must exist in the input directory.

Verify before relying:

- Whether the package handles malformed or incomplete HTML reports gracefully without data loss.
- Performance characteristics when merging a large number of reports or very large individual reports.
- Compatibility with recent versions of pytest-html and whether the tool works with current pytest-html output formats.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 374.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

merge pytest html reports, combine test reports, pytest html consolidation, test report aggregation, pytest-html plugin merger, batch html report combining, consolidate test results, test-reporting, pytest-plugin, report-aggregation

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