aeat.domain.calculations.registry._bindings_previous_filing module

Previous-filing binding selectors, requirements, and resolvers.

The ModeloRevision supplies previous_filing DataBindingDefinition declarations; this module turns those selectors into RegistryFoldRequirement source requirements and resolved BindingId values.

See also

aeat.domain.calculations.registry._bindings

Public import surface that re-exports these previous-filing helpers.

aeat.domain.calculations.registry._relations

Relation-fold sibling that materialises cross-modelo source values.

aeat.domain.calculations.registry._observation_fold

Shared fold helpers for observed casilla values.

class PreviousFilingSourceReference(source_modelo, required_periods, source_casilla_ids)[source]

Bases: object

Canonical source reference extracted from a typed previous-filing selector.

The reference names the source ModeloId, required periods, and source CasillaId values declared by one previous-filing binding selector.

Parameters:

  • source_modelo (ModeloId)

  • required_periods (tuple[str, ...])

  • source_casilla_ids (tuple[CasillaId, ...])

source_modelo: TypeAliasType
required_periods: tuple[str, ...]
source_casilla_ids: tuple[TypeAliasType, ...]
previous_filing_source_reference(binding)[source]

Return the PreviousFilingSourceReference for a previous_filing binding.

The supplied DataBindingDefinition is parsed through the same selector model used by previous_filing_observation_requirements().

Return type:

PreviousFilingSourceReference

Parameters:

binding (DataBindingDefinition)

previous_filing_observation_requirements(revision, *, filing_year, period)[source]

Return source requirements needed by direct previous-filing bindings.

The ModeloRevision is scanned for direct previous_filing bindings, and each selector becomes a RegistryFoldRequirement naming source modelo/year/period, BindingId consumers, and source casilla ids.

Return type:

tuple[RegistryFoldRequirement, ...]

Parameters:
resolve_previous_filing_binding_values(revision, observations, *, filing_year, period, activity_start_date=None, excluded_binding_ids=None)[source]

Resolve direct previous-filing bindings from observed filed declarations.

The ModeloRevision supplies the binding selectors and aggregation operators; observations supply the filed casilla values they fold. The returned mapping is keyed by BindingId and carries resolved decimal.Decimal values for formula runtime consumption.

Return type:

dict[TypeAliasType, Decimal]

Parameters:
validate_previous_filing_binding(binding)[source]

Validate a previous_filing binding at registry-build time.

Accumulating list[str] validator: validates the selector shape against _PreviousModeloSelector and lifts the previous-filing op/source invariants for a DataBindingDefinition to build time, preserving the underlying pydantic field error.

Return type:

list[str]

Parameters:

binding (DataBindingDefinition)