Awesome
<div align="center"> <h1>Robot Framework Metrics</h1> <p> Custom HTML report (dashboard view) by parsing robotframework output.xml file </p> <!-- Badges --> <p> <a href="https://github.com/adiralashiva8/robotframework-metrics/graphs/contributors"> <img src="https://img.shields.io/github/contributors/adiralashiva8/robotframework-metrics" alt="contributors" /> </a> <a href=""> <img src="https://img.shields.io/github/last-commit/adiralashiva8/robotframework-metrics" alt="last update" /> </a> <a href="https://github.com/adiralashiva8/robotframework-metrics/network/members"> <img src="https://img.shields.io/github/forks/adiralashiva8/robotframework-metrics" alt="forks" /> </a> <a href="https://github.com/adiralashiva8/robotframework-metrics/stargazers"> <img src="https://img.shields.io/github/stars/adiralashiva8/robotframework-metrics" alt="stars" /> </a> <a href="https://pypi.org/project/robotframework-metrics/"> <img src="https://img.shields.io/pypi/dm/robotframework-metrics.svg?logo=pypi&logoColor=aaaaaa&labelColor=333333" alt="downloads" /> </a> <a href="https://github.com/adiralashiva8/robotframework-metrics/issues/"> <img src="https://img.shields.io/github/issues/adiralashiva8/robotframework-metrics" alt="open issues" /> </a> <a href="https://github.com/adiralashiva8/robotframework-metrics/blob/master/LICENSE"> <img src="https://img.shields.io/github/license/adiralashiva8/robotframework-metrics.svg" alt="license" /> </a> </p> <h4> <a href="https://robotmetrics37.netlify.app/" target="_blank">View Demo</a> <span> ยท </span> <a href="https://github.com/adiralashiva8/robotframework-metrics/blob/master/README.md">Documentation</a> <span> ยท </span> <a href="https://github.com/adiralashiva8/robotframework-metrics/issues/">Report Bug</a> <span> ยท </span> <a href="https://github.com/adiralashiva8/robotframework-metrics/issues/">Request Feature</a> </h4> </div> <br /> <!-- Table of Contents -->๐ Table of Contents
<!-- About the Project -->๐ About the Project
Robot Framework Metrics
is a tool designed to generate comprehensive HTML reports
from Robot Framework's output.xml
files. These reports provide a dashboard view, offering detailed insights into your test executions, including suite statistics, test case results, and keyword performance.
๐ท Screenshots
<!-- TechStack -->๐ ๏ธ Tech Stack
<details> <ul> <li><a href="https://www.python.org/">Python</a></li> <li><a href="https://robot-framework.readthedocs.io/en/stable/autodoc/robot.result.html">Robotframework results api</a></li> <li><a href="https://pandas.pydata.org/docs/getting_started/index.html">Pandas</a></li> <li><a href="https://jinja.palletsprojects.com/en/2.10.x/">Jinja2</a></li> </ul> </details> <!-- Features -->๐ฏ Features
- Custom HTML Report: Create visually appealing and informative dashboard.
- Detailed Metrics: Access suite, test case, keyword statistics, status, and elapsed time.
- Support for RF7: Fully compatible with Robot Framework 7 (from v3.5.0 onwards).
- Command-Line Interface: Easy-to-use CLI for report generation.
๐งฐ Getting Started
<!-- Installation -->โ๏ธ Installation
You can install robotframework-metrics
using one of the following methods:
Method 1: Latest Development Version (Recommended) (for the latest features and RF7 support)
pip install git+https://github.com/adiralashiva8/robotframework-metrics
Method 2: Using pip
pip install robotframework-metrics==3.7.0
Method 3: From Source (clone the repository and install using setup.py)
git clone https://github.com/adiralashiva8/robotframework-metrics.git
cd robotframework-metrics
python setup.py install
<!-- Usage -->
๐ Usage
After executing your Robot Framework tests, you can generate a metrics report by running:
Default Configuration: If output.xml
is in the current directory
robotmetrics
Custom Path: If output.xml
is located in a different directory
robotmetrics --inputpath ./Result/ --output output1.xml
For more options:
robotmetrics --help
๐งช Continuous Integration (CI) Setup
To automate report generation in CI/CD pipelines, add the following steps to your pipeline configuration:
- Run tests with Robot Framework
- Generate the metrics report
robot test.robot & robotmetrics [:options]
& is used to execute multiple command's in .bat file
๐ค Contact
For any questions, suggestions, or feedback, please contact:
- Email: <a href="mailto:adiralashiva8@gmail.com?Subject=Robotframework%20Metrics" target="_blank">
adiralashiva8@gmail.com
</a>
๐ Acknowledgements
Special thanks to the following individuals for their guidance, contributions, and feedback:
Idea, Guidance and Support:
- Steve Fisher
- Goutham Duduka
Contributors:
- Pekka Klarck [Author of robotframework]
- Ruud Prijs
- Jesse Zacharias
- Bassam Khouri
- Francesco Spegni
- Sreelesh Kunnath
Feedback:
โญ Star this repository if you find it useful! (it motivates)