some-random-api 0.3.0

An asynchronous API wrapper for Some Random 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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use crate::{Hex, Requester};
use anyhow::{Error, Result};

pub struct CanvasFilterEndpoint(pub(crate) Requester);

impl<'a> CanvasFilterEndpoint {
    /// Blueify(?) your avatar
    pub async fn blue<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image("canvas/filter/blue", &[("avatar", avatar_url.to_string())])
            .await
    }

    /// Blurplify your avatar
    pub async fn blurple<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/blurple",
                &[("avatar", avatar_url.to_string())],
            )
            .await
    }

    /// Blurplify your avatar (using new Discord blurple)
    pub async fn blurple_2<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/blurple2",
                &[("avatar", avatar_url.to_string())],
            )
            .await
    }

    /// Brighten your avatar
    pub async fn brightness<T: ToString>(&self, avatar_url: T, brightness: u8) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/brightness",
                &[
                    ("avatar", avatar_url.to_string()),
                    ("brightness", brightness.min(100).to_string()),
                ],
            )
            .await
    }

    /// Tint your avatar to a certain color
    pub async fn color<T: ToString, U: TryInto<Hex>>(
        &self,
        avatar_url: T,
        hex: U,
    ) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/color",
                &[
                    ("avatar", avatar_url.to_string()),
                    (
                        "color",
                        hex.try_into()
                            .map_err(|_| Error::msg("Failed to parse hex string"))?
                            .hex,
                    ),
                ],
            )
            .await
    }

    /// Greenify(?) your avatar
    pub async fn green<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image("canvas/filter/green", &[("avatar", avatar_url.to_string())])
            .await
    }

    /// Greyscale your avatar
    pub async fn greyscale<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/greyscale",
                &[("avatar", avatar_url.to_string())],
            )
            .await
    }

    /// Invert and grayscale your avatar
    pub async fn invert_greyscale<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/invertgreyscale",
                &[("avatar", avatar_url.to_string())],
            )
            .await
    }

    /// Redify(?) your avatar
    pub async fn red<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image("canvas/filter/red", &[("avatar", avatar_url.to_string())])
            .await
    }

    /// Apply a sepia filter to your avatar
    pub async fn sepia<T: ToString>(&self, avatar_url: T) -> Result<Vec<u8>> {
        self.0
            .request_image("canvas/filter/sepia", &[("avatar", avatar_url.to_string())])
            .await
    }

    /// Apply threshold to your avatar
    pub async fn threshold<T: ToString>(&self, avatar_url: T, threshold: u8) -> Result<Vec<u8>> {
        self.0
            .request_image(
                "canvas/filter/threshold",
                &[
                    ("avatar", avatar_url.to_string()),
                    ("threshold", threshold.min(100).to_string()),
                ],
            )
            .await
    }
}