https://github.com/postgrespro/pgpro-pytest-html-merger
pytest-html reports merger
https://github.com/postgrespro/pgpro-pytest-html-merger
Last synced: about 2 months ago
JSON representation
pytest-html reports merger
- Host: GitHub
- URL: https://github.com/postgrespro/pgpro-pytest-html-merger
- Owner: postgrespro
- License: mit
- Created: 2026-03-31T07:36:56.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-03-31T13:50:23.000Z (about 2 months ago)
- Last Synced: 2026-03-31T15:33:27.692Z (about 2 months ago)
- Language: Python
- Size: 37.1 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/postgrespro/pgpro-pytest-html-merger/actions/workflows/ci.yml)
[](https://badge.fury.io/py/pgpro-pytest-html-merger)
[](https://pypi.org/project/pgpro-pytest-html-merger)
# pgpro-pytest-html-merger
A professional tool to merge multiple pytest-html reports into a single, consistent HTML report. Developed and maintained by Postgres Professional.
## Key Features
- 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.
## Installation
You can install the package directly from the repository (until it's published to PyPI):
```bash
pip install pgpro-pytest-html-merger
```
## Usage
After installation, the tool is available via the pgpro-pytest-html-merger command.
### Basic Examples
Merge all reports in a directory:
```bash
pgpro-pytest-html-merger -i ./reports -o summary.html
```
Merge specific files with a custom title:
```bash
pgpro-pytest-html-merger report1.html report2.html -o final.html --title "Nightly Build"
```
Combine directories and individual files:
``` bash
pgpro-pytest-html-merger -i ./unit-tests -i ./e2e-tests extra-report.html -o full-report.html
```
### Command Line Arguments
| Argument | Shorthand | Description | Default |
| :--- | :--- | :--- | :--- |
| `--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 |
## Contributing
1. Fork the repository.
2. Create your feature branch (`git checkout -b feature/amazing-feature`).
3. Commit your changes (`git commit -m 'feat: add some amazing feature'`).
4. Push to the branch (`git push origin feature/amazing-feature`).
5. Open a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
© 2026 Postgres Professional