Countries

"""Country reference models for /countries endpoints."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass CountriesListRequest:    continent: str | None = None@dataclassclass CountryByCodeRequest:    code: str@dataclassclass CountryRecord:    id: int    code: str    name: str    continent: str | None    wikipedia_link: str | None    keywords: str | None@dataclassclass CountriesResponse:    countries: list[CountryRecord]    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]] = {}COUNTRIES_TTL = 86_400  # 24 h@dataclassclass CountryOption:    code: str    label: strdef fetch_countries(*, continent: str | None = None) -> list[dict]:    key = f"countries:{continent or 'all'}"    cached = CACHE.get(key)    if cached and time.time() < cached[1]:        return cached[0]["countries"]    params = {"continent": continent} if continent else None    try:        r = requests.get(f"{BASE}/countries", headers=HEADERS, params=params, timeout=(10, 15))    except requests.Timeout as exc:        raise RuntimeError("SkyLink timeout fetching countries") from exc    r.raise_for_status()    data = r.json()    CACHE[key] = (data, time.time() + COUNTRIES_TTL)    return data.get("countries", [])def get_country_by_code(code: str) -> dict | None:    code = code.upper()    try:        r = requests.get(f"{BASE}/countries/{code}", headers=HEADERS, timeout=(10, 15))    except requests.Timeout as exc:        raise RuntimeError(f"SkyLink timeout fetching country {code}") from exc    if r.status_code == 404:        return None    r.raise_for_status()    return r.json()def country_options(continent: str | None = None) -> list[CountryOption]:    items = fetch_countries(continent=continent)    return [CountryOption(code=item["code"], label=item["name"]) for item in items]if __name__ == "__main__":    import json    us = get_country_by_code("US")    print(json.dumps(us, indent=2, default=str))