Metadata-Version: 2.4
Name: robot-kpi-metrics
Version: 1.0.1
Summary: Advanced KPI Dashboard and Metrics Generator for Robot Framework Test Results
Home-page: https://github.com/mrlaw74/robot-kpi-metrics
Author: mrlaw74
Author-email: nvluathcmut@gmail.com
License: MIT
Keywords: robotframework report kpi metrics
Classifier: Framework :: Robot Framework
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Testing
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: robotframework
Requires-Dist: jinja2
Requires-Dist: pandas
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary


# Robot KPI Metrics

A comprehensive HTML dashboard generator that transforms Robot Framework test results into interactive KPI reports with advanced analytics and performance insights.

## Features

### 📊 **Interactive Dashboard**
- **Test Status Overview**: Visual pie charts and statistics for test execution results
- **Suite Analytics**: Detailed breakdown of test suite performance and status
- **Keyword Metrics**: Execution statistics and performance analysis for keywords
- **Execution Timeline**: Duration tracking and timing analysis

### 🚀 **Performance KPIs**
- **Top 10 Slowest Tests**: Identify performance bottlenecks and optimization targets
- **Longest Keywords**: Analyze keyword execution times for performance tuning
- **Execution Duration Charts**: Visual representation of test execution patterns
- **Performance Trends**: Historical analysis capabilities

### 📈 **Advanced Analytics**
- **Metadata Reporting**: Comprehensive test execution metadata including:
  - Project information (bundle version, machine details, build timestamps)
  - Environment details (hardware/software versions, test tool info)
  - Execution summary with pass/fail/skip statistics
- **Custom KPI Calculations**: Automated metric generation from Robot Framework results
- **Export Capabilities**: Generate standalone HTML reports for sharing

### 🎯 **Key Benefits**
- **Easy Integration**: Simple command-line interface for seamless CI/CD integration
- **No Dependencies**: Self-contained HTML reports with embedded CSS/JS
- **Responsive Design**: Mobile-friendly dashboards that work on any device
- **Real-time Insights**: Immediate visibility into test execution quality and performance

## Quick Start

```bash
# Install the package
pip install robot-kpi-metrics

# Generate KPI dashboard from Robot Framework results
robot-kpi-metrics --inputpath ./robot_results/

# View the generated metrics.html in your browser
```

## Use Cases

- **CI/CD Pipeline Integration**: Automated test reporting in build pipelines
- **Performance Monitoring**: Track test execution performance over time
- **Quality Assurance**: Visual insights for QA teams and stakeholders
- **Test Optimization**: Identify slow tests and performance bottlenecks
- **Executive Reporting**: High-level KPI dashboards for management visibility

## Requirements

- Python 3.6+
- Robot Framework test results (output.xml)
- Modern web browser for viewing reports

Perfect for DevOps teams, QA engineers, and anyone looking to get deeper insights from their Robot Framework test automation results.
    
