---
id: behave-html-formatter
version: "0.9.10"
license: unclear
license_treatment: copyleft
maintenance: active
---

# behave-html-formatter — HTML formatter for Behave

License: copyleft · Maintenance: active · Downloads: 164.3K/mo

## What it is and what it does

This package extends Behave, the Python BDD framework, with an HTML formatter that transforms test execution results into readable HTML reports. It registers as a custom formatter within Behave's plugin system, allowing you to generate reports by passing `-f html` to the behave command-line tool. The formatter outputs browsable HTML files that present test scenarios, steps, and outcomes in a structured format suitable for sharing with stakeholders or archiving test results.

The package has minimal dependencies—only behave itself—and integrates through a configuration file rather than code changes. It supports Python 3.6 and later, including PyPy, and is actively maintained. The project is small and focused, with no known security vulnerabilities, making it a straightforward addition to a Behave-based testing workflow when HTML reporting is needed.

Use it for:

- Generate shareable HTML test reports from Behave BDD test suites for stakeholder review.
- Archive test execution results in a human-readable format for compliance or audit documentation.
- Create CI/CD pipeline artifacts that display test outcomes without requiring Behave to be installed on the viewing machine.
- Integrate Behave test results into project documentation or test dashboards via HTML output.
- Replace Behave's default console output with formatted HTML for better visibility of test step details and failures.

## Worth the install?

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

Generates HTML reports from Behave BDD test runs by registering as a custom formatter that outputs test results in browsable HTML format.

Yes, if you use Behave and need HTML test reports. The package is lightweight, has no security issues, and integrates cleanly via configuration. The GPLv3 license is a consideration only if you plan to redistribute or embed it in proprietary software. The last release was in June 2022, but the repository remains active with recent commits, so maintenance risk is low for a stable formatter.

## Install

pip install behave-html-formatter
uv add behave-html-formatter
poetry add behave-html-formatter

## Installing behave-html-formatter

Before you install: Low install friction with a single runtime dependency on behave. Actively maintained as of February 2026, though the last release was in June 2022.

License in practice: Licensed under GPLv3 (copyleft). Any derivative work or distribution must also be open-source under GPLv3 terms.

Quickstart:

pip install behave-html-formatter

# Add to behave.ini:
# [behave.formatters]
# html = behave_html_formatter:HTMLFormatter

behave -f html -o report.html

Requires behave to be installed and a behave.ini configuration file in the project or home directory.

Verify before relying:

- Whether the HTML output includes interactive features (filtering, search, collapsible sections) beyond static test results.
- Whether CSS/JavaScript minification mentioned in the contributing guide affects report file size or load performance.
- Compatibility with recent behave versions beyond the Python 3.9 support listed in classifiers.

## Package facts

- License: not declared (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 164.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

behave html report generator, bdd test html formatter, behave test results html, behavior driven development reporting, behave output html format, test report html generation, behave custom formatter, bdd-reporting, test-automation

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