aeat.core.resources._errors module

Typed error hierarchy for the resource-management API.

Three top-level error classes give consumers a uniform catch surface across all twelve ResourceRepository implementations without breaking the existing per-domain error classes. Each per-domain error (RegistryLoadError, ManualParseError, etc.) subclasses the appropriate top-level error.

exception ResourceLoadError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: AeatError

Base class for every failure to load a bundled resource.

Parameters:

  • message (str | None)

  • context (dict[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception ResourceNotFoundError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: ResourceLoadError, CoreNotFoundError

A resource key does not resolve to any bundled file.

Raised when the underlying bundled-data path does not exist or when a queried identifier has no record in the loaded catalogue.

Inherits from CoreNotFoundError to participate in the shared not-found catch surface across all layers.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception ResourceValidationError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: ResourceLoadError

A bundled file exists but fails strict pydantic validation.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception ResourceBackendError(message=None, *, context=None, suggestion=None, translated_message=None)[source]

Bases: ResourceLoadError

An IO or backend-level failure while reading the bundled data.

Parameters:

  • message (str | None)

  • context (Mapping[str, object] | None)

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]