aeat.application.storage.calc_sheets._errors module

Typed exception hierarchy for the calc-sheets application layer.

Every subclass inherits from aeat.core.errors.AeatError; the project error registry’s __init_subclass__ hook binds each subclass to its declared aeat.core.errors.ErrorCode row at import time.

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

Bases: AeatError

Raised when the sheet-export engine encounters an unresolvable state.

Covers unsupported registry rounding codes and missing dated parameter values that prevent engine from producing a valid export plan.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

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

Bases: CoreValidationError

Raised when a calc-sheets record operation fails validation.

Covers column-index utility failures (out-of-range or malformed A1 column letters) that prevent SheetCellAddress construction. Inherits from CoreValidationError so pydantic validators can surface it as structured validation failure without losing the project-wide AeatError contract.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]

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

Bases: AeatError

Raised when a parity-harness scenario references unknown casillas.

Fired when a test scenario’s canonical casilla ids cannot all be resolved in the registry snapshot, making the scenario unprovable.

Parameters:

• message (str | None)

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

• suggestion (str | None)

• translated_message (str | None)

Return type:

None

code: ClassVar[ErrorCode]