pytest-reporter-plus 0.1.9

Lightweight enhanced HTML reporter for Pytest

🧪 pytest-reporter-plus

A powerful, plug-and-play Pytest plugin to generate HTML + JSON reports, detect flaky tests, and optionally send reports via email. Works beautifully with or without xdist.

---

✨ Features

🧩 Unified Test Reports: Get a single, easy-to-read HTML report summarizing all your test results — no hassle, just clarity.

🔄 Flaky Test Detection: Automatically flags flaky tests so you can spot and fix inconsistent failures quickly.

📸 Screenshot Support: View screenshots directly in the report to understand failures faster.

📝 Comprehensive output capture: All your test logs with loggers, print() statements, and screenshots are automatically captured and embedded in the report...

📧 Email Test Reports: Send your reports via email effortlessly using SendGrid integration.

🐢 Spot Slow Tests: Highlights the slowest tests so you know where to optimize your suite.

⏱️ Sort & Filter: Easily sort tests by duration or filter by custom tags and skip status to focus on what matters.

---

Why use pytest-reporter-plus?

Stop wasting time writing and maintaining custom pytest reporter hooks like pytest_runtest_makereport! With pytest-reporter-plus, you get a beautiful, lightweight HTML report out of the box — no extra coding needed.

Just install, run your tests, and let the plugin handle all the reporting magic. Focus on what matters: writing and running your tests.

🚀 Installation

pip install pytest-reporter-plus
# or with Poetry
poetry add --dev pytest-reporter-plus

🧾 Usage

Generate HTML + JSON reports:

pytest -p pytest_reporter_plus.plugin --json-report

You’ll get:

report.html – a clean, styled HTML report

playwright_report.json – structured data for integrations

Available Options

Option	Description	Default	Choices
--json-report	Path to save individual JSON test reports	playwright_report.json	Any valid file path
--automation-tool	Specify automation tool used for testing	playwright	playwright, selenium
--capture-screenshots	When to capture screenshots	failed	failed, all, none
--html-output	Directory to output HTML reports	report_output	Any valid directory
--screenshots	Directory where screenshots will be stored	screenshots	Any valid directory
--send-email	Send HTML report via email after the test run	False	True, False
--detect-flake	Detect flaky tests based on reruns in the current or last few runs	False	True, False

🔁 Flaky Test Detection

If a test is retried multiple times (e.g. due to a --reruns plugin), the report will flag it as FLAKY.

In the HTML report, you’ll see a badge like:

📧 Email Report (Optional)

Send the HTML report via email using --send-email.

Setup Environment Variables

Create an emailenv file in your project folder that has the following

sender_email=[e-mail]
recipient_email=[e-mail]
report_path=report.html
subject=Your Test Report
smtp_server=smtp.sendgrid.net
smtp_port=587
email_password=your_sendgrid_api_key

Run

pytest --send-email

🤝 Contributions

PRs, issues, and feature requests are welcome! Let's make this tool more awesome together.

Setting up the project is pretty simple

docker build -t pytest-reporter-plus .
docker run -it pytest-reporter-plus /bin/bash 

📛 Naming

Why pytest-reporter-plus?

Because it does more than just reporting – it’s your enhanced test summary companion ✨

📜 License

MIT