wmata 7.1.0

wmata is a high level Rust interface to the Washington Metropolitan Area Transit Authority (WMATA) API
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

//! MetroBus Stop related structs and methods.
use crate::{
    bus::{client::responses, traits::NeedsStop},
    error::Error,
    requests::Fetch,
    Date,
};
use serde::{
    de::{Deserializer, Error as SerdeError},
    Deserialize,
};

#[derive(Debug)]
pub struct Stop(pub String);

impl Stop {
    pub fn new(stop: &str) -> Self {
        Stop(stop.to_string())
    }
}

impl Fetch for Stop {}

impl NeedsStop for Stop {}

// Overwriting NeedsStop methods
impl Stop {
    /// Next bus arrivals at this stop.
    /// [WMATA Documentation](https://developer.wmata.com/docs/services/5476365e031f590f38092508/operations/5476365e031f5909e4fe331d)
    ///
    /// # Examples
    /// ```
    /// use wmata::Stop;
    /// use tokio_test::block_on;
    ///
    /// let next_buses = block_on(async { Stop::new("1001195").next_buses("9e38c3eab34c4e6c990828002828f5ed").await });
    /// assert!(next_buses.is_ok());
    /// ```
    pub async fn next_buses(&self, api_key: &str) -> Result<responses::Predictions, Error> {
        <Self as NeedsStop>::next_buses(&self, self, api_key).await
    }

    /// Buses scheduled at this stop for an optional given date.
    /// [WMATA Documentation](https://developer.wmata.com/docs/services/54763629281d83086473f231/operations/5476362a281d830c946a3d6c?)
    ///
    /// # Date
    /// Omit date for current date
    ///
    /// # Examples
    /// ```
    /// use wmata::Stop;
    /// use tokio_test::block_on;
    ///
    /// let schedule = block_on(async { Stop::new("1001195").schedule(None, "9e38c3eab34c4e6c990828002828f5ed").await });
    ///
    /// assert!(schedule.is_ok());
    /// ```
    ///
    /// with date
    /// ```
    /// use wmata::{Stop, Date};
    /// use tokio_test::block_on;
    ///
    /// let stop = Stop::new("1001195");
    /// let schedule = block_on(async { stop.schedule(Some(Date::new(2019, 10, 2)), "9e38c3eab34c4e6c990828002828f5ed").await });
    /// assert!(schedule.is_ok());
    /// ```
    pub async fn schedule(
        &self,
        date: Option<Date>,
        api_key: &str,
    ) -> Result<responses::StopSchedule, Error> {
        self.stop_schedule(self, date, api_key).await
    }
}

impl<'de> Deserialize<'de> for Stop {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        let stop = String::deserialize(deserializer)?;

        if stop.as_str() == "" {
            return Err(SerdeError::custom("Stop isn't present"));
        }

        Ok(Stop::new(&stop))
    }
}

impl PartialEq for Stop {
    fn eq(&self, other: &Self) -> bool {
        self.0 == other.0
    }
}