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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use serde::{Deserialize, Serialize};

use crate::api::params::permission::PermissionsOverwriteParams;

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

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

#[derive(Serialize, Deserialize, Debug, PartialEq, Clone)]
pub struct CategoryParams {
    pub name: String,
    #[serde(default = "Vec::default")]
    pub permissions_overwrites: Vec<PermissionsOverwriteParams>,
    #[serde(default = "CategoryParamsExtraChannelsStrategy::default")]
    pub extra_channels: CategoryParamsExtraChannelsStrategy,
}

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

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

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

#[cfg(test)]
mod tests {
    use crate::{
        api::params::{
            category::{
                CategoriesParamsList, CategoryParams, CategoryParamsExtraChannelsStrategy,
                CategoryParamsExtraItemsStrategy,
            },
            permission::PermissionsOverwriteParams,
        },
        permission::Permission,
    };

    #[test]
    fn it_parses_params_list() {
        let yaml_params_list = r"
            items:
            - name: category_1
              permissions_overwrites:
              - role: role_1
                allow: [ADMINISTRATOR]
                deny: [SEND_MESSAGES]
              extra_channels:
                strategy: KEEP
            extra_items:
              strategy: KEEP
        ";
        let expected_params_list = CategoriesParamsList {
            items: vec![CategoryParams {
                name: "category_1".to_string(),
                permissions_overwrites: vec![PermissionsOverwriteParams {
                    role: "role_1".to_string(),
                    allow: vec![Permission::ADMINISTRATOR],
                    deny: vec![Permission::SEND_MESSAGES],
                }],
                extra_channels: CategoryParamsExtraChannelsStrategy::Keep,
            }],
            extra_items: CategoryParamsExtraItemsStrategy::Keep,
        };

        let params_list: CategoriesParamsList = 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: CategoriesParamsList = serde_yaml::from_str(yaml_params_list).unwrap();

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

    #[test]
    fn it_parses_empty_params_fields_to_defaults() {
        let yaml_params_list = r"
            items:
            - name: category_1
        ";
        let expected_params_list = CategoriesParamsList {
            items: vec![CategoryParams {
                name: "category_1".to_string(),
                permissions_overwrites: vec![],
                extra_channels: CategoryParamsExtraChannelsStrategy::default(),
            }],
            extra_items: CategoryParamsExtraItemsStrategy::Keep,
        };

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

        assert_eq!(params_list, expected_params_list);
    }
}