ruvolt 0.5.0

An API wrapper for Revolt written in Rust.
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

use serde::Serialize;

use crate::models::{
    events::{MemberField, ServerField},
    Category, Id, SystemMessageChannels,
};

/// Builder for edit a server.
#[derive(Debug, Clone, Default, Serialize)]
pub struct EditServer {
    #[serde(skip_serializing_if = "Option::is_none")]
    name: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    description: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    icon: Option<Id>,
    #[serde(skip_serializing_if = "Option::is_none")]
    banner: Option<Id>,
    #[serde(skip_serializing_if = "Vec::is_empty")]
    categories: Vec<Category>,
    #[serde(skip_serializing_if = "Option::is_none")]
    system_messages: Option<SystemMessageChannels>,
    #[serde(skip_serializing_if = "Option::is_none")]
    nsfw: Option<bool>,
    #[serde(skip_serializing_if = "Option::is_none")]
    remove: Option<ServerField>,
}

impl EditServer {
    /// Creates a new builder.
    pub fn new() -> Self {
        Self::default()
    }

    /// Set the name.
    pub fn name(mut self, name: impl Into<String>) -> Self {
        self.name = Some(name.into());
        self
    }

    /// Set the description.
    pub fn description(mut self, description: impl Into<String>) -> Self {
        self.description = Some(description.into());
        self
    }

    /// Set the icon.
    pub fn icon(mut self, id: &Id) -> Self {
        self.icon = Some(id.clone());
        self
    }

    /// Set the banner.
    pub fn banner(mut self, id: &Id) -> Self {
        self.banner = Some(id.clone());
        self
    }

    /// Add a category.
    pub fn category(mut self, category: &Category) -> Self {
        self.categories.push(category.clone());
        self
    }

    /// Set the system message channels.
    pub fn system_messages(
        mut self,
        build: impl Fn(SystemMessageChannels) -> SystemMessageChannels,
    ) -> Self {
        self.system_messages = Some(build(SystemMessageChannels::default()));
        self
    }

    /// Set whether server is not safe for work.
    pub fn nsfw(mut self, nsfw: bool) -> Self {
        self.nsfw = Some(nsfw);
        self
    }

    /// Set a server field to remove.
    pub fn remove(mut self, field: ServerField) -> Self {
        self.remove = Some(field);
        self
    }
}

/// Builder for edit a member.
#[derive(Debug, Clone, Default, Serialize)]
pub struct EditMember {
    #[serde(skip_serializing_if = "Option::is_none")]
    nickname: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    avatar: Option<Id>,
    #[serde(skip_serializing_if = "Vec::is_empty")]
    roles: Vec<Id>,
    #[serde(skip_serializing_if = "Option::is_none")]
    remove: Option<MemberField>,
}

impl EditMember {
    /// Creates a new builder.
    pub fn new() -> Self {
        Self::default()
    }

    /// Set the nickname.
    pub fn nickname(mut self, nickname: impl Into<String>) -> Self {
        self.nickname = Some(nickname.into());
        self
    }

    /// Set the avatar.
    pub fn avatar(mut self, id: &Id) -> Self {
        self.avatar = Some(id.clone());
        self
    }

    /// Include a role.
    pub fn role(mut self, id: &Id) -> Self {
        self.roles.push(id.clone());
        self
    }

    /// Set a member field to remove.
    pub fn remove(mut self, field: MemberField) -> Self {
        self.remove = Some(field);
        self
    }
}