furbooru 0.4.0

An async Furbooru/Derpibooru client for Rust
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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use crate::Result;
use serde::{Deserialize, Serialize};

#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub(crate) struct Response {
    pub filter: Filter,
}

#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub(crate) struct ResponseList {
    pub filters: Vec<Filter>,
}

/// An image filter.
#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Filter {
    pub description: String,
    pub hidden_complex: Option<String>,
    pub hidden_tag_ids: Vec<i64>,
    pub id: i64,
    pub name: String,
    pub public: bool,
    pub spoilered_complex: ::serde_json::Value,
    pub spoilered_tag_ids: Vec<i64>,
    pub system: bool,
    pub user_count: i64,
    pub user_id: ::serde_json::Value,
}

impl crate::Client {
    /// Fetch a filter by its ID.
    pub async fn filter(&self, id: u64) -> Result<Filter> {
        let resp: Response = self
            .request(reqwest::Method::GET, &format!("api/v1/json/filters/{}", id))
            .send()
            .await?
            .error_for_status()?
            .json()
            .await?;
        Ok(resp.filter)
    }

    /// Fetch the list of system filters.
    pub async fn system_filters(&self) -> Result<Vec<Filter>> {
        let resp: ResponseList = self
            .request(reqwest::Method::GET, "api/v1/json/filters/system")
            .send()
            .await?
            .error_for_status()?
            .json()
            .await?;

        Ok(resp.filters)
    }

    /// Fetch the list of user-level filters.
    pub async fn user_filters(&self, page: u64) -> Result<Vec<Filter>> {
        let mut req = self.request(reqwest::Method::GET, "api/v1/json/filters/user");

        if page != 0 {
            req = req.query(&[("page", format!("{}", page))])
        }

        let resp: ResponseList = req.send().await?.error_for_status()?.json().await?;

        Ok(resp.filters)
    }
}

#[cfg(test)]
mod tests {
    use httptest::{matchers::*, responders::*, Expectation, Server};

    #[tokio::test]
    async fn filter() {
        let _ = pretty_env_logger::try_init();
        let data: serde_json::Value =
            serde_json::from_slice(include_bytes!("../testdata/filter_1.json")).unwrap();
        let server = Server::run();
        server.expect(
            Expectation::matching(request::method_path("GET", "/api/v1/json/filters/1"))
                .respond_with(json_encoded(data)),
        );

        let cli =
            crate::Client::with_baseurl("test", "42069", &format!("{}", server.url("/"))).unwrap();
        cli.filter(1).await.unwrap();
    }

    #[tokio::test]
    async fn system_filters() {
        let _ = pretty_env_logger::try_init();
        let data: serde_json::Value =
            serde_json::from_slice(include_bytes!("../testdata/filters_system.json")).unwrap();
        let server = Server::run();
        server.expect(
            Expectation::matching(request::method_path("GET", "/api/v1/json/filters/system"))
                .respond_with(json_encoded(data)),
        );

        let cli =
            crate::Client::with_baseurl("test", "42069", &format!("{}", server.url("/"))).unwrap();
        cli.system_filters().await.unwrap();
    }

    #[tokio::test]
    async fn user_filters() {
        let _ = pretty_env_logger::try_init();
        let data: serde_json::Value =
            serde_json::from_slice(include_bytes!("../testdata/filters_system.json")).unwrap();
        let server = Server::run();
        server.expect(
            Expectation::matching(request::method_path("GET", "/api/v1/json/filters/user"))
                .respond_with(json_encoded(data)),
        );

        let cli =
            crate::Client::with_baseurl("test", "42069", &format!("{}", server.url("/"))).unwrap();
        cli.user_filters(0).await.unwrap();
    }
}