allure-combine

What it is and what it does

allure-combine takes a folder generated by Allure's test reporting tool and bundles it into a single complete.html file. The tool reads the Allure report contents, embeds all data files and JavaScript (including a fake XHR server and sinon-9.2.4.js), and patches the index.html so the report can be opened directly in any browser without needing special Chrome flags or a local web server.

You can use it as a command-line tool or import it into Python code. It supports options to specify output folders, auto-create destination directories, clean up temporary files, and handle UTF-8 encoding issues. The result is a portable, shareable HTML file suitable for archiving or distributing test results.

Use it for:

• Archive test reports as standalone files without needing to maintain a report server or folder structure.
• Share Allure test results with stakeholders via email or file transfer without requiring them to set up infrastructure.
• Generate offline-readable test reports for CI/CD pipelines that need to produce deliverable artifacts.
• Bundle test results into a single file for version control or long-term storage alongside code.
• Distribute test reports to teams or clients who need to review results in a browser without command-line tools.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Converts an Allure test report folder into a single self-contained HTML file that can be opened in any browser without special flags or a local server.

Yes, if you use Allure for test reporting and need portable, single-file HTML reports. The package is straightforward, has low install friction, carries a permissive license, and has no known vulnerabilities. However, be aware the project is aging (last release June 2023) and some features like image/video viewing are not yet implemented—verify compatibility with your Allure version and browser environment before relying on it in production workflows.

Install

allure-combine on PyPI

pip install allure-combine

uv add allure-combine

poetry add allure-combine

Installing allure-combine

Before you install

Low friction install with a single runtime dependency (bs4). Package is aging—last release was over a year ago and the repository shows no recent commits, though it remains unarchived and has modest GitHub activity (97 stars).

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart

pip install allure-combine

from allure_combine import combine_allure
combine_allure("./allure-report-folder")

Requires an existing Allure report folder generated by the Allure command-line tool (allure generate).

Verify before relying

• Whether image and video functionality in the generated HTML works as expected (documentation notes this is not yet implemented).
• Current status of the package's compatibility with recent Allure versions and modern browser security policies.

Package facts

Evidence: allure_combine-1.0.11-py3-none-any.whl

Tags

More Testing packages