cadrumo.application.review.errors module

Error hierarchy for the unified review queue.

All review-layer errors inherit from ReviewError, which in turn inherits from cadrumo.core.errors.hierarchy.CadrumoError per the project’s package-wide error-base mandate. Callers can therefore catch either ReviewError for review-specific failures or the package-wide cadrumo.core.errors.hierarchy.CadrumoError to handle every aeat domain error uniformly.

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

Bases: CadrumoError

Base class for every error raised by cadrumo.application.review.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

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

Bases: ReviewError

Raised when a source disk file is present but cannot be parsed.

Parameters:

  • message (str | None)

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

  • translated_message (str | None)

Return type:

None

code
exception FilterParseError(raw_token, *, reason)[source]

Bases: ReviewError

Raised when --filter KEY=VALUE cannot be parsed.

Carries the raw token plus a stable reason code so the CLI can render a per-language repair hint.

Variables:

  • raw_token – The string the operator supplied (e.g. "status=" or "period: 1T"). Stored as an internal diagnostic attribute, but omitted from rendered messages and context because filter values may include free-text search strings or imported identifiers.

  • safe_token – A redacted token that preserves the key when it is parseable and replaces the value with <redacted>.

  • reason – One of "missing-equals", "empty-key", "empty-value", "unknown-key-{scope}", "invalid-value-{scope}", "duplicate-key-{scope}".

Parameters:

  • raw_token (str)

  • reason (str)

Return type:

None

code