Ë è?&j-ãóX—dZddlmZdZd d„Zd d„Zdd„Zdd„Zdd„Zdd „Z dd „Z dd „Z y )u# services/country_utils.py ========================= Country normalization utilities — public API layer over the in-memory country snapshot. All ORM access has been removed from this module. Lookups are now pure dictionary operations against the snapshot loaded at Django startup by ServicesConfig.ready(). Public API (unchanged — backward compatible) -------------------------------------------- resolve_istat_country_code(value) → ISO3 canonical code or None normalize_country(value) → ISO2 code or raw fallback (ISTAT pipeline) is_iso2_country(value) → bool country_name_from_iso2(value) → display name or None normalize_country_fields(payload) → dict with ISO2-normalized country fields clear_country_cache() → no-op kept for call-site compatibility IstatCountry schema (production) --------------------------------- code — primary key VARCHAR(9), ISO3 alpha (e.g. "USA", "ITA") iso_code — VARCHAR(3), ISO2 (e.g. "US", "IT") or ISO3 when no ISO2 name — display name (e.g. "United States", "Italy") Normalization contract for Alloggiati -------------------------------------- resolve_istat_country_code() returns IstatCountry.code (ISO3). normalize_country() returns ISO2 for backward compat with ISTAT pipeline. é)Ú annotations)Úcountry_of_birthÚdocument_issuing_countryÚ nationalityÚcountrycóX—t|xsd«j«j«S©NÚ)ÚstrÚstripÚlower©Úvalues ú"/backend/services/country_utils.pyÚ_normalize_keyr.s#€Ü ˆuŠ{˜Ó × !Ñ !Ó #× )Ñ )Ó +Ð+ócó<—t|xsd«j«Sr )r r rs rÚ _clean_valuer2s€Ü ˆuŠ{˜Ó × !Ñ !Ó #Ð#rcó—y)z½ No-op kept for call-site compatibility. The snapshot is now managed by services.country_snapshot. Use reset_country_snapshot() + load_country_snapshot() in tests instead. N©rrrÚclear_country_cacher:srcót—t|«j«}t|«dk(xr|j«S)z:Return True if value looks like a 2-letter ISO alpha code.é)rÚupperÚlenÚisalpha)rÚraws rÚis_iso2_countryrCs.€ä uÓ × #Ñ #Ó %€CÜ ˆs‹8q‰=Ò *˜SŸ[™[›]Ð*rcó*—ddlm}||«}|r|SdS)uò Resolve any country representation to IstatCountry.code (canonical ISO3). Delegates to the in-memory snapshot — zero ORM, O(1). Resolution order: 1. Empty / None → None 2. Exact match on code (ISO3) → return code ("USA" → "USA") 3. Match on iso_code (ISO2) → return code ("US" → "USA") 4. Match on country name → return code ("Italy" → "ITA") 5. No match → None Returns None (not "") to preserve the existing contract for callers that check `if resolve_istat_country_code(x):`. Args: value: Any country representation. Returns: IstatCountry.code string if resolved, otherwise None. Never raises. r)Úresolve_istat_country_codeN)Úservices.country_snapshotr )rÚ _snap_resolveÚresults rr r Is€õ.Vá ˜5Ó !€FÙˆ6Ð% Ð%rcó—ddlm}m}m}m}m}m}t|«}|sy|s|d«‚|j«}t|«r|S||vr(||} |j| j««} | r| St|«} | |vr|| S|S)u Normalize a country value to ISO2 for backward compatibility. Used by the ISTAT export pipeline and other existing callers. NOT used by the Alloggiati transformer (which calls resolve_istat_country_code). Returns ISO2 code if resolvable, otherwise the original stripped value (preserving existing behavior for callers that rely on the passthrough). Raises SnapshotNotLoadedError if the snapshot was not loaded at startup. This is intentional fail-fast behavior — no lazy loading. r)Ú ISO2_TO_CODEÚ ISO3_TO_CODEÚ CODE_TO_ISO2Ú NAME_TO_ISO2Ú_snapshot_loadedÚSnapshotNotLoadedErrorNzkCountry snapshot has not been loaded. ServicesConfig.ready() must run before normalize_country() is called.) r!r%r&r'r(r)r*rrrÚgetr) rr%r&r'r(r)r*Ú raw_valueÚ upper_valueÚ canonicalÚiso2Úname_keys rÚnormalize_countryr1fs®€÷÷ô˜UÓ#€IÙ Øñ Ù$ð Tó ð ð —/‘/Ó#€Kô{Ô#ØÐðlÑ"Ø  Ñ-ˆ Ø×Ñ  §¡Ó 1Ó2ˆÙ ؈Kô˜iÓ(€HØ<ÑؘHÑ%Ð%ð Ðrcó —ddlm}m}m}m}t |«}|r t |«sy|s|d«‚|j«}|j|«}|s|S|j«D]\}} | |k(sŒ |j«cS|S)z’Return the display name for an ISO2 code, or None if not found. Raises SnapshotNotLoadedError if the snapshot was not loaded at startup. r)r%Ú NAME_TO_CODEr)r*NzpCountry snapshot has not been loaded. ServicesConfig.ready() must run before country_name_from_iso2() is called.) r!r%r3r)r*r1rrr+ÚitemsÚtitle) rr%r3r)r*Ú normalizedÚ iso2_upperr.ÚnameÚcodes rÚcountry_name_from_iso2r:s›€÷ óô# 5Ó)€JÙ œ_¨ZÔ8Øñ Ù$ð Yó ð ð×!Ñ!Ó#€JØ× Ñ  Ó,€IÙ ØÐð#×(Ñ(Ö*‰ ˆˆdØ 9Ó Ø—:‘:“<Ò ð+ð Ðrcó¤—t|t«siS|j«}tD]$}||vsŒt |j |««||<Œ&|S)zh Normalize all country fields in a payload dict to ISO2. Used by the ISTAT export pipeline. )Ú isinstanceÚdictÚcopyÚCOUNTRY_FIELD_NAMESr1r+)Úpayloadr6Ú field_names rÚnormalize_country_fieldsrBÄsP€ô gœtÔ $؈ à—‘“€Jß)ˆ Ø ˜Ò #Ü%6°z·~±~ÀjÓ7QÓ%RˆJzÒ "ð*ð ÐrN)rú str | NoneÚreturnr )rDÚNone)rrCrDÚbool)rrCrDrC)r@z dict | NonerDr=) Ú__doc__Ú __future__rr?rrrrr r1r:rBrrrÚrIsAðñõ>#ðÐó,ó$óó+ó &ó:4ón$ôN r