Robotmk Bridge

The bridge between automation islands and your monitoring

Robotmk Bridge is a Robot Framework library, listener, and CLI that for external test tools to convert their results into Robot Framework results.

It is used in two modes:

• In the Robotmk Bridge Agent Plugin which periodically writes converted results into the Robotmk results spool folder.
• As a Robot Framework Library to run external test tools from Robot Framework tests.

In this way, any test data can be imported into Checkmk monitoring with the help of Robotmk.

Features

• Unifies third-party test results inside Robot Framework log.html/report.html and the Robotmk Checkmk plug-in.
• Ships ready-made handlers, currently there is support for
  • JUnit
  • Gatling
  • OWASP ZAP
• Provides the dynamic library rmkbridge.RobotmkBridgeLibrary plus the listener rmkbridge.listener for Robot test suites.
• Offers a CLI (python -m rmkbridge) to transform standalone result files into Robot Framework output.xml artifacts.
• Lets you implement custom handlers by extending rmkbridge.BaseHandler.

Installation

pip install robotframework-robotmk-bridge

Prerequisites

• Windows, Linux, or macOS
• Python 3.10+
• Robot Framework 6.x (Robot Framework 7+ support is planned)
• pip and any extra requirements your handlers need

To verify the installation:

python -m rmkbridge --version

Quickstart

Option 1: Use as a Library to execute Test tools from Robot Framework

This mode consists of two steps:

1. Running the tool in Robot Framework
2. Running the Bridge-Listener

Step 1: Running the tool in Robot Framework

Each supported external test tool comes with a special trigger keyword Run <tool> to run the tool from inside Robot Framework. Depending on the Handler, the keywords support individual arguments.

*** Settings ***
Library    rmkbridge.RobotmkBridgeLibrary

*** Test Cases ***
JUnit unit tests should pass
    Custom Keyword 1
    Run JUnit    path/to/results.xml    java -jar junit.jar --reports-dir path/to
    Custom Keyword 2

Gatling regression should stay green
    Custom Keyword 1
    Run Gatling    path/to/gatling.log    ${GATLING_HOME}/bin/gatling.sh --simulation MySimulation
    Custom Keyword 2

ZAP scan finds no blockers
    Custom Keyword 1
    Run Zap    path/to/zap.json    python zap_scan.py
    Custom Keyword 2

Step 2: Running the Listener

Now execute the suite with the Robotmk Bridge listener so the external reports are injected into the output:

robot --listener rmkbridge.listener tests/my_suite.robot

Robotmk Bridge creates Test Results using the following rules:

• trigger keywords (which run the tools) become Test Cases.
• Keywords before the trigger keyword are wrapped into a Test Setup keyword.
• Keywords before the trigger keyword are wrapped into a Test Teardown keyword.

Option 2: Command Line Usage to convert existing results

Use the CLI when you need to convert tool reports without running Robot Framework suites:

python -m rmkbridge rmkbridge.junit --result-file path/to/results.xml

• The converted file gets created next to the source as *_robot_output.xml.
• Similar to trigger keywords, each handler also exposes its own CLI flags. List them with python -m rmkbridge rmkbridge.junit --help.
• Global switches:
  • python -m rmkbridge --print-config
  • python -m rmkbridge --add-config path/to/custom_handler.yml
  • python -m rmkbridge --reset-config

Keyword Documentation

• Open the generated keyword reference

• Regenerate locally when you add handlers:

  python -m robot.libdoc rmkbridge.RobotmkBridgeLibrary docs/RobotmkBridgeLibrary-$(python -c "import rmkbridge; print(rmkbridge.VERSION)").html

🤝 Contribute Your Own Handlers!

The Robotmk Bridge is an open-source project — and we’d love to see it grow with the help of the community! Our goal is to make Robotmk a truly multi-purpose integration layer for all kinds of test results.

If you’re working with a testing tool that isn’t supported yet, consider developing your own Bridge Handler and sharing it with others. Every new handler expands what Robotmk can do and helps bring monitoring and test automation even closer together.

Pull requests, discussions, and ideas are always welcome!

Read more:

• How to write your own Handler in Python
• How to contribute ot the project

License & Acknowledgements

Special thanks to Eficdoe Oy, Finland. RobotmkBridge is based on their project robotframework-oxygen.

See ACKNOWLEDGEMENTS.md for the roots of the project and credits.
Released under the MIT License.