stage_runner

Classes

StageResult

Functions

normalize_config

run_stage

Run a Puzzletron stage through the manifest and capability boundary.
class StageResult

Bases: object

__init__(stage, status, manifest_path, message, skip_reason=None)
Parameters:

  • stage (str)

  • status (str)

  • manifest_path (Path)

  • message (str)

  • skip_reason (str | None)

Return type:

None

manifest_path: Path
message: str
skip_reason: str | None = None
stage: str
status: str
normalize_config(config)
Parameters:

config (DictConfig | dict[str, Any])

Return type:

dict[str, Any]

run_stage(config, stage, *, handlers=None)

Run a Puzzletron stage through the manifest and capability boundary.

Disabled stages emit a typed skip. Every enabled stage must have a handler and propagate implementation failures to the caller.

Parameters:

  • config (DictConfig | dict[str, Any])

  • stage (str)

  • handlers (dict[str, Callable[[dict[str, Any], StageManifest], StageResult]] | None)

Return type:

StageResult