aeat.application.wizard._errors module

Wizard error hierarchy.

Every wizard error inherits from AeatError so callers can catch the package-wide base class to handle every aeat domain error uniformly. Each concrete subclass is bound to an ErrorCode in the application error registry.

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

Bases: AeatError

Base class for every wizard error.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: WizardError, CoreValidationError

Raised when a widget-level validator rejects an answer.

Inherits from CoreValidationError (which itself inherits from CoreError and ValueError) to participate in the shared CoreValidationError catch surface and remain compatible with pydantic field validators.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: WizardError

Raised when a ScriptedPrompter is asked for more answers than it carries.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: WizardError

Raised when a ScriptedPrompter is closed with unconsumed scripted answers.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: WizardError

Raised when a --quiet invocation omits a required-and-not-conditional question.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: WizardError

Raised when compile_profile_keys rejects a malformed wizard catalogue.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ProfileAnswerTypeError

Raised when a SetupAnswers field coercion receives an unexpected type.

Each @field_validator in aeat.core.setup_answers’s SetupAnswers raises ProfileAnswerTypeError (the canonical core type); this subclass is retained so application-layer code and tests that catch WizardAnswerTypeError by name continue to work.

Inherits from ProfileAnswerTypeError (which inherits from CoreValidationError and ValueError) to remain compatible with pydantic’s field-validator contract while exposing a typed exception in the error registry.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]