cadrumo.domain.usage_ratios.errors module

Domain exceptions for domain.usage_ratios.

The hierarchy roots at core.errors.hierarchy.CadrumoError so callers may catch the project-wide base class when treating the substrate as opaque, or the specific subclass when they need to distinguish persistence faults from upcoming domain-level failure modes.

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

Bases: CadrumoError

Base error for every domain.usage_ratios failure mode.

Subclassed by every concrete error raised by the package so callers can catch the broad family with a single except clause.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

code
exception UsageRatioPersistenceError(message=None, *, context=None, translated_message=None)[source]

Bases: UsageRatioError

Raised when the usage-ratio profile cannot be read or written.

Surfaced by adapters.persistence.profile.usage_ratios.load_usage_ratios() and adapters.persistence.profile.usage_ratios.save_usage_ratios() for OS-level I/O failures and for envelope payloads that fail strict validation.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

code
exception UsageRatioValidationError(message=None, *, context=None, translated_message=None)[source]

Bases: UsageRatioError

Raised when usage-ratio profiles violate domain invariants.

Pydantic validators translate this registered failure to ValueError at their narrow protocol boundary.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

code
exception CensoRatioMismatchError(message=None, *, context=None, translated_message=None)[source]

Bases: UsageRatioError

Raised when a persisted HOME_OFFICE ratio disagrees with the censo.

Surfaced by adapters.persistence.profile.usage_ratios.load_usage_ratios_with_censo_guard() when a pre-existing per-category override for a HOME_OFFICE category deviates from the legally-binding censo-derived value, or when the operator has not yet captured a censo snapshot at all. The AEAT is the binding legal source of truth for censo-derived values: a profile in conflict with the censo must be refused at the load boundary so the calculation surface never silently consumes a stale ratio.

The fix is operator-driven: either update the censo vivienda_office data via aeat config profile edit, or unset the diverging override via aeat app ledger ratios unset. No automatic migration; no shim.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

code