pytest-html-dashboard 1.1.0

Beautiful dashboard-style HTML reports for pytest with charts, error analysis, and visual insights

pytest-html-dashboard

Transform your pytest HTML reports into beautiful, interactive dashboards!

A comprehensive pytest plugin that enhances HTML reports with interactive charts, intelligent error classification, and modern styling.

✨ Features

🎯 Interactive Charts - Visualize test results with Chart.js powered donut and pie charts 🎨 Modern UI - Beautiful gradient styling with responsive design 🔍 Smart Error Analysis - Automatic error classification with suggested fixes 📊 Comprehensive Tables - Detailed test information with expandable error details 🔧 Highly Configurable - YAML, CLI, or programmatic configuration ⚡ Zero Config - Works out of the box with sensible defaults 📱 Mobile Responsive - Looks great on all devices 🎭 Custom Branding - Add your logo, colors, and company name

📸 Sample Report

View Sample Report (Download and open in browser)

The enhanced report includes:

• Test Status Distribution - Visual breakdown of passed/failed/skipped tests
• Pass Rate Charts - Overall test success metrics
• Error Analysis - Categorized failures with remediation suggestions
• Comprehensive Test Table - Filterable, sortable results with error details
• Step Execution Summary - Detailed test step information

🚀 Quick Start

Installation

pip install pytest-html-dashboard

Basic Usage

pytest --html=report.html --self-contained-html

That's it! The plugin automatically enhances your HTML report with all features enabled.

📖 Configuration

YAML Configuration

Create pytest_html_dashboard.yaml:

branding:
  company_name: "My Company"
  report_title: "Test Execution Dashboard"
  logo_url: "path/to/logo.png"  # Or base64 encoded
  primary_color: "#667eea"
  secondary_color: "#764ba2"

charts:
  enable_charts: true
  chart_height: 300
  chart_animation: true

report:
  enable_enhanced_reporting: true
  enable_error_classification: true
  show_timestamps: true

Command Line Options

pytest --html=report.html \
       --dashboard-company-name="My Company" \
       --dashboard-report-title="Test Dashboard" \
       --dashboard-primary-color="#667eea"

Programmatic Configuration

# conftest.py
from pytest_html_dashboard import ReporterConfig, BrandingConfig

def pytest_configure(config):
    branding = BrandingConfig(
        company_name="My Company",
        report_title="Custom Dashboard",
        primary_color="#667eea"
    )

    reporter_config = ReporterConfig(branding=branding)
    config._dashboard_config = reporter_config

📊 Configuration Options

Branding

Option	Default	Description
company_name	"Test Automation Framework"	Your company/project name
report_title	"Test Execution Dashboard"	Report header title
logo_url	None	Logo image (URL or base64)
primary_color	"#004488"	Primary theme color
secondary_color	"#0066CC"	Secondary theme color
success_color	"#4CAF50"	Success indicator color
failure_color	"#f44336"	Failure indicator color

Charts

Option	Default	Description
enable_charts	true	Enable/disable charts
chart_height	300	Chart height in pixels
chart_animation	true	Animated chart transitions
show_pass_rate_chart	true	Display pass rate visualization
show_status_distribution_chart	true	Display status breakdown

Report Features

Option	Default	Description
enable_enhanced_reporting	true	Enable all enhanced features
enable_error_classification	true	Categorize and analyze errors
enable_comprehensive_table	true	Show detailed test table
max_error_message_length	100	Truncate long error messages
show_timestamps	true	Display test execution times
show_duration	true	Show test durations

🎯 CI/CD Integration

GitHub Actions

- name: Run tests
  run: pytest --html=report.html --self-contained-html

- name: Upload report
  uses: actions/upload-artifact@v3
  with:
    name: test-report
    path: report.html

Jenkins

pipeline {
    stages {
        stage('Test') {
            steps {
                sh 'pytest --html=report.html --self-contained-html'
            }
        }
    }
    post {
        always {
            publishHTML([
                reportDir: '.',
                reportFiles: 'report.html',
                reportName: 'Test Dashboard'
            ])
        }
    }
}

GitLab CI

test:
  script:
    - pytest --html=report.html --self-contained-html
  artifacts:
    when: always
    paths:
      - report.html
    expire_in: 30 days

📦 Examples

The repository contains:

• tests/test_dashboard_features.py - Comprehensive test suite demonstrating all features
• config/sample_config.yaml - Sample configuration file
• reports/complete_dashboard_report.html - Sample generated report
• examples/ - Additional examples and demos

Run the tests:

pytest tests/test_dashboard_features.py --html=reports/report.html --self-contained-html

🔍 What's Enhanced?

Interactive Features

• ✅ Click column headers to sort table data
• ✅ Filter tests by status (passed/failed/skipped)
• ✅ Filter by error category
• ✅ Search tests by name
• ✅ Click "View Error" buttons for detailed error information
• ✅ Hover over charts for detailed statistics

Visual Enhancements

• ✅ Modern gradient backgrounds
• ✅ Animated charts with data labels
• ✅ Color-coded test status indicators
• ✅ Responsive layout for mobile devices
• ✅ Professional typography and spacing
• ✅ Sticky table headers for easy navigation

Error Intelligence

Automatically categorizes errors into:

• 🔴 Assertion Failures - Test logic issues
• ⏱️ Timeout Errors - Performance problems
• 🔌 Connection Errors - Network/API issues
• ⚙️ Configuration Errors - Setup problems
• 📦 Import Errors - Dependency issues
• 🐛 Runtime Errors - Execution failures

Each error includes:

• Error type and message
• Full stack trace
• Suggested remediation steps
• Context and timestamp

🆚 Comparison with pytest-html

Feature	pytest-html	pytest-html-dashboard
Basic HTML reports	✅	✅
Interactive charts	❌	✅
Error classification	❌	✅
Custom branding	Limited	✅ Full
Filter & sort	❌	✅
Suggested actions	❌	✅
Mobile responsive	Partial	✅ Full
Configuration	Limited	✅ Extensive

🛠️ Development

Setup

git clone https://github.com/nireshs/pytest-html-dashboard.git
cd pytest-html-dashboard
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e ".[dev]"

Run Tests

pytest tests/ --cov=pytest_html_dashboard --cov-report=html

Build Package

python -m build

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Submit a pull request

📝 License

MIT License - see LICENSE file for details.

🙏 Credits

• Built on pytest and pytest-html
• Charts by Chart.js
• Modern design inspired by contemporary dashboard UIs

📮 Support

• 📧 Email: [e-mail]
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

🗺️ Roadmap

• Historical test trend analysis
• Test comparison between runs
• PDF export capability
• Real-time test execution dashboard
• Additional chart types (bar, line, scatter)
• Custom theme marketplace
• Integration with test management tools

📄 Changelog

v1.1.0 (2025-11-22)

• ✨ Complete dashboard enhancement system
• 📊 Interactive Chart.js visualizations
• 🎨 Modern gradient styling with responsive design
• 🔍 Intelligent error classification
• ⚙️ Comprehensive configuration system
• 📋 Enhanced test tables with filter/sort
• 🚀 Automatic enhancement via pytest hooks

---

⭐ Star us on GitHub if you find this useful! ⭐

Made with ❤️ for the pytest community