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
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 reqwest::Method;

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

impl Client {
    /// Fetches an index of all the package wikis on Thunderstore.
    pub async fn get_wikis(&self) -> Result<WikisResponse> {
        self.get_json(self.url("/experimental/package/wikis")).await
    }

    /// Fetches the wiki of a specific package.
    pub async fn get_wiki(&self, package: impl IntoPackageIdent<'_>) -> Result<Wiki> {
        self.get_json(self.wiki_url(package)?).await
    }

    /// Creates a package wiki page.
    pub async fn create_wiki_page(
        &self,
        package: impl IntoPackageIdent<'_>,
        title: impl Into<String>,
        content: impl Into<String>,
    ) -> Result<WikiPage> {
        self.upsert_wiki_page(
            package,
            WikiPageUpsert {
                id: None,
                title: title.into(),
                content: content.into(),
            },
        )
        .await
    }

    /// Updates a package wiki page.
    pub async fn update_wiki_page(
        &self,
        package: impl IntoPackageIdent<'_>,
        id: impl Into<String>,
        title: impl Into<String>,
        content: impl Into<String>,
    ) -> Result<WikiPage> {
        self.upsert_wiki_page(
            package,
            WikiPageUpsert {
                id: Some(id.into()),
                title: title.into(),
                content: content.into(),
            },
        )
        .await
    }

    /// Upserts a package wiki page.
    ///
    /// If `upsert.id` is `None`, this creates a new page.
    /// Otherwise, an existing one is updated according to its `id`.
    pub async fn upsert_wiki_page(
        &self,
        package: impl IntoPackageIdent<'_>,
        upsert: WikiPageUpsert,
    ) -> Result<WikiPage> {
        let page = self
            .post_json(self.wiki_url(package)?, &upsert)
            .await?
            .json()
            .await?;
        Ok(page)
    }

    /// Deletes a package wiki page.
    pub async fn delete_wiki_page(
        &self,
        package: impl IntoPackageIdent<'_>,
        id: impl Into<String>,
    ) -> Result<()> {
        let body = serde_json::to_string(&WikiPageDelete { id: id.into() })?;
        self.request(
            Method::DELETE,
            self.wiki_url(package)?,
            Some(body.into()),
            None,
        )
        .await?;
        Ok(())
    }

    /// Fetches a package wiki page by its `id`.
    pub async fn get_wiki_page(&self, id: impl AsRef<str>) -> Result<WikiPage> {
        let url = self.url(format_args!("/experimental/wiki/page/{}", id.as_ref()));
        self.get_json(url).await
    }

    fn wiki_url<'a>(&self, package: impl IntoPackageIdent<'a>) -> Result<String> {
        Ok(self.url(format_args!(
            "/experimental/package/{}/wiki",
            package.into_id()?.path()
        )))
    }
}