Testing

Automated testing is an essential part of the development process to ensure the correctness and reliability of the Space Robotics Bench.

Scope

The SRB test suite focuses on integration tests of various workflows that are applied sequentially to all registered environments. As these tests require Isaac Sim to be running, NVIDIA GPU must be available on the system. For this reason, the full integration suite is not run automatically via CI/CD pipelines and must be executed manually. The pure-Python subsets (tests/unit, tests/terrain/unit, tests/test_checkpoint_discovery.py) are run in CI via .github/workflows/python.yml (on every PR and on non-docs pushes to main).

Hint: The fast unit-test subset under tests/unit/ does not require Isaac Sim or a GPU — run it anywhere with pytest tests/unit -q.

srb test — Run Tests

The srb test command simplifies running the test suites of SRB via pytest and/or cargo test.

srb test [options]

Options

Hint: This command supports forwarding of all arguments following --.

Examples

Forward -vx arguments to Python test suite (pytest):

srb test -- -vx

Run tests for both Python and Rust:

srb test --lang python rust