Skip to content

armgit / fli

Public Imported from GitHub
0

Google Flights MCP, CLI and Python Library

5.2 KB
Raw Blame
"""Capture live GetShoppingResults / GetCalendarGraph responses for snapshot tests.

Usage::

    uv run python scripts/capture_fixtures.py [--out-dir tests/search/fixtures]

The script hits Google's live API with each scenario defined in ``SCENARIOS``
below and writes the raw response body to a binary fixture. Snapshot tests
in ``tests/search/test_snapshot_fixtures.py`` replay these bodies through
the same parser used by ``SearchFlights.search`` — so updating the
fixtures (re-running this script after Google changes anything) keeps the
offline tests in sync with reality.

When you add a new scenario, also add a corresponding fixture in
``test_snapshot_fixtures.py``.
"""

from __future__ import annotations

import argparse
from collections.abc import Callable
from datetime import datetime, timedelta
from pathlib import Path

from fli.models import (
    Airline,
    Airport,
    Alliance,
    FlightSearchFilters,
    FlightSegment,
    LayoverRestrictions,
    MaxStops,
    PassengerInfo,
    SeatType,
    SortBy,
    TripType,
)
from fli.search import SearchFlights
from fli.search._urls import with_locale_params
from fli.search.client import get_client


def _future(days: int) -> str:
    return (datetime.now() + timedelta(days=days)).strftime("%Y-%m-%d")


def _seg(dep: Airport, arr: Airport, days: int = 45) -> list[FlightSegment]:
    return [
        FlightSegment(
            departure_airport=[[dep, 0]],
            arrival_airport=[[arr, 0]],
            travel_date=_future(days),
        )
    ]


# Each scenario: name → (filters factory, currency).
SCENARIOS: dict[str, tuple[Callable[[], FlightSearchFilters], str]] = {
    "flight_search_jfk_lax_oneway_usd": (
        lambda: FlightSearchFilters(
            passenger_info=PassengerInfo(adults=1),
            flight_segments=_seg(Airport.JFK, Airport.LAX),
            stops=MaxStops.NON_STOP,
        ),
        "USD",
    ),
    "flight_search_jfk_fra_oneworld": (
        lambda: FlightSearchFilters(
            passenger_info=PassengerInfo(adults=1),
            flight_segments=_seg(Airport.JFK, Airport.FRA),
            alliances=[Alliance.ONEWORLD],
        ),
        "USD",
    ),
    "flight_search_buf_ath_min_layover_120": (
        lambda: FlightSearchFilters(
            passenger_info=PassengerInfo(adults=1),
            flight_segments=_seg(Airport.BUF, Airport.ATH),
            layover_restrictions=LayoverRestrictions(min_duration=120),
        ),
        "USD",
    ),
    "flight_search_jfk_lax_exclude_dl": (
        lambda: FlightSearchFilters(
            passenger_info=PassengerInfo(adults=1),
            flight_segments=_seg(Airport.JFK, Airport.LAX),
            airlines_exclude=[Airline.DL],
        ),
        "USD",
    ),
    "flight_search_jfk_lax_eur": (
        lambda: FlightSearchFilters(
            passenger_info=PassengerInfo(adults=1),
            flight_segments=_seg(Airport.JFK, Airport.LAX),
            stops=MaxStops.NON_STOP,
        ),
        "EUR",
    ),
    # Issue #165 regression: premium-cabin RT with family pax. Google
    # returns rows with an empty price head; the parser must surface
    # them with ``price=None`` rather than dropping the whole batch.
    "flight_search_lax_lhr_rt_biz_2a1c": (
        lambda: FlightSearchFilters(
            trip_type=TripType.ROUND_TRIP,
            passenger_info=PassengerInfo(adults=2, children=1),
            flight_segments=[
                FlightSegment(
                    departure_airport=[[Airport.LAX, 0]],
                    arrival_airport=[[Airport.LHR, 0]],
                    travel_date=_future(45),
                ),
                FlightSegment(
                    departure_airport=[[Airport.LHR, 0]],
                    arrival_airport=[[Airport.LAX, 0]],
                    travel_date=_future(59),
                ),
            ],
            stops=MaxStops.ANY,
            seat_type=SeatType.BUSINESS,
            sort_by=SortBy.BEST,
            show_all_results=True,
        ),
        "USD",
    ),
}


def main() -> int:
    """CLI entry point — capture fixtures listed in ``SCENARIOS``."""
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument(
        "--out-dir",
        default="tests/search/fixtures",
        help="Directory to write fixture .bin files into",
    )
    parser.add_argument(
        "--scenario",
        action="append",
        help="Only capture this scenario (can be repeated). Default: all.",
    )
    args = parser.parse_args()

    out_dir = Path(args.out_dir)
    out_dir.mkdir(parents=True, exist_ok=True)
    client = get_client()

    selected = args.scenario or list(SCENARIOS)
    for name in selected:
        if name not in SCENARIOS:
            print(f"!! Unknown scenario: {name}")
            continue
        factory, currency = SCENARIOS[name]
        filters = factory()
        encoded = filters.encode()
        url = with_locale_params(SearchFlights.BASE_URL, currency, None, None)
        r = client.post(
            url=url,
            data=f"f.req={encoded}",
            impersonate="chrome",
            allow_redirects=True,
        )
        path = out_dir / f"{name}.bin"
        path.write_bytes(r.content)
        print(f"  {name}: {len(r.content)} bytes -> {path}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())