Skip to content

Symbol interpretation

_symbol_interpretation

Generic symbol-keyed interpretation datasets driven by locale bundles.

Most traditions need only a meaning per deck symbol. This builds such datasets uniformly: structure (the symbol ids and their order) comes from a core deck, while the per-symbol text comes from JSON locale bundles (:mod:fortune_telling_core._interpretation_bundle). The bundle vocab is keyed by the full symbol id.

  • symbol_registry - one entry per symbol, from a meanings group.
  • reversible_registry - upright (also the default, unmodified key) and reversed entries, from upright and reversed groups.

symbol_registry 

symbol_registry(anchor: str, dataset: str, dataset_id: str, symbols: Sequence[Symbol], source: str) -> InterpretationRegistry

Registry of one-meaning-per-symbol datasets across all bundle locales.

Source code in src/fortune_telling_core/_symbol_interpretation.py 
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
def symbol_registry(
    anchor: str,
    dataset: str,
    dataset_id: str,
    symbols: Sequence[Symbol],
    source: str,
) -> InterpretationRegistry:
    """Registry of one-meaning-per-symbol datasets across all bundle locales."""

    def _build(locale: str, bundle: LocaleBundle) -> MappingInterpretationData:
        meanings = bundle.group("meanings")
        return MappingInterpretationData(
            id=f"{dataset_id}.{locale}.v1",
            entries=tuple(
                InterpretationEntry(
                    InterpretationKey(symbol.id),
                    meanings[symbol.id],
                    (_keyword(symbol.id),),
                    source,
                )
                for symbol in symbols
            ),
        )

    return InterpretationRegistry(build_all(anchor, dataset, _build))

reversible_registry 

reversible_registry(anchor: str, dataset: str, dataset_id: str, symbols: Sequence[Symbol], source: str) -> InterpretationRegistry

Registry of upright/reversed datasets across all bundle locales.

Source code in src/fortune_telling_core/_symbol_interpretation.py 
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
def reversible_registry(
    anchor: str,
    dataset: str,
    dataset_id: str,
    symbols: Sequence[Symbol],
    source: str,
) -> InterpretationRegistry:
    """Registry of upright/reversed datasets across all bundle locales."""

    def _build(locale: str, bundle: LocaleBundle) -> MappingInterpretationData:
        upright = bundle.group("upright")
        reversed_text = bundle.group("reversed")
        entries: list[InterpretationEntry] = []
        for symbol in symbols:
            for variant in (None, "upright"):
                entries.append(
                    InterpretationEntry(
                        InterpretationKey(symbol.id, variant=variant),
                        upright[symbol.id],
                        (_keyword(symbol.id),),
                        source,
                    )
                )
            entries.append(
                InterpretationEntry(
                    InterpretationKey(symbol.id, variant="reversed"),
                    reversed_text[symbol.id],
                    (_keyword(symbol.id), "reversed"),
                    source,
                )
            )
        return MappingInterpretationData(id=f"{dataset_id}.{locale}.v1", entries=tuple(entries))

    return InterpretationRegistry(build_all(anchor, dataset, _build))