A professional tool to merge multiple pytest-html reports into a single, consistent HTML report. Developed and maintained by Postgres Professional.
- Smart Merging: Combines test results, logs, and metadata from multiple sources.
- Flexible Input: Supports individual files and entire directories.
- Customizable: Set your own report title and output filename.
- Modern Support: Fully compatible with Python 3.8 through 3.14.
You can install the package directly from the repository (until it's published to PyPI):
pip install pgpro-pytest-html-mergerAfter installation, the tool is available via the pgpro-pytest-html-merger command.
Merge all reports in a directory:
pgpro-pytest-html-merger -i ./reports -o summary.htmlMerge specific files with a custom title:
pgpro-pytest-html-merger report1.html report2.html -o final.html --title "Nightly Build"Combine directories and individual files:
pgpro-pytest-html-merger -i ./unit-tests -i ./e2e-tests extra-report.html -o full-report.html| Argument | Shorthand | Description | Default |
|---|---|---|---|
--version |
Show program's version number and exit | None | |
--input-dir |
-i |
Directory containing HTML reports (can be used multiple times) | None |
--out |
-o |
Name of the output HTML report | merged.html |
--title |
-t |
Title of the output HTML report | None |
--verbose |
-v |
Level of logging verbosity | 3 |
html_files |
Positional arguments for individual HTML files | None |
- Fork the repository.
- Create your feature branch (
git checkout -b feature/amazing-feature). - Commit your changes (
git commit -m 'feat: add some amazing feature'). - Push to the branch (
git push origin feature/amazing-feature). - Open a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
© 2026 Postgres Professional