rustemon 2.2.0

Library wrapping the awesome PokeAPI
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

use async_trait::async_trait;
use reqwest::Url;
use serde::de::DeserializeOwned;

use crate::{
    client::RustemonClient,
    error::Error,
    model::resource::{ApiResource, NamedApiResource},
};

/// Trait representing types that can be followed to ease navigation through the API.
#[async_trait]
pub trait Follow<T>
where
    T: DeserializeOwned + Send + Sync,
{
    /// Returns the resource pointed by the [NamedApiResource]. Follows its inner URL and gives back the result.
    ///
    /// # Arguments
    ///
    /// `rustemon_client` - The [RustemonClient] to use to access the resource.
    async fn follow(&self, rustemon_client: &RustemonClient) -> Result<T, Error>;
}

async fn inner_follow<T: DeserializeOwned>(
    to_url: Option<&String>,
    rustemon_client: &RustemonClient,
) -> Result<T, Error> {
    match to_url {
        Some(url_str) => {
            let url = Url::parse(url_str).unwrap();
            rustemon_client.get_by_url::<T>(url).await
        }
        None => Err(Error::FollowEmptyURL),
    }
}

#[async_trait]
impl<T> Follow<T> for NamedApiResource<T>
where
    T: DeserializeOwned + Send + Sync,
{
    async fn follow(&self, rustemon_client: &RustemonClient) -> Result<T, Error> {
        inner_follow(self.url.as_ref(), rustemon_client).await
    }
}

#[async_trait]
impl<T> Follow<T> for ApiResource<T>
where
    T: DeserializeOwned + Send + Sync,
{
    async fn follow(&self, rustemon_client: &RustemonClient) -> Result<T, Error> {
        inner_follow(self.url.as_ref(), rustemon_client).await
    }
}