Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/adiralashiva8/robotframework-metrics

Custom HTML report (dashboard view) by parsing robotframework output.xml file
https://github.com/adiralashiva8/robotframework-metrics

html-report metrics-reported reports robot-framework robotframework robotframework-metrics

Last synced: 7 days ago
JSON representation

Custom HTML report (dashboard view) by parsing robotframework output.xml file

Awesome Lists containing this project

README

        


Robot Framework Metrics



Custom HTML report (dashboard view) by parsing robotframework output.xml file



contributors


last update


forks


stars


downloads


open issues


license


View Demo
ยท
Documentation
ยท
Report Bug
ยท
Request Feature



# ๐Ÿ“” Table of Contents

- [About the Project](#-about-the-project)
* [Screenshots](#-screenshots)
* [Tech Stack](#-tech-stack)
* [Features](#-features)
- [Getting Started](#-getting-started)
* [Installation](#-installation)
- [Usage](#usage)
* [Continuous Integration (CI) Setup](#-cisetup)
- [Contact](#-contact)
- [Acknowledgements](#-acknowledgements)

## ๐ŸŒŸ 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

![Metrics Report](https://github.com/adiralashiva8/robotframework-metrics/blob/master/metrics.png)

### ๐Ÿ› ๏ธ Tech Stack

### ๐ŸŽฏ 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

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

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

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

- Email: `[email protected]`

## ๐Ÿ’Ž Acknowledgements

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

*Idea, Guidance and Support:*
- Steve Fisher
- Goutham Duduka

*Contributors:*
1. [Pekka Klarck](https://www.linkedin.com/in/pekkaklarck/) [Author of robotframework]
2. [Ruud Prijs](https://www.linkedin.com/in/ruudprijs/)
3. [Jesse Zacharias](https://www.linkedin.com/in/jesse-zacharias-7926ba50/)
4. [Bassam Khouri](https://www.linkedin.com/in/bassamkhouri/)
5. [Francesco Spegni](https://www.linkedin.com/in/francesco-spegni-34b39b61/)
6. [Sreelesh Kunnath](https://www.linkedin.com/in/kunnathsree/)

*Feedback:*
1. [Mantri Sri](https://www.linkedin.com/in/mantri-sri-4a0196133/)
2. [Prasad Ozarkar](https://www.linkedin.com/in/prasad-ozarkar-b4a61017/)
3. [Suresh Parimi](https://www.linkedin.com/in/sparimi/)
4. [Amit Lohar](https://github.com/amitlohar)
5. [Robotframework community users](https://groups.google.com/forum/#!forum/robotframework-users)

---

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

---