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

# allure-pytest-bdd — Allure pytest-bdd integration

License: permissive · Maintenance: active · Downloads: 217.6K/mo

## What it is and what it does

Allure-pytest-bdd is an adapter that connects Pytest-BDD test execution to Allure Report, a framework for generating detailed, interactive test reports. When you run Pytest-BDD tests with the --alluredir flag, this package captures test metadata, steps, and outcomes and writes them in Allure's format. You then use the Allure command-line tool to convert those results into a rich HTML report showing test execution history, step-by-step breakdowns, and pass/fail trends.

The package sits between your BDD test framework and Allure's reporting engine, requiring pytest, pytest-bdd, and allure-python-commons as runtime dependencies. It's designed for teams using behavior-driven development who want visibility into test execution beyond simple pass/fail counts—showing which Given/When/Then steps succeeded or failed, how long each took, and how results evolved over time.

Use it for:

- Generate detailed BDD test reports for CI/CD pipelines to track test execution history and identify flaky scenarios.
- Share interactive test results with non-technical stakeholders who need to see which features passed acceptance criteria.
- Debug failed BDD scenarios by reviewing step-by-step execution logs and timing data in the Allure UI.
- Integrate test reporting into a continuous delivery workflow where test metrics feed into dashboards.
- Document test coverage and behavior validation across multiple test runs and environments.

## Worth the install?

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

Integrates Allure Report with Pytest-BDD to capture and visualize behavior-driven test results in a detailed HTML report.

Yes. The package is actively maintained, has no known vulnerabilities, and low install friction. If you use Pytest-BDD and need rich, shareable test reports beyond console output, this adapter is the standard integration path. The Apache-2.0 license poses no restrictions.

## Install

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

## Installing allure-pytest-bdd

Before you install: Low friction install with three straightforward runtime dependencies (pytest, pytest-bdd, allure-python-commons). The package is actively maintained with a recent release and no known vulnerabilities.

License in practice: Apache-2.0 is permissive; you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install allure-pytest-bdd

pytest --alluredir=allure_results ./tests
allure serve allure_results

Requires pytest and pytest-bdd to be installed; Allure Report command-line tool must be available to generate and serve the HTML report.

Verify before relying:

- Whether the package supports Python versions earlier than 3.8 despite classifiers listing 3.8 as the minimum.
- Performance characteristics when handling large numbers of BDD scenarios or complex test hierarchies.

## Package facts

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

## Tags

pytest bdd test reporting, allure report integration, bdd test visualization, pytest allure adapter, behavior driven development reporting, test result documentation, bdd test metrics, bdd-testing, test-reporting, pytest-plugin

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