Metadata-Version: 2.4
Name: pgpro-pytest-html-merger
Version: 0.4.0
Summary: A professional tool to merge multiple pytest-html reports into a single one with consistent metadata
Author-email: Postgres Professional <info@postgrespro.ru>
License-Expression: MIT
Project-URL: HomePage, https://github.com/postgrespro/pgpro-pytest-html-merger
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Framework :: Pytest
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: beautifulsoup4>=4.11.1
Requires-Dist: packaging>=21.0
Dynamic: license-file

[![CI Status](https://img.shields.io/github/actions/workflow/status/postgrespro/pgpro-pytest-html-merger/.github/workflows/ci.yml?label=CI)](https://github.com/postgrespro/pgpro-pytest-html-merger/actions/workflows/ci.yml)
[![PyPI package version](https://badge.fury.io/py/pgpro-pytest-html-merger.svg)](https://badge.fury.io/py/pgpro-pytest-html-merger)
[![PyPI python versions](https://img.shields.io/pypi/pyversions/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 |
| :--- | :--- | :--- | :--- |
| `--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 |

## 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
