asoiaf-api 0.1.2

Rust wrapper for the api of ice and fire.
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

use self::pagination::Pagination;

pub mod filter;
pub mod pagination;
pub mod request;

/// Trait that is used to convert a struct to a url.
/// It is used to make requests to the API.
pub(crate) trait ToUrl {
    fn to_url(&self) -> String;
}

pub trait ToRequest {
    fn to_request(&self) -> String;
    fn update_pagination(&mut self, pagination: Pagination);
    fn next_page(&mut self);
}

/// Wrapper for the [`reqwest::Client`] struct that contains the token
/// and the actual url that is used to make the request.
/// It is used to make requests to the API.
///
/// There is a cache system in branch [`cache`](https:://github.com/Yag000/asoiaf-rs/tree/cache),
/// but as [since 2017](https://github.com/joakimskoog/AnApiOfIceAndFire/issues/130https://github.com/joakimskoog/AnApiOfIceAndFire/issues/130).
/// this feature is not supported by the API, it is not merged into master.
pub(crate) async fn get(request: &impl ToRequest) -> Result<String, reqwest::Error> {
    let request_string = request.to_request();

    let client = reqwest::Client::new();
    let response = client
        .get(format!(
            "https://www.anapioficeandfire.com/api/{}",
            request_string
        ))
        .send()
        .await?;

    let response = response.error_for_status()?;

    response.text().await
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::requester::request::BookRequest;

    #[tokio::test]
    async fn test_get() {
        let request = BookRequest::default();
        let response = get(&request).await;
        assert!(response.is_ok());
        assert!(!response.unwrap().is_empty());
    }
}