aeat.domain.manuals._errors module

Domain errors for the aeat.domain.manuals subpackage.

Every exception raised by loading, verifying, fetching, or extracting from the AEAT Manual práctico corpus inherits from ManualError, which in turn inherits from aeat.core.errors.AeatError.

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

Bases: AeatError

Base error for every aeat.domain.manuals failure mode.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ManualError

Raised when a requested manual/year/part is missing on disk.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ManualError

Raised when a committed manual record fails schema validation.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ManualError

Raised when a persisted record lacks reviewer metadata.

The verify CLI rejects any Manual, Section, or Rule record missing definition_reviewed_by or definition_reviewed_at when the AEAT_MANUALS_REVIEW_REQUIRED setting is enabled.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ManualError

Raised by LLM-dependent CLI subcommands that have no backing implementation.

The structure, extract-rules, and translate subcommands define their public CLI shape but raise this exception until the aeat.adapters.outbound.llm subpackage is available.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ManualError

Raised when a manifest.json fails schema or sha256 checks.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ManualError, ValueError

Raised when manual records violate state or shape invariants.

Inherits from ValueError to maintain compatibility with Pydantic validators.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]