cadrumo.domain.calculations.registry.calendar_ccaa_catalogue module

Typed projection of the deadline-calendar CCAA territory vocabulary.

The deadline calendar has a wider territory axis than the Renta tax-residence catalogue: it includes the two foral communities and the autonomous cities of Ceuta and Melilla because each may publish holidays that affect an AEAT filing deadline. Fact 0143 owns the ISO 3166-2:ES values; fact 0129 remains the separate fifteen-member common-regime tax-residence vocabulary.

class CalendarCcaaDefinition(token, member_name, description, territory_kind)[source]

Bases: object

One registry-declared deadline-calendar territory.

Parameters:
token: CalendarCCAA
member_name: str
description: str
territory_kind: str
class CalendarCcaaCatalogue(definitions, tax_residence_fact_id, tax_residence_common_regime_count, includes_foral_territories, includes_autonomous_cities)[source]

Bases: object

Complete typed projection of the dated calendar-territory fact.

Parameters:
definitions: tuple[CalendarCcaaDefinition, ...]
tax_residence_fact_id: str
tax_residence_common_regime_count: int
includes_foral_territories: bool
includes_autonomous_cities: bool
property choices: tuple[CalendarCCAA, ...]

Return calendar territories in authored order.

property tokens: frozenset[CalendarCCAA]

Return all calendar territories declared by the selected fact.

require(value)[source]

Project an ISO territory code only when the selected fact declares it.

Return type:

CalendarCCAA

Parameters:

value (object)

require_member_name(name)[source]

Project a historical enum-style member name from the catalogue.

Return type:

CalendarCCAA

Parameters:

name (str)

definition(value)[source]

Return the selected territory’s registry-owned metadata.

Return type:

CalendarCcaaDefinition

Parameters:

value (object)

resolve_calendar_ccaa_catalogue(*, effective_date=None, authority=None)[source]

Resolve the selected dated deadline-calendar territory catalogue.

Return type:

CalendarCcaaCatalogue

Parameters:
require_calendar_ccaa(value, *, effective_date=None, authority=None)[source]

Project one ISO 3166-2:ES deadline-calendar code through fact 0143.

Return type:

CalendarCCAA

Parameters: