s2rs 0.6.15

An intuitive Rust -> Scratch API library
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180

use s2rs_derive::Forwarder;
use serde::Deserialize;
use crate::Api;
use super::utils::RequestBuilderUtils;
use crate::json;

#[derive(Debug, Deserialize, Clone)]
pub struct News {
    pub id: u64,
    #[serde( rename = "stamp" )]
    pub at: String,
    #[serde( rename = "headline" )]
    pub title: String,
    pub url: String,
    pub image: String,
    #[serde( rename = "copy" )]
    pub description: String,
}

// region: FrontPage
#[derive(Debug, Deserialize, Clone)]
pub struct FrontPage {
    #[serde( rename = "community_newest_projects" )]
    pub new_projects: Vec<FrontPageProject>,
    #[serde( rename = "community_featured_studios" )]
    pub featured_studios: Vec<FrontPageFeaturedStudio>,
    #[serde( rename = "community_featured_projects" )]
    pub featured_projects: Vec<FrontPageProject>,
    #[serde( rename = "curator_top_projects" )]
    pub curated_projects: Vec<FrontPageCuratedProject>,
    #[serde( rename = "community_most_remixed_projects" )]
    pub most_remixed_projects: Vec<FrontPageMostRemixedProject>,
    #[serde( rename = "community_most_loved_projects" )]
    pub most_loved_projects: Vec<FrontPageProject>,
    #[serde( rename = "scratch_design_studio" )]
    pub design_studio_projects: Vec<FrontPageDesignStudioProject>,
}

#[derive(Deserialize, Debug, Clone)]
pub struct FrontPageProject {
    pub thumbnail_url: String,
    pub title: String,
    #[serde( rename = "creator" )]
    pub author_name: String,
    pub id: u64,
    pub love_count: u32,
}

#[derive(Deserialize, Debug, Clone)]
pub struct FrontPageMostRemixedProject {
    pub id: u64,
    pub title: String,
    #[serde( rename = "remixers_count" )]
    pub remix_count: u32,
    pub love_count: u32,
    pub thumbnail_url: String,
    #[serde( rename = "creator" )]
    pub author_name: String,
}

#[derive(Deserialize, Debug, Clone)]
pub struct FrontPageDesignStudioProject {
    pub id: u64,
    #[serde( rename = "gallery_id" )]
    pub studio_id: u64,
    #[serde( rename = "gallery_title" )]
    pub studio_title: String,
    pub title: String,
    #[serde( rename = "remixers_count" )]
    pub remix_count: u32,
    pub love_count: u32,
    pub thumbnail_url: String,
    #[serde( rename = "creator" )]
    pub author_name: String,
}

#[derive(Deserialize, Debug, Clone)]
pub struct FrontPageCuratedProject {
    pub id: u64,
    pub title: String,
    pub love_count: u32,
    pub thumbnail_url: String,
    #[serde( rename = "creator" )]
    pub author_name: String,
    #[serde( rename = "curator_name" )]
    pub curated_by_name: String,
}

#[derive(Deserialize, Debug, Clone)]
pub struct FrontPageFeaturedStudio {
    pub id: u64,
    pub title: String,
    pub thumbnail_url: String,
}
// endregion: FrontPage

// region: Health
#[derive(Deserialize, Debug, Clone)]
pub struct Health {
    pub version: String,
    pub uptime: f32,
    pub load: Vec<f32>,
    pub sql: HealthSql,
    pub time_stamp: u64,
    pub cache: HealthCache,
}

#[derive(Deserialize, Debug, Clone)]
pub struct HealthCache {
    pub connected: bool,
    pub ready: bool
}

#[derive(Deserialize, Debug, Clone)]
pub struct HealthSql {
    pub main: HealthSqlItem,
    pub project_comments: HealthSqlItem,
    #[serde( rename = "gallery_comments" )]
    pub studio_comments: HealthSqlItem,
    #[serde( rename = "userprofile_comments" )]
    pub profile_comments: HealthSqlItem
}

#[derive(Deserialize, Debug, Clone)]
pub struct HealthSqlItem {
    pub primary: HealthSqlItemItem,
    pub replica: HealthSqlItemItem
}

#[derive(Deserialize, Debug, Clone)]
pub struct HealthSqlItemItem {
    pub ssl: bool,
    pub destroyed: bool,
    pub min: u32,
    pub max: u32,
    #[serde( rename = "numUsed" )]
    pub used_count: u32,
    #[serde( rename = "numFree" )]
    pub free_count: u32,
    #[serde( rename = "pendingAcquires" )]
    pub pending_acquires: u32,
    #[serde( rename = "pendingCreates" )]
    pub pending_creates: u32,
}
// endregion: Health

#[derive(Forwarder, Debug)]
pub enum GetProjectsCountError {
    #[forward] Expected(json::ExpectedError),
    #[forward(reqwest::Error)]
    This(super::Error)
}

impl Api {
    pub async fn front_page(&self) -> super::Result<FrontPage> {
        let response = self.get_proxy("featured/").send_success().await?;
        Ok(response.json().await?)
    }

    pub async fn news(&self) -> super::Result<Vec<News>> {
        let response = self.get("news").send_success().await?;
        Ok(response.json().await?)
    }

    pub async fn projects_count(&self) -> Result<u64, GetProjectsCountError> {
        let response = self.get("projects/count/all/").send_success().await?;
        let data: json::Parser = response.json().await?;
        Ok(data.i("count").u64()?)
    }

    pub async fn clear_messages(&self) -> super::Result<()> {
        let _ = self.post_site_api("messages/messages-clear/").send_success().await?;
        Ok(())
    }

    pub async fn health(&self) -> super::Result<Health> {
        let response = self.get("health/").send_success().await?;
        Ok(response.json().await?)
    }
}