botrs 0.10.0

A Rust QQ Bot framework based on QQ Guild Bot 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

//! Botgo-compatible OpenAPI request options.

#![allow(non_snake_case)]

/// Concrete OpenAPI options after applying option functions.
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct Options {
    /// Replaces the default endpoint URL for message APIs.
    pub url: std::option::Option<String>,
    /// Adds `hidetip=true` to retract message APIs.
    pub hide_tip: bool,
}

/// Botgo-compatible option value.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum OpenApiOption {
    Url(String),
    HideTip,
}

/// Botgo-compatible option alias.
pub type Option = OpenApiOption;

impl Options {
    pub fn apply(&mut self, option: OpenApiOption) {
        match option {
            OpenApiOption::Url(url) => self.url = Some(url),
            OpenApiOption::HideTip => self.hide_tip = true,
        }
    }

    pub fn from_options<I, O>(options: I) -> Self
    where
        I: IntoIterator<Item = O>,
        O: Into<OpenApiOption>,
    {
        options
            .into_iter()
            .fold(Self::default(), |mut opts, option| {
                opts.apply(option.into());
                opts
            })
    }
}

impl From<&OpenApiOption> for OpenApiOption {
    fn from(option: &OpenApiOption) -> Self {
        option.clone()
    }
}

/// Replaces the default send URL.
pub fn WithURL(url: impl Into<String>) -> OpenApiOption {
    OpenApiOption::Url(url.into())
}

/// Hides the retract-message tip.
pub fn WithHideTip() -> OpenApiOption {
    OpenApiOption::HideTip
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn options_match_botgo_builders() {
        let opts = Options::from_options([WithURL("https://example.com"), WithHideTip()]);
        assert_eq!(opts.url.as_deref(), Some("https://example.com"));
        assert!(opts.hide_tip);
    }
}