---
id: allure-pytest
version: "2.16.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# allure-pytest — Allure pytest integration

License: permissive · Maintenance: active · Downloads: 8.1M/mo

## What it is and what it does

allure-pytest is a pytest plugin that captures test execution data and writes it in Allure Report format, enabling rich interactive dashboards of test results. It hooks into pytest's execution lifecycle to record test outcomes, durations, attachments, and custom metadata, then outputs structured result files that the Allure command-line tool can render into an HTML report.

The plugin is designed for teams that want detailed test visibility beyond pytest's native output—showing test history trends, failure categorization, and the ability to attach screenshots or logs to specific test cases. It requires pytest as a runtime dependency and integrates seamlessly into existing pytest workflows with minimal configuration.

Use it for:

- Generate interactive dashboards of test results with pass/fail trends and execution history for CI/CD pipelines.
- Attach screenshots, logs, or other artifacts to individual test cases for post-mortem analysis of failures.
- Organize test results by severity, feature, or custom categories to help teams prioritize debugging.
- Share formatted test reports with non-technical stakeholders via the Allure web interface.
- Track test execution performance and flakiness over time across multiple test runs.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates pytest with Allure Report to generate rich, interactive test reports with detailed execution history, attachments, and test categorization.

Yes. Active maintenance, permissive license, low install friction, and no known vulnerabilities. Recommended for teams already using pytest who want structured, shareable test reporting beyond console output. The plugin integrates cleanly and adds value for CI/CD visibility and post-run analysis.

## Install

pip install allure-pytest
uv add allure-pytest
poetry add allure-pytest

## Installing allure-pytest

Before you install: Low friction installation with a pure-Python wheel. Active maintenance—last commit 2026-07-10, production-stable status. Depends only on pytest and allure-python-commons, both widely available.

License in practice: Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions; attribution required.

Quickstart:

pip install allure-pytest
pytest --alluredir=./allure-results ./tests
allure serve ./allure-results

Verify before relying:

- Whether allure-python-commons is automatically installed as a transitive dependency or must be installed separately.
- Whether the generated Allure report output requires Java or other runtime dependencies to view.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 8.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest test reporting, allure report integration, test execution visualization, pytest html reports, test result documentation, test-reporting, pytest-plugin, ci-cd

[View on SkillFed](https://skillfed.io/packages/allure-pytest) · [View on PyPI](https://pypi.org/project/allure-pytest/)