Migrate Trace¶
migrate_trace
¶
Migrate_trace workflow action.
Migrates legacy trace files into GraphML graphs for cache storage. The action is stateless, so validation and execution delegate to module-level helpers and each step stays within the module and method limits.
Classes:
-
MigrateTraceAction–Migrate legacy trace files into GraphML graphs.
MigrateTraceAction
¶
Migrate legacy trace files into GraphML graphs.
Attributes:
-
action_name–Action name as used in workflow definitions.
-
pattern–Workflow action pattern used for cache validation.
Methods:
-
run–Execute trace migration to GraphML graphs.
-
validate–Validate migrate_trace parameters before execution.
run
¶
run(
parameters: Dict[str, Any],
mode: str,
context: Optional[Any] = None,
logger: Optional[Any] = None,
) -> ActionResult
Execute trace migration to GraphML graphs.
Migrates the matched trace files, returning exactly one GraphML object together with the flattened cache metadata. More than one matched graph is an error because the workflow matrix omitted a distinguishing dimension.
Parameters:
-
(parameters¶Dict[str, Any]) –Action parameter values.
-
(mode¶str) –Execution mode ('dry-run', 'run' or 'compare').
-
(context¶Optional[Any], default:None) –Workflow context for optimisation.
-
(logger¶Optional[Any], default:None) –Logger for reporting.
Returns:
-
ActionResult–Tuple of (status, metadata, objects).
Raises:
-
ActionExecutionError–If execution fails.
validate
¶
validate(parameters: Dict[str, Any]) -> None
Validate migrate_trace parameters before execution.
Parameters:
-
(parameters¶Dict[str, Any]) –Action parameter values.
Raises:
-
ValueError–If a parameter is missing or invalid. The provider converts this to an ActionValidationError.