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

use async_trait::async_trait;
use reqwest::{Response, RequestBuilder, StatusCode};
// use serde::{de::DeserializeOwned, Serialize};
use crate::{cursor::Cursor, json};

#[async_trait]
pub trait ResponseUtils where Self: Sized {
    fn only_success(self) -> Result<Self, StatusCode>;
    // async fn json<'a, T: DeserializeOwned>(self) -> Result<T, super::Error>;
    async fn json_parser<T: json::Parsable, E: From<T::Error> + From<reqwest::Error>>(self) -> Result<T, E>;
    async fn json_parser_vec<T: json::Parsable, E: From<T::Error> + From<reqwest::Error>>(self) -> Result<Vec<T>, E>;
}

#[async_trait]
impl ResponseUtils for Response {
    fn only_success(self) -> Result<Self, StatusCode> {
        if self.status().is_success() {
            Ok(self)
        } else {
            Err(self.status())
        }
    }

    // async fn json<'a, T: DeserializeOwned>(self) -> Result<T, super::Error> {
    //     let text = self.text().await?;
    //     Ok(serde_json::from_str::<T>(&text)?)
    // }

    async fn json_parser<T: json::Parsable, E: From<T::Error> + From<reqwest::Error>>(self) -> Result<T, E> {
        Ok(T::parse(&self.json::<json::Parser>().await?)?)
    }

    async fn json_parser_vec<T: json::Parsable, E: From<T::Error> + From<reqwest::Error>>(self) -> Result<Vec<T>, E> {
        Ok(T::parse_vec(&self.json::<Vec<json::Parser>>().await?)?)
    }
}

#[async_trait]
pub trait RequestBuilderUtils where Self: Sized {
    async fn send_success(self) -> Result<Response, super::Error>;
    async fn project_send_success(self, id: u64) -> Result<Response, super::Error>;
    fn cursor(self, cursor: impl Into<Cursor>) -> Self;
    fn cursor_limited(self, cursor: impl Into<Cursor>, limit: usize) -> Self;
    // fn json<T: Serialize>(self, data: T) -> Result<Self, serde_json::Error>;
    fn project_referer(self, id: u64) -> Self;
}

#[async_trait]
impl RequestBuilderUtils for RequestBuilder {
    async fn send_success(self) -> Result<Response, super::Error> {
        let idk = self.send().await;
        Ok(idk?.only_success()?)
    }

    async fn project_send_success(self, id: u64) -> Result<Response, super::Error> {
        self.project_referer(id).send_success().await
    }

    fn project_referer(self, id: u64) -> Self {
        self.header("referer", format!("https://scratch.mit.edu/projects/{id}"))
    }

    fn cursor(self, cursor: impl Into<Cursor>) -> Self {
        let cursor: Cursor = cursor.into();
        self.query(&[
            ("limit", cursor.get_limit().map(|v| v.min(40))),
            ("offset", Some(cursor.start))
        ])
    }

    fn cursor_limited(self, cursor: impl Into<Cursor>, limit: usize) -> Self {
        let cursor: Cursor = cursor.into();
        self.query(&[
            ("limit", cursor.get_limit().map(|v| v.min(limit))),
            ("offset", Some(cursor.start))
        ])
    }

    // fn json<T: Serialize>(self, data: T) -> Result<Self, serde_json::Error> {
    //     Ok(
    //         self.header("Content-Type", "application/json")
    //         .body(serde_json::to_string(&data)?)
    //     )
    // }
}