tracetools_test.utils module

Utils for tracetools_test that are not strictly test-related.

tracetools_test.utils.cleanup_trace(full_path: str) → None

Cleanup trace data.

Parameters:

full_path – the full path to the main trace directory

tracetools_test.utils.get_event_names(events: List[tracetools_read.DictEvent]) → List[str]

Get a list of events names from a list of events.

Parameters:

events – the events of the trace

Returns:

the list of event names

tracetools_test.utils.run_and_trace(base_path: str, session_name_prefix: str, ros_events: List[str], kernel_events: List[str], package_name: str, node_names: List[str], namespace: str | None, additional_actions: List[launch.Action]) → Tuple[int, str]

Run a node while tracing.

Parameters:

• base_path – the base path where to put the trace directory

• session_name_prefix – the session name prefix for the trace directory

• ros_events – the list of ROS UST events to enable

• kernel_events – the list of kernel events to enable

• package_name – the name of the package to use

• node_names – the names of the nodes to execute

• namespace – the ROS namespace for the node(s)

• additional_actions – the list of additional actions to append

Returns:

exit code, full generated path