/robotframework-ghareports

RobotFramework listener plugin that will generate test reports from robotframework test execution

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

robotframework-ghareports

This project enables robot framework to generate Github Job Summary for a testrun. Its a simple robot framework listener, that once activated when RF is executed, it checks if environment variable GITHUB_STEP_SUMMARY exists and if it does, it exposes test results to a PR - example output looks something like this

Usage

Install:

python -mpip install robotframework-ghareports

Usage:

robot --listener GHAReports .

If you want to limit the width of the tables in the summary, you can provide an argument to the listener like this:

robot --listener GHAReports:35 .

This will split each test case name at every 35 characters into a new line.

And if you want to generate the summary even if a) you are not running in Github or you want to generate extra summary file independent of Github actions, pass report_file argument to the listener like this:

robot --listener GHAReports:report_file=extra_summary.md

or

robot --listener GHAReports:34:extra_summary.md