⚡ pytest-apmt-reporter

pytest-apmt-reporter is a premium, feature-rich, and visually stunning automated testing HTML reporter for Python, Pytest, and Playwright. Designed as a modern, high-fidelity alternative to Allure and Robot Framework, it features responsive layouts, a glowing glassmorphic dark-mode dashboard, interactive charts, nested execution steps, failure tracebacks, and automatically embedded screenshots.

🎨 Premium Visual Preview

(A sleek, glassmorphic dark-mode UI with vibrant neon colors, dynamic transitions, and interactive SVG status charts)

🚀 Easy & Beautiful Step-by-Step Guide

Step 1: 🔌 Installation

Install the package directly into your virtual environment:

pip install pytest-apmt-reporter

[!NOTE] By hooking directly into standard Pytest entry points, the reporter is automatically active immediately upon installation. No extra setup or config files are required!

Step 2: ✍️ Write Your Tests

Organize your test cases using step decorators, custom logs, metadata, and screenshots:

import pytest_apmt_reporter as apmt

@apmt.step("1. Authenticate with credentials")
def login(username, password):
    apmt.attach("Connecting to authorization endpoint...", name="Network Handshake")
    # ... login logic ...

def test_purchase_flow(page):
    """Verify purchase process end-to-end"""
    apmt.set_environment_info("Environment", "Staging-US-East")
    
    with apmt.step("2. Populate Shopping Cart"):
        apmt.attach('{"item_id": 102, "qty": 1}', name="API Request Payload", attachment_type=apmt.AttachmentType.JSON)
        
    login("demo_user", "secure_pass")
    
    with apmt.step("3. Navigate to checkout and confirm"):
        page.goto("https://shop.dev.local/checkout")
        # If any assertion fails below, a screenshot is automatically captured!
        assert page.locator("#confirm-btn").is_visible()

Step 3: 🛠️ Run & Generate

Simply run pytest as you normally would. The reporter will auto-detect and generate a beautiful self-contained HTML dashboard.

# Run pytest (generates report.html by default)
pytest

# Customize output filename and location
pytest --apmt-html=reports/e2e_dashboard.html

# Set a custom title for the dashboard header
pytest --apmt-title="US Staging E2E Suite"

Step 4: 📊 View the Report

Open the generated HTML file in any browser of your choice.

• Windows (PowerShell): Start-Process report.html
• macOS/Linux: open report.html

⚖️ Why pytest-apmt-reporter?

[!TIP] Since the report is 100% offline-first, all styles, execution metrics, and images are compiled into a single HTML file. No external CDNs or network connections are used, making it perfectly secure and portable for email sharing or CI/CD build artifacts.

📝 Advanced Features

1. Programmatic Attachments

Attach raw console stdout, logs, JSON objects, or custom screenshots directly to steps:

apmt.attach("Some text log content", name="Log Name")
apmt.attach('{"status": "success"}', name="API Output", attachment_type=apmt.AttachmentType.JSON)
apmt.attach_screenshot(page, name="Post-Login Screen")

2. Custom Environment Properties

Inject metadata dynamically in the header summary cards:

apmt.set_environment_info("Execution Mode", "Pytest Automation Suite")
apmt.set_environment_info("CI Build Run ID", "90123")

📈 Try the Repository Demo

To quickly see how exceptions, nested steps, and failure banners render, execute:

pytest demo/test_playwright_demo.py --apmt-html=demo_report.html