skillfed

pytest-html-merger

Pytest HTML reports merging utility

pytest-html-merger v0.1.0 374.4K downloads/30d#7,146 on PyPI26
License unclear DORMANT released

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 on this page — 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

pytest-html-merger on PyPI

pip

pip install pytest-html-merger

uv

uv add pytest-html-merger

poetry

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 the current Python release (>=3.6.0)
Install friction low — pure-Python wheel
Runtime dependencies 2 — beautifulsoup4, packaging
Maintenance dormant — 763 days since the last release
Last repo commit
First released
Downloads 374,401/month — #7,146 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pytest_html_merger-0.1.0-py3-none-any.whl

Tags

merge pytest html reportscombine test reportspytest html consolidationtest report aggregationpytest-html plugin mergerbatch html report combiningconsolidate test results
test-reportingpytest-pluginreport-aggregation

More Testing packages