Roboticks

@confirms Decorator

Roboticks SDK decorator (Python) and macro (C++) that marks a test as confirming a specific requirement. Writes the linkage into JUnit user_properties; the platform reads it and creates a RequirementLink row pinned to the test outcome.

Why It Matters

Most "automatic traceability" tools fail at the basic linking step — they want to infer linkage from test names or comments, which breaks the moment someone refactors. An explicit decorator is unambiguous and survives renames.

How Roboticks Implements It

Python: @confirms("REQ-014") on a pytest function. C++: ROBOTICKS_CONFIRMS("REQ-014") inside a gtest macro. The pytest11 plugin (or the gtest listener) writes the requirement ID into user_properties. colcon test produces standard JUnit XML; the Roboticks reporter parses user_properties.

Related Terms

Related Pages