qat.experimental.system_data.materialisers.errors module

Exception hierarchy for the experimental materialisation boundary.

exception MaterialisationConsistencyError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when materialiser-stage state is contradictory or impossible.

code = 'materialisation_consistency_error'

exception MaterialisationError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: RuntimeError

Base class for materialisation boundary errors.

code = 'materialisation_error'

to_dict()

Return a structured representation of the error context.

Return type:

dict[str, Any]

exception MaterialisationIntegrityError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when materialiser-stage payload data is malformed.

code = 'materialisation_integrity_error'

exception MaterialisationValidationError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when materialiser-stage adaptation or validation fails.

code = 'materialisation_validation_error'

exception SourceConsistencyError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when cross-entity consistency validation fails.

code = 'source_consistency_error'

exception SourceIntegrityError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when authenticity or integrity checks fail.

code = 'source_integrity_error'

classmethod for_check_failure(*, source_type, source_version, check, cause=None)

Create a standard integrity-check failure error payload.

Return type:

SourceIntegrityError

exception SourceValidationError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when ingress DTO validation fails.

code = 'source_validation_error'

exception UnsupportedSourceError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when a source type is unsupported.

code = 'unsupported_source'

classmethod for_source(*, source_type, source_version, supported_sources, cause=None)

Create a standard unsupported-source error payload.

Return type:

UnsupportedSourceError

exception UnsupportedSourceVersionError(message, *, source_type=None, source_version=None, path=None, details=None, cause=None)

Bases: MaterialisationError

Raised when a source version is unsupported.

code = 'unsupported_source_version'

classmethod for_version(*, source_type, source_version, supported_versions)

Create a standard unsupported-source-version error.

Return type:

UnsupportedSourceVersionError