Regions

"""Region reference models for /regions endpoints."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass RegionsListRequest:    country: str | None = None    continent: str | None = None@dataclassclass RegionByCodeRequest:    code: str@dataclassclass RegionRecord:    id: int    code: str    local_code: str | None    name: str    continent: str | None    iso_country: str    wikipedia_link: str | None    keywords: str | None@dataclassclass RegionsResponse:    regions: list[RegionRecord]    total: int

import osimport timefrom dataclasses import dataclassimport requestsHEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}BASE = "https://data.skylinkapi.com/v3"CACHE: dict[str, tuple[dict, float]] = {}REGIONS_TTL = 86_400  # 24 h@dataclassclass RegionOption:    code: str    label: strdef fetch_regions(*, country: str) -> list[dict]:    country = country.upper()    key = f"regions:{country}"    cached = CACHE.get(key)    if cached and time.time() < cached[1]:        return cached[0]["regions"]    try:        r = requests.get(            f"{BASE}/regions",            headers=HEADERS,            params={"country": country},            timeout=(10, 15),        )    except requests.Timeout as exc:        raise RuntimeError(f"SkyLink timeout fetching regions for {country}") from exc    r.raise_for_status()    data = r.json()    CACHE[key] = (data, time.time() + REGIONS_TTL)    return data.get("regions", [])def get_region_by_code(code: str) -> dict | None:    code = code.upper()    try:        r = requests.get(f"{BASE}/regions/{code}", headers=HEADERS, timeout=(10, 15))    except requests.Timeout as exc:        raise RuntimeError(f"SkyLink timeout fetching region {code}") from exc    if r.status_code == 404:        return None    r.raise_for_status()    return r.json()def region_options(country: str) -> list[RegionOption]:    return [RegionOption(code=item["code"], label=item["name"]) for item in fetch_regions(country=country)]if __name__ == "__main__":    import json    ny = get_region_by_code("US-NY")    print(json.dumps(ny, indent=2, default=str))