Home

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 -->

๐Ÿ“ท Screenshots

Metrics Report

<!-- 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

<!-- Getting Started -->

๐Ÿงฐ 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:

  1. Run tests with Robot Framework
  2. Generate the metrics report
    robot test.robot &
    robotmetrics [:options]
    

    & is used to execute multiple command's in .bat file

<!-- Contact -->

๐Ÿค Contact

For any questions, suggestions, or feedback, please contact:

<!-- Acknowledgments -->

๐Ÿ’Ž Acknowledgements

Special thanks to the following individuals for their guidance, contributions, and feedback:

Idea, Guidance and Support:

Contributors:

  1. Pekka Klarck [Author of robotframework]
  2. Ruud Prijs
  3. Jesse Zacharias
  4. Bassam Khouri
  5. Francesco Spegni
  6. Sreelesh Kunnath

Feedback:

  1. Mantri Sri
  2. Prasad Ozarkar
  3. Suresh Parimi
  4. Amit Lohar
  5. Robotframework community users

โญ Star this repository if you find it useful! (it motivates)