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

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

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

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

/// A comment on an image.
#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Comment {
    pub author: String,
    pub avatar: String,
    pub body: String,
    pub created_at: String,
    pub edit_reason: ::serde_json::Value,
    pub edited_at: ::serde_json::Value,
    pub id: i64,
    pub image_id: i64,
    pub updated_at: String,
    pub user_id: Option<i64>,
}

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

    /// Search for comments.
    pub async fn comment_search<T: Into<String>>(
        &self,
        query: T,
        page: u64,
    ) -> Result<Vec<Comment>> {
        let mut req = self
            .request(reqwest::Method::GET, "api/v1/json/search/comments")
            .query(&[("q", query.into())]);

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

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

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

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

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

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

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