aeat.domain.user_profile._errors module

Errors raised by the user-profile domain.

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

Bases: AeatError

Base error for every domain.user_profile 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 UserProfileSchemaLoadError(message=None, *, context=None)[source]

Bases: UserProfileError

Raised when the committed user-profile schema cannot be loaded.

Parameters:

  • message (str | None)

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

Return type:

None

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

Bases: UserProfileError, ValueError

Raised on invalid user profile values. Inherits from ValueError for Pydantic.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError, KeyError

Raised when a requested user profile section or field is missing.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Raised when a profile lookup targets an unknown profile_id.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Raised when a register / duplicate command collides with an existing profile.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Raised when a lifecycle command’s facts violate the schema contract.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Raised when modelo/revision preflight cannot find a required profile selector.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Raised when the recorded snapshot hash differs from the current projection.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Raised when a snapshot id has no persisted record in the secure backend.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Base error for profile-archive export failures (serialization, write).

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: UserProfileError

Base error for profile-archive import failures (parse, signature, collision).

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ProfileImportError

Raised when a profile archive fails its signature/integrity check.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

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

Bases: ProfileImportError

Raised when an imported profile_id collides with an existing profile.

Parameters:

  • message (str | None)

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

  • suggestion (str | None)

  • translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]
exception StoredProfileDriftError(profile_id, error)[source]

Bases: UserProfileError

Raised when a persisted profile record fails schema validation on load.

The record was valid when it was written; schema evolution or an out-of-band edit caused the on-disk representation to drift from the current UserProfileRecord schema. The original pydantic.ValidationError is preserved on original_exception so callers can inspect the typed field errors without losing the deserialization detail.

The CLI boundary catches this typed error and routes it to CliStoredDataValidationBoundaryError (distinct from the input-time CliValidationBoundaryError) so operators see a repair-oriented message rather than a generic refusal.

Variables:

  • profile_id – Identifier of the profile whose record drifted.

  • original_exception – The underlying pydantic.ValidationError.

Parameters:

  • profile_id (str)

  • error (ValidationError)

Return type:

None

code: ClassVar[ErrorCode]