qat.experimental.system_data.materialisers.model.materialise module

Default materialiser for canonical system data.

Reconstitutes a CanonicalSystemData from a payload produced by build_payload(). Version integrity is verified via the structural hash embedded in the payload.

materialise_model(source_payload)

Materialise canonical system data from a model source payload.

The model materialiser is a zero-transform materialiser: it reconstructs a CanonicalSystemData directly from a payload whose keys and values mirror the dataclass fields. Use CanonicalSystemDataBuilder.build_payload() to produce a conforming payload.

Parameters:

source_payload (dict[str, Any]) – Dict with a model key containing the CanonicalSystemData field values and a _version structural hash entry, as produced by build_payload().

Return type:

CanonicalSystemData

Returns:

A validated CanonicalSystemData constructed from source_payload.

Raises:

• UnsupportedSourceVersionError – If the _version key is absent or does not match the current structural hash.

• SourceValidationError – If source_payload contains keys incompatible with the CanonicalSystemData constructor.