gflights 0.3.1

Unofficial async Rust client for the Google Flights web API — search flights, price graphs, and booking offers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

use anyhow::Result;
use chrono::NaiveDate;
use clap::Parser;
use gflights::parsers::common::{StopOptions, TravelClass, Travelers};
use gflights::requests::api::ApiClient;
use gflights::requests::config::Config;

use super::OutputFormat;

/// Arguments for the `dgrid` subcommand.
#[derive(Parser, Debug)]
pub struct DateGridArgs {
    /// Departure airport IATA code or city name.
    #[arg(long)]
    pub from: String,

    /// Destination airport IATA code or city name.
    #[arg(long)]
    pub to: String,

    /// First day of the outbound departure window (YYYY-MM-DD).
    #[arg(long)]
    pub dep_start: NaiveDate,

    /// Last day of the outbound departure window (YYYY-MM-DD).
    #[arg(long)]
    pub dep_end: NaiveDate,

    /// First day of the return window (YYYY-MM-DD).
    #[arg(long)]
    pub ret_start: NaiveDate,

    /// Last day of the return window (YYYY-MM-DD).
    #[arg(long)]
    pub ret_end: NaiveDate,

    /// Number of adult passengers.
    #[arg(long, default_value = "1")]
    pub adults: u32,

    /// Travel class.
    #[arg(long, default_value = "economy")]
    pub class: TravelClass,

    /// Stop filter.
    #[arg(long, default_value = "all")]
    pub stops: StopOptions,

    /// Output format.
    #[arg(long, default_value = "table")]
    pub format: OutputFormat,
}

pub async fn cmd_date_grid(args: DateGridArgs, client: &ApiClient) -> Result<()> {
    let travelers = Travelers::new(vec![args.adults as i32, 0, 0, 0])?;

    let config = Config::builder()
        .departure(&args.from, client)
        .await?
        .destination(&args.to, client)
        .await?
        // Use dep_start as the nominal departing date (required by Config).
        .departing_date(args.dep_start)
        .return_date(args.ret_end)
        .travelers(travelers)
        .travel_class(args.class)
        .stop_options(args.stops)
        .build()?;

    let grid = client
        .request_date_grid(
            &config,
            args.dep_start,
            args.dep_end,
            args.ret_start,
            args.ret_end,
        )
        .await?;

    if grid.entries.is_empty() {
        eprintln!("No price data found for the requested date windows.");
        return Ok(());
    }

    match args.format {
        OutputFormat::Json => {
            println!("{}", serde_json::to_string_pretty(&grid)?);
        }
        OutputFormat::Table => {
            print!("{grid}");
            if let Some(c) = grid.cheapest() {
                println!(
                    "\nCheapest: {} → {} at {}",
                    c.departure_date, c.return_date, c.price
                );
            }
        }
    }
    Ok(())
}