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