The Artefacts Toolkit (beta)

Using the Artefacts Toolkit

The Artefacts Toolkit is a Python package designed to improve developer productivity. It provides a collection of helper functions that simplify common testing tasks and integrate with the Artefacts platform.

The toolkit is organized into the following modules:

  • Configuration Helpers - Simplify parametric testing and bring in configurations from the artefacts.yaml file
  • Chart Helpers - Generate visualisations from test data
  • Gazebo Helpers - Interact with Gazebo simulations during tests
  • Rosbag Helpers - Record, extract, and analyze data from ROS bag files
  • Rerun Helpers - Record Rerun .rrd files during simulation and make test assertions against them

Installation

pip install artefacts-toolkit

Example Projects using the Artefacts Toolkit:

  • Nav2 - An example project using the Nav2 navigation stack and Gazebo.
Last modified September 18, 2026: Update cli reference (#153) (c83f1b9)