Skip to content

Registry

_interpretation_registry

Locale-aware interpretation dataset lookup.

InterpretationDatasetLookup dataclass

InterpretationDatasetLookup(data: InterpretationData | None, requested_locale: str, normalized_locale: str, resolved_locale: str)

Result of a locale-aware interpretation dataset lookup.

data instance-attribute

data: InterpretationData | None

requested_locale instance-attribute

requested_locale: str

normalized_locale instance-attribute

normalized_locale: str

resolved_locale instance-attribute

resolved_locale: str

provenance_notes property

provenance_notes: tuple[str, ...]

Return audit notes for the lookup.

InterpretationRegistry dataclass

InterpretationRegistry(datasets: Mapping[str, InterpretationData])

Locale-indexed interpretation datasets for one dataset family.

datasets instance-attribute

datasets: Mapping[str, InterpretationData]

lookup

lookup(locale: str) -> InterpretationDatasetLookup

Return the best dataset for a requested locale.

Source code in src/fortune_telling_core/_interpretation_registry.py
def lookup(self, locale: str) -> InterpretationDatasetLookup:
    """Return the best dataset for a requested locale."""

    resolution = resolve_locale(locale)
    for candidate in resolution.candidates:
        data = self.datasets.get(candidate)
        if data is not None:
            return InterpretationDatasetLookup(
                data=data,
                requested_locale=resolution.requested,
                normalized_locale=resolution.normalized,
                resolved_locale=candidate,
            )
    return InterpretationDatasetLookup(
        data=None,
        requested_locale=resolution.requested,
        normalized_locale=resolution.normalized,
        resolved_locale=resolution.normalized,
    )