Google Flights MCP, CLI and Python Library
docs: update advanced date search examples (#12)
Punit Arani1a63f0670c0f
diff --git a/docs/examples/advanced.md b/docs/examples/advanced.mdindex 430b648..c2ab6f9 100644--- a/docs/examples/advanced.md+++ b/docs/examples/advanced.md@@ -329,12 +329,13 @@ from fli.models import (from fli.search import SearchDatesfrom datetime import datetime, timedelta+def validate_dates(from_date: str, to_date: str, min_stay: int, max_stay: int):"""Validate date ranges for round trip searches."""start = datetime.strptime(from_date, "%Y-%m-%d").date()end = datetime.strptime(to_date, "%Y-%m-%d").date()today = datetime.now().date()-+if start <= today:raise ValueError("Start date must be in the future")if end <= start:@@ -348,19 +349,7 @@ def validate_dates(from_date: str, to_date: str, min_stay: int, max_stay: int):if min_stay > max_stay:raise ValueError("Minimum stay cannot be greater than maximum stay")-# Create flight segments for date search-segments = [- FlightSegment(- departure_airport=[[Airport.JFK, 0]],- arrival_airport=[[Airport.LAX, 0]],- time_restrictions=TimeRestrictions(- earliest_departure=9, # 9 AM- latest_departure=18, # 6 PM- )- )-]-# Validate and create filtersfrom_date = "2024-06-01"to_date = "2024-06-30"min_stay = 2@@ -368,44 +357,63 @@ max_stay = 4validate_dates(from_date, to_date, min_stay, max_stay)-filters = DateSearchFilters(- trip_type=TripType.ROUND_TRIP,- passenger_info=PassengerInfo(adults=1),- flight_segments=segments,- from_date=from_date,- to_date=to_date,- min_stay_days=min_stay,- max_stay_days=max_stay,- seat_type=SeatType.ECONOMY-)-+stay_lengths = range(min_stay, max_stay + 1)search = SearchDates()-results = search.search(filters)--# Process results with weekend filteringweekend_trips = []-for trip in results:- outbound = datetime.strptime(trip.outbound_date, "%Y-%m-%d")- return_date = datetime.strptime(trip.return_date, "%Y-%m-%d")-- # Check if outbound is on weekend (5 = Saturday, 6 = Sunday)- if outbound.weekday() >= 5:- stay_duration = (return_date - outbound).days- weekend_trips.append({- 'outbound': trip.outbound_date,- 'return': trip.return_date,- 'duration': stay_duration,- 'price': trip.total_price- })--# Sort by price-weekend_trips.sort(key=lambda x: x['price'])--# Display results++for duration in stay_lengths:+ outbound_date = from_date+ return_date = (+ datetime.strptime(outbound_date, "%Y-%m-%d") + timedelta(days=duration)+ ).strftime("%Y-%m-%d")++ flight_segments = [+ FlightSegment(+ departure_airport=[[Airport.JFK, 0]],+ arrival_airport=[[Airport.LAX, 0]],+ travel_date=outbound_date,+ time_restrictions=TimeRestrictions(+ earliest_departure=9, # 9 AM+ latest_departure=18, # 6 PM+ ),+ ),+ FlightSegment(+ departure_airport=[[Airport.LAX, 0]],+ arrival_airport=[[Airport.JFK, 0]],+ travel_date=return_date,+ ),+ ]++ filters = DateSearchFilters(+ trip_type=TripType.ROUND_TRIP,+ passenger_info=PassengerInfo(adults=1),+ flight_segments=flight_segments,+ from_date=from_date,+ to_date=to_date,+ duration=duration,+ seat_type=SeatType.ECONOMY,+ )++ results = search.search(filters)+ if not results:+ continue++ for trip in results:+ outbound, inbound = trip.date+ if outbound.weekday() >= 5: # Saturday = 5, Sunday = 6+ weekend_trips.append({+ "outbound": outbound.strftime("%Y-%m-%d"),+ "return": inbound.strftime("%Y-%m-%d"),+ "duration": duration,+ "price": trip.price,+ })++weekend_trips.sort(key=lambda x: x["price"])+for trip in weekend_trips:- print(f"\nWeekend Trip:")+ print("\nWeekend Trip:")print(f"Outbound: {trip['outbound']} (Weekend)")print(f"Return: {trip['return']}")print(f"Duration: {trip['duration']} days")- print(f"Total Price: ${trip['price']}")+ print(f"Total Price: ${trip['price']}")```diff --git a/examples/advanced_date_search_validation.py b/examples/advanced_date_search_validation.pyindex 620bd9e..11dd95f 100644--- a/examples/advanced_date_search_validation.py+++ b/examples/advanced_date_search_validation.py@@ -19,7 +19,7 @@ from fli.models import (from fli.search import SearchDates-def validate_dates(from_date: str, to_date: str, min_stay: int, max_stay: int):+def validate_dates(from_date: str, to_date: str, min_stay: int, max_stay: int) -> None:"""Validate date ranges for round trip searches."""start = datetime.strptime(from_date, "%Y-%m-%d").date()end = datetime.strptime(to_date, "%Y-%m-%d").date()@@ -42,24 +42,8 @@ def validate_dates(from_date: str, to_date: str, min_stay: int, max_stay: int):print(f"✓ Stay duration: {min_stay}-{max_stay} days")-def main():+def main() -> None:"""Demonstrate advanced date search with validation."""- # Create flight segments for date search- travel_date = (datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d")-- segments = [- FlightSegment(- departure_airport=[[Airport.JFK, 0]],- arrival_airport=[[Airport.LAX, 0]],- travel_date=travel_date,- time_restrictions=TimeRestrictions(- earliest_departure=9, # 9 AM- latest_departure=18, # 6 PM- ),- )- ]-- # Validate and create filtersfrom_date = (datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d")to_date = (datetime.now() + timedelta(days=60)).strftime("%Y-%m-%d")min_stay = 2@@ -67,53 +51,77 @@ def main():try:validate_dates(from_date, to_date, min_stay, max_stay)- except ValueError as e:- print(f"❌ Validation failed: {e}")+ except ValueError as exc:+ print(f"❌ Validation failed: {exc}")return- filters = DateSearchFilters(- trip_type=TripType.ONE_WAY,- passenger_info=PassengerInfo(adults=1),- flight_segments=segments,- from_date=from_date,- to_date=to_date,- min_stay_days=min_stay,- max_stay_days=max_stay,- seat_type=SeatType.ECONOMY,- )+ stay_lengths = range(min_stay, max_stay + 1)+ search = SearchDates()+ weekend_trips: list[dict[str, str | int | float]] = []print("\n🔍 Searching for round trip dates...")- search = SearchDates()- results = search.search(filters)+ for duration in stay_lengths:+ outbound_date = from_date+ return_date = (+ datetime.strptime(outbound_date, "%Y-%m-%d") + timedelta(days=duration)+ ).strftime("%Y-%m-%d")++ flight_segments = [+ FlightSegment(+ departure_airport=[[Airport.JFK, 0]],+ arrival_airport=[[Airport.LAX, 0]],+ travel_date=outbound_date,+ time_restrictions=TimeRestrictions(+ earliest_departure=9, # 9 AM+ latest_departure=18, # 6 PM+ ),+ ),+ FlightSegment(+ departure_airport=[[Airport.LAX, 0]],+ arrival_airport=[[Airport.JFK, 0]],+ travel_date=return_date,+ ),+ ]++ filters = DateSearchFilters(+ trip_type=TripType.ROUND_TRIP,+ passenger_info=PassengerInfo(adults=1),+ flight_segments=flight_segments,+ from_date=from_date,+ to_date=to_date,+ duration=duration,+ seat_type=SeatType.ECONOMY,+ )- if not results:- print("❌ No dates found matching criteria")+ results = search.search(filters)+ if not results:+ continue++ for trip in results:+ outbound, inbound = trip.date+ if outbound.weekday() >= 5: # Saturday = 5, Sunday = 6+ weekend_trips.append(+ {+ "outbound": outbound.strftime("%Y-%m-%d"),+ "return": inbound.strftime("%Y-%m-%d"),+ "stay_length": duration,+ "price": trip.price,+ }+ )++ if not weekend_trips:+ print("❌ No weekend trips found in the specified range")return- # Process results with weekend filtering- weekend_trips = []- for trip in results:- travel_date = trip.date[0] # Get the travel date from the date tuple-- # Check if travel date is on weekend (5 = Saturday, 6 = Sunday)- if travel_date.weekday() >= 5:- weekend_trips.append(- {- "date": travel_date.strftime("%Y-%m-%d"),- "day": travel_date.strftime("%A"),- "price": trip.price,- }- )-- # Sort by price- weekend_trips.sort(key=lambda x: x["price"])-- # Display results- print(f"\n✅ Found {len(weekend_trips)} weekend flights:")- for i, trip in enumerate(weekend_trips[:5], 1): # Show top 5- print(f"\n{i}. Weekend Flight:")- print(f" Date: {trip['date']} ({trip['day']})")- print(f" Price: ${trip['price']}")+ weekend_trips.sort(key=lambda trip: trip["price"])++ print(f"\n✅ Found {len(weekend_trips)} weekend flight combinations:")+ for index, trip in enumerate(weekend_trips[:5], 1): # Show top 5 options+ print(f"\n{index}. Weekend Trip:")+ print(f" Outbound: {trip['outbound']}")+ print(f" Return: {trip['return']}")+ print(f" Stay: {trip['stay_length']} days")+ print(f" Price: ${trip['price']}")if __name__ == "__main__":