adapt 0.0.0-alpha0

Official wrapper around for the Adapt chat platform 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

macro_rules! endpoints {
    ($(
        $(#[$doc:meta])* $name:ident $(($($params:ident: $ty:ty),+))? = $method:ident $path:literal;
    )+) => {
        $(
            paste::paste! {
                pub const [<$name:snake:upper>]: __types::$name = __types::$name {
                    $($($params: None),+)?
                };
            }
        )+
        pub mod __types {
            $(
                $(#[$doc])*
                #[derive(Copy, Clone, Debug, Default, PartialEq, Eq)]
                pub struct $name { $($(pub(super) $params: Option<$ty>),+)? }

                $(
                    impl $name {
                        $(
                            #[inline]
                            #[must_use]
                            #[doc = concat!("Sets the `", stringify!($params), "` path parameter.")]
                            pub fn $params(mut self, $params: $ty) -> Self {
                                self.$params = Some($params);
                                self
                            }
                        )+
                    }
                )?

                impl super::Endpoint for $name {
                    const METHOD: reqwest::Method = reqwest::Method::$method;
                    const PATH: &'static str = $path;

                    #[inline]
                    fn path(&self) -> String {
                        format!($path, $($($params = self.$params.unwrap()),+)?)
                    }
                }
            )+
        }
    };
}

endpoints! {
    // Channels
    GetChannel(channel_id: u64) = GET "/channels/{channel_id}";
    EditChannel(channel_id: u64) = PATCH "/channels/{channel_id}";
    DeleteChannel(channel_id: u64) = DELETE "/channels/{channel_id}";
    GetGuildChannels(guild_id: u64) = GET "/guilds/{guild_id}/channels";
    CreateGuildChannel(guild_id: u64) = POST "/guilds/{guild_id}/channels";
    // Guilds
    GetAllGuilds = GET "/guilds";
    CreateGuild = POST "/guilds";
    GetGuild(guild_id: u64) = GET "/guilds/{guild_id}";
    EditGuild(guild_id: u64) = PATCH "/guilds/{guild_id}";
    DeleteGuild(guild_id: u64) = DELETE "/guilds/{guild_id}";
    // Roles
    GetGuildRoles(guild_id: u64) = GET "/guilds/{guild_id}/roles";
    CreateRole(guild_id: u64) = POST "/guilds/{guild_id}/roles";
    GetRole(guild_id: u64, role_id: u64) = GET "/guilds/{guild_id}/roles/{role_id}";
    EditRole(guild_id: u64, role_id: u64) = PATCH "/guilds/{guild_id}/roles/{role_id}";
    DeleteRole(guild_id: u64, role_id: u64) = DELETE "/guilds/{guild_id}/roles/{role_id}";
    // Auth
    Login = POST "/login";
    // Users
    CreateUser = POST "/users";
    GetAuthenticatedUser = GET "/users/me";
    EditUser = PATCH "/users/me";
    DeleteUser = DELETE "/users/me";
    GetUser(user_id: u64) = GET "/users/{user_id}";
}

/// Any REST endpoint.
pub trait Endpoint {
    /// The HTTP method of the endpoint.
    const METHOD: reqwest::Method;
    /// The unformatted path of the endpoint.
    const PATH: &'static str;

    /// Returns the formatted path of the endpoint as a string, excluding the base URL.
    fn path(&self) -> String;
}