disma 0.16.4

Discord server management has never been easier!
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

use serde::{Deserialize, Serialize};

use crate::permission::Permission;

#[derive(Serialize, Deserialize, Debug, PartialEq, Default, Clone)]
pub struct RolesParamsList {
    #[serde(default = "Vec::default")]
    pub items: Vec<RoleParams>,
    #[serde(default = "RoleParamsExtraItemsStrategy::default")]
    pub extra_items: RoleParamsExtraItemsStrategy,
}

#[derive(Serialize, Deserialize, Debug, PartialEq, Clone)]
#[serde(tag = "strategy", rename_all = "SCREAMING_SNAKE_CASE")]
pub enum RoleParamsExtraItemsStrategy {
    Keep,
    Remove,
}

#[derive(Serialize, Deserialize, Debug, PartialEq, Clone)]
pub struct RoleParams {
    pub name: String,
    #[serde(default = "Vec::default")]
    pub permissions: Vec<Permission>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub color: Option<String>,
    pub show_in_sidebar: bool,
    pub is_mentionable: bool,
}

impl Default for RoleParamsExtraItemsStrategy {
    fn default() -> Self {
        Self::Keep
    }
}

#[cfg(test)]
mod tests {
    use crate::{
        api::params::role::{RoleParams, RoleParamsExtraItemsStrategy, RolesParamsList},
        permission::Permission,
    };

    #[test]
    fn it_parses_params_list() {
        let yaml_params_list = r"
            items:
            - name: role_1
              color: 29a1f4
              permissions:
              - ADMINISTRATOR
              - SEND_MESSAGES
              show_in_sidebar: true
              is_mentionable: false
            extra_items:
              strategy: KEEP
        ";
        let expected_params_list = RolesParamsList {
            items: vec![RoleParams {
                name: "role_1".to_string(),
                permissions: vec![Permission::ADMINISTRATOR, Permission::SEND_MESSAGES],
                color: Some("29a1f4".to_string()),
                show_in_sidebar: true,
                is_mentionable: false,
            }],
            extra_items: RoleParamsExtraItemsStrategy::Keep,
        };

        let params_list: RolesParamsList = serde_yaml::from_str(yaml_params_list).unwrap();

        assert_eq!(params_list, expected_params_list);
    }

    #[test]
    fn it_parses_empty_params_list_to_defaults() {
        let yaml_params_list = r"";

        let params_list: RolesParamsList = serde_yaml::from_str(yaml_params_list).unwrap();

        assert_eq!(params_list, RolesParamsList::default());
    }

    #[test]
    fn it_parses_empty_params_fields_to_defaults() {
        let yaml_params_list = r"
            items:
            - name: role_1
              show_in_sidebar: true
              is_mentionable: false
        ";
        let expected_params_list = RolesParamsList {
            items: vec![RoleParams {
                name: "role_1".to_string(),
                permissions: vec![],
                color: None,
                show_in_sidebar: true,
                is_mentionable: false,
            }],
            extra_items: RoleParamsExtraItemsStrategy::Keep,
        };

        let params_list: RolesParamsList = serde_yaml::from_str(yaml_params_list).unwrap();

        assert_eq!(params_list, expected_params_list);
    }
}