descord 0.1.11

A minimal discord api wrapper.
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

use super::*;

/// Get all roles in a guild
///
/// # Arguments
/// guild_id - The ID of the guild to get roles from
pub async fn fetch_roles(guild_id: &str) -> Result<Vec<Role>, Box<dyn std::error::Error>> {
    let url = format!("guilds/{guild_id}/roles");
    let resp = request(Method::GET, &url, None).await.text().await.unwrap();
    let roles: Vec<Role> = DeJson::deserialize_json(&resp).unwrap();

    for role in &roles {
        ROLE_CACHE.lock().await.put(role.id.clone(), role.clone());
    }

    Ok(roles)
}

/// Fetches a particular role in a guild
///
/// # Arguments
/// guild_id - The ID of the guild the role is in
/// role_id - The ID of the role to get
pub async fn fetch_role(guild_id: &str, role_id: &str) -> Result<Role, Box<dyn std::error::Error>> {
    if let Some(role) = ROLE_CACHE.lock().await.get(role_id).cloned() {
        info!("Role cache hit");
        return Ok(role);
    }
    let url = format!("guilds/{guild_id}/roles");
    let resp = request(Method::GET, &url, None).await.text().await.unwrap();
    let roles: Vec<Role> = DeJson::deserialize_json(&resp).unwrap();
    let mut answer = None;
    for role in &roles {
        ROLE_CACHE.lock().await.put(role.id.clone(), role.clone());
        if role.id == role_id {
            answer = Some(role.clone());
        }
    }
    if let Some(answer) = answer {
        Ok(answer)
    } else {
        Err("Role not found".into())
    }
}

/// Delete a role in a guild
///
/// # Arguments
/// guild_id - The ID of the guild the role is in
/// role_id - The ID of the role to delete
pub async fn delete_role(guild_id: &str, role_id: &str) -> Result<(), Box<dyn std::error::Error>> {
    let url = format!("guilds/{guild_id}/roles/{role_id}");
    request(Method::DELETE, &url, None).await.text().await?;
    ROLE_CACHE.lock().await.pop_entry(role_id);
    Ok(())
}

/// Edit a role in a guild
///
/// # Arguments
/// guild_id - The ID of the guild the role is in
/// role_id - The ID of the role to edit
/// position - The new position of the role
///
/// # Role position
/// Roles are sorted in descending order of position,
/// with the highest role having the lowest position.
/// Zero being the lowest position.
pub async fn edit_role_position(
    guild_id: &str,
    role_id: &str,
    position: i32,
) -> Result<Role, Box<dyn std::error::Error>> {
    let url = format!("guilds/{guild_id}/roles/{role_id}");
    let body = object! { "position": position };
    let resp = request(Method::PATCH, &url, Some(body))
        .await
        .text()
        .await
        .unwrap();
    let role: Role = DeJson::deserialize_json(&resp).unwrap();
    ROLE_CACHE.lock().await.put(role.id.clone(), role.clone());
    Ok(role)
}

/// Create a new role in a guild
///
/// # Arguments
/// `guild_id` - The ID of the guild to create the role in
/// `name` - The name of the role
/// `permissions` - The bitwise value of permissions
/// `color` - The color of the role
/// `hoist` - Whether the role should be displayed separately in the sidebar
/// `mentionable` - Whether the role should be mentionable
pub async fn create_role(
    guild_id: &str,
    name: &str,
    permissions: i32,
    color: crate::color::Color,
    hoist: bool,
    mentionable: bool,
) -> Result<Role, Box<dyn std::error::Error>> {
    let url = format!("guilds/{guild_id}/roles");

    let color: u32 = color.into();
    let body = object! {
        "name": name,
        "permissions": permissions,
        "color": color,
        "hoist": hoist,
        "mentionable": mentionable,
    };
    let resp = request(Method::POST, &url, Some(body))
        .await
        .text()
        .await
        .unwrap();
    let role: Role = DeJson::deserialize_json(&resp).unwrap();
    ROLE_CACHE.lock().await.put(role.id.clone(), role.clone());
    Ok(role)
}

pub async fn add_role(
    guild_id: &str,
    user_id: &str,
    role_id: &str,
) -> Result<(), Box<dyn std::error::Error>> {
    let url = format!("guilds/{guild_id}/members/{user_id}/roles/{role_id}");
    let resp = request(Method::PUT, &url, None).await.error_for_status()?;
    Ok(())
}

pub async fn remove_role(
    guild_id: &str,
    user_id: &str,
    role_id: &str,
) -> Result<(), Box<dyn std::error::Error>> {
    let url = format!("guilds/{guild_id}/members/{user_id}/roles/{role_id}");
    let resp = request(Method::DELETE, &url, None)
        .await
        .error_for_status()?;
    Ok(())
}