Airports

"""Airport lookup response types - matches airports.mdx field tables."""from __future__ import annotationsfrom dataclasses import dataclass@dataclassclass AirportLookupRequest:    """Query input for GET /airports/search - provide icao or iata, not both."""    icao: str | None = None    iata: str | None = None@dataclassclass Runway:    id: int    airport_ident: str    length_ft: float | None    width_ft: float | None    surface: str | None    lighted: int | None    closed: int | None    le_ident: str | None    he_ident: str | None@dataclassclass Frequency:    id: int    type: str    description: str | None    frequency_mhz: float    airport_ref: int@dataclassclass Navaid:    ident: str    name: str    type: str    frequency_khz: int | None    latitude_deg: float    longitude_deg: float    associated_airport: str | None@dataclassclass CountryRef:    code: str    name: str@dataclassclass RegionRef:    code: str    name: str    iso_country: str@dataclassclass AirportDetail:    id: int    ident: str    type: str    name: str    latitude_deg: float    longitude_deg: float    elevation_ft: float | None    municipality: str | None    iso_country: str | None    icao_code: str | None    iata_code: str | None    scheduled_service: str | None    runways: list[Runway]    frequencies: list[Frequency]    navaids: list[Navaid]    country: CountryRef | None = None    region: RegionRef | None = None    search_code: str | None = None    search_type: str | None = None@dataclassclass AirportSummary:    """Shape returned by airport_summary() in the lookup example."""    icao: str | None    iata: str | None    name: str    municipality: str | None    country: str | None    latitude: float    longitude: float    elevation_ft: float | None    airport_type: str    longest_runway_ft: int | None

import osimport timefrom dataclasses import dataclassfrom typing import Literalimport requests# AirportSummary - helper return type. Full wire types are in the Client types section.AirportType = Literal[    "large_airport",    "medium_airport",    "small_airport",    "heliport",    "seaplane_base",    "closed",    "balloonport",]HEADERS = {    "x-api-key": os.getenv("SKYLINK_API_KEY", "YOUR_API_KEY")}BASE = "https://data.skylinkapi.com/v3"CACHE: dict[str, tuple[dict, float]] = {}AIRPORT_TTL = 86_400  # 24 h - OurAirports metadata changes slowly@dataclassclass AirportSummary:    icao: str | None    iata: str | None    name: str    municipality: str | None    country: str | None    latitude: float    longitude: float    elevation_ft: float | None    airport_type: str    longest_runway_ft: int | Nonedef fetch_airport(*, icao: str | None = None, iata: str | None = None) -> dict | None:    if bool(icao) == bool(iata):        raise ValueError("Provide exactly one of icao or iata")    code = icao or iata or ""    cache_key = f"airport:{icao or ''}:{iata or ''}"    cached = CACHE.get(cache_key)    if cached and time.time() < cached[1]:        return cached[0]    params: dict[str, str] = {}    if icao:        params["icao"] = icao    else:        params["iata"] = iata or ""    try:        r = requests.get(            f"{BASE}/airports/search",            headers=HEADERS,            params=params,            timeout=(10, 20),        )    except requests.Timeout as exc:        raise RuntimeError(f"SkyLink timeout fetching airport {code}") from exc    if r.status_code == 404:        return None    r.raise_for_status()    data = r.json()    CACHE[cache_key] = (data, time.time() + AIRPORT_TTL)    return datadef airport_summary(icao: str) -> AirportSummary | None:    airport = fetch_airport(icao=icao)    if not airport:        return None    runways = airport.get("runways") or []    longest = max((int(rw.get("length_ft") or 0) for rw in runways), default=0)    country = airport.get("country") or {}    return AirportSummary(        icao=airport.get("icao_code"),        iata=airport.get("iata_code"),        name=airport["name"],        municipality=airport.get("municipality"),        country=country.get("code") if isinstance(country, dict) else airport.get("iso_country"),        latitude=airport["latitude_deg"],        longitude=airport["longitude_deg"],        elevation_ft=airport.get("elevation_ft"),        airport_type=airport["type"],        longest_runway_ft=longest or None,    )if __name__ == "__main__":    import json    from dataclasses import asdict    summary = airport_summary("KJFK")    print(json.dumps(asdict(summary), indent=2) if summary else "Airport not found")