allure-behave

What it is and what it does

Allure Behave is a formatter plugin that bridges Behave (a Python BDD framework) and Allure Report, capturing test execution data and converting it into Allure's structured report format. When you run Behave scenarios with this formatter, it generates JSON result files that Allure can then render into interactive HTML dashboards showing test outcomes, timings, attachments, and failure details.

The package works as a Behave formatter that you specify on the command line, or as a hook you call from your environment.py file for advanced scenarios like parallel test execution. It depends on behave for the test framework and allure-python-commons for the reporting infrastructure, making it a lightweight adapter rather than a standalone tool.

Use it for:

• Generate visual test reports from Behave scenarios for CI/CD pipelines and team dashboards.
• Track BDD test metrics and trends over time using Allure's built-in analytics.
• Attach screenshots, logs, or other artifacts to failed Behave scenarios for debugging.
• Integrate Behave test results into existing Allure Report infrastructure used by other test frameworks.
• Document test execution history and link scenarios to requirements or test cases.

Worth the install?

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

Integrates Behave BDD test execution with Allure Report, generating detailed test reports and metrics from Behave scenarios.

Yes. Active maintenance, no security issues, low install friction, and a clear use case for teams already using Behave who want structured test reporting. The permissive Apache license poses no adoption barrier. Install if you run Behave scenarios and need Allure-compatible reports.

Install

allure-behave on PyPI

pip install allure-behave

uv add allure-behave

poetry add allure-behave

Installing allure-behave

Before you install

Low install friction with a pure Python wheel and only two runtime dependencies (behave and allure-python-commons). Actively maintained with recent releases and no known vulnerabilities.

License in practice

Apache-2.0 permissive license allows use in commercial and open-source projects with minimal restrictions; you must retain license notices.

Quickstart

pip install allure-behave
behave -f allure_behave.formatter:AllureFormatter -o ./allure_results ./features
allure serve ./allure_results

Requires Behave to be installed and feature files to exist; behave-parallel requires patching environment.py instead of using the formatter directly.

Verify before relying

• Whether the package works with Python versions older than 3.8 despite no explicit requires_python constraint.
• Performance characteristics when handling large numbers of scenarios or parallel test runs.

Package facts

Evidence: allure_behave-2.16.0-py3-none-any.whl

Keywords: allure, reporting, behave

Tags

More Testing packages