aeat.domain.buckets._errors module

Narrow exceptions for the bucket-event-history domain.

BucketEventValidationError protects BucketEvent and BucketEventHistoryCatalogue invariants, while the maintenance errors cover operator-facing bucket browse, export, import, rename, and delete flows.

exception BucketsError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: AeatError

Base error for the bucket-event-history domain.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketEventValidationError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketsError, ValueError

Raised when a bucket event fails validation.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketMaintenanceError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketsError

Base error for operator-driven bucket-maintenance operations.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketBrowseError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when a bucket browse / search request cannot be served.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketExportError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when a bucket archive export fails.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketImportError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when a bucket archive import fails (bad payload or collision).

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketRenameError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when a bucket rename violates uniqueness or addressing rules.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketDeleteRefusedError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when a bucket delete is refused by a destructive-action gate.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketArchiveRefusedError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when a bucket archive (soft, reversible dormancy) is refused.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

exception BucketRestoreRefusedError(message=None, *, context=None, suggestion=None, translated_message=None)

Bases: BucketMaintenanceError

Raised when restoring an archived bucket is refused (e.g. not archived).

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]