thunderstore 0.4.0

A library for interacting with the Thunderstore 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

use url::Url;

use crate::{models::*, prelude::*, Result};

impl Client {
    /// Fetches a page of communities.
    ///
    /// Returns a [`CursorState`] which is used to navigate between pages by passing the
    /// fields in the `cursor` parameter.
    pub async fn get_communities(
        &self,
        cursor: Option<impl AsRef<str>>,
    ) -> Result<(CursorState, Vec<Community>)> {
        let mut url = self.url("/experimental/community");
        if let Some(cursor) = cursor {
            url.push_str(&format!("?cursor={}", cursor.as_ref()));
        }
        let response: PaginatedResponse<Community> = self.get_json(url).await?;
        Ok((response.pagination.into(), response.results))
    }

    /// Fetches a page of categories from the given community.
    ///
    /// Returns a [`CursorState`] which is used to navigate between pages by passing the
    /// fields in the `cursor` parameter.
    pub async fn get_categories(
        &self,
        community: impl AsRef<str>,
        cursor: Option<impl AsRef<str>>,
    ) -> Result<(CursorState, Vec<CommunityCategory>)> {
        let mut url = self.url(format_args!(
            "/experimental/community/{}",
            community.as_ref()
        ));
        if let Some(cursor) = cursor {
            url.push_str(&format!("?cursor={}", cursor.as_ref()));
        }
        let response: PaginatedResponse<CommunityCategory> = self.get_json(url).await?;
        Ok((response.pagination.into(), response.results))
    }
}

/// Returned by paginated endpoints and used to navigate between pages.
#[derive(Debug, Clone)]
pub struct CursorState {
    pub next: Option<String>,
    pub prev: Option<String>,
}

impl From<Pagination> for CursorState {
    fn from(value: Pagination) -> Self {
        return CursorState {
            next: map_url(value.next_link),
            prev: map_url(value.previous_link),
        };

        fn map_url(url: Option<Url>) -> Option<String> {
            url.and_then(|url| {
                url.query_pairs()
                    .find(|(key, _)| key == "cursor")
                    .map(|(_, value)| value.into_owned())
            })
        }
    }
}