Playwright Smart Reporter - Python

Python integration for Playwright Smart Reporter - writes the Smart Reporter HTML report for your pytest test suites.

Features

• HTML report - the same single-page report as the Node.js reporter
• Test results - status, duration, error and keywords (as tags) for each pytest test
• Modern Dashboard - Interactive sidebar navigation, light/dark themes

Limits

The bridge converts the results of one pytest run. It keeps no history and calls no AI provider, so these Node.js reporter features are not available:

• AI failure analysis and the AI suite summary
• Trend charts across runs (the report shows the current run only)
• Flakiness detection, performance regression alerts and stability grades
• Failure clustering

Prerequisites

• Python 3.9+
• Node.js 18+ (runtime only - no npm install needed)

Installation

pip install playwright-smart-reporter-python

The package is self-contained. The compiled JavaScript report generator is bundled in the wheel - Node.js is only needed at runtime to execute it.

Quick Start

Option 1: Pytest Plugin (Automatic)

Run your tests with the --smart-reporter flag:

pytest --json-report --smart-reporter

Report automatically generated at smart-report.html.

Option 2: Manual Generation

from playwright_smart_reporter_python import SmartReporterBridge

bridge = SmartReporterBridge()
bridge.generate_report(
    pytest_json_path=".pytest-report.json",
    output_html="smart-report.html"
)

Configuration

pytest.ini / pyproject.toml

[pytest]
addopts =
    --json-report
    --json-report-file=.pytest-report.json
    --smart-reporter
    --smart-reporter-output=test-reports/smart-report.html

Usage with Playwright for Python

# test_example.py
from playwright.sync_api import Page

def test_homepage(page: Page):
    page.goto("https://playwright.dev")
    assert page.title() == "Fast and reliable end-to-end testing"

pytest --headed --smart-reporter

How It Works

1. pytest runs your tests with JSON reporting enabled
2. Converter transforms pytest JSON to Playwright Smart Reporter format
3. Node.js bridge calls the bundled HTML generator
4. Output interactive HTML report

Development

This is part of a monorepo. The Python package lives in python/ and can use either the bundled JS dist (PyPI install) or the monorepo dist/ (local development).

# From repository root
npm run build                      # Compile TypeScript
cd python
python scripts/bundle_dist.py      # Bundle JS into package
pip install -e ".[dev]"            # Editable install
pytest tests/ -v                   # Run tests

Troubleshooting

Node.js not found

The package needs Node.js at runtime to execute the report generator:

# macOS
brew install node

# Linux
sudo apt install nodejs

# Windows
# Download from https://nodejs.org

License

MIT - See LICENSE.

Related

• Playwright Smart Reporter (Node.js) - Main package
• Playwright for Python - Playwright Python bindings