salvo-cors 1.1.0

CORS support for salvo web server framework.
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

use salvo_core::http::HeaderValue;
use salvo_core::http::header::HeaderName;

use super::preflight_request_headers;

/// Holds configuration for how to set the [`Vary`][mdn] header.
///
/// See [`Cors::vary`] for more details.
///
/// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Vary
/// [`Cors::vary`]: super::Cors::vary
#[derive(Clone, Debug)]
pub struct Vary(Vec<HeaderValue>);

impl Vary {
    /// Set the list of header names to return as vary header values
    ///
    /// See [`Cors::vary`] for more details.
    ///
    /// [`Cors::vary`]: super::Cors::vary
    pub fn list<I>(headers: I) -> Self
    where
        I: IntoIterator<Item = HeaderName>,
    {
        Self(headers.into_iter().map(Into::into).collect())
    }

    pub(super) fn values(&self) -> impl Iterator<Item = HeaderValue> + '_ {
        self.0.iter().cloned()
    }
}

impl Default for Vary {
    fn default() -> Self {
        Self::list(preflight_request_headers())
    }
}

impl<const N: usize> From<[HeaderName; N]> for Vary {
    fn from(arr: [HeaderName; N]) -> Self {
        Self::list(arr)
    }
}

impl From<Vec<HeaderName>> for Vary {
    fn from(vec: Vec<HeaderName>) -> Self {
        Self::list(vec)
    }
}
#[cfg(test)]
mod tests {
    use salvo_core::http::header::{
        self, ACCESS_CONTROL_REQUEST_HEADERS, ACCESS_CONTROL_REQUEST_METHOD, HeaderValue, ORIGIN,
    };

    use super::{Vary, preflight_request_headers};

    #[test]
    fn test_default() {
        let vary = Vary::default();
        let headers: Vec<HeaderValue> = vary.values().collect();
        let expected: Vec<HeaderValue> = preflight_request_headers().map(Into::into).collect();
        assert_eq!(headers, expected);
    }

    #[test]
    fn test_list() {
        let vary = Vary::list(vec![header::ACCEPT, header::ACCEPT_LANGUAGE]);
        let headers: Vec<HeaderValue> = vary.values().collect();
        assert_eq!(
            headers,
            vec![
                HeaderValue::from_static("accept"),
                HeaderValue::from_static("accept-language")
            ]
        );
    }

    #[test]
    fn test_from_array() {
        let vary: Vary = [header::ACCEPT, header::ACCEPT_LANGUAGE].into();
        let headers: Vec<HeaderValue> = vary.values().collect();
        assert_eq!(
            headers,
            vec![
                HeaderValue::from_static("accept"),
                HeaderValue::from_static("accept-language")
            ]
        );
    }

    #[test]
    fn test_from_vec() {
        let vary: Vary = vec![header::ACCEPT, header::ACCEPT_LANGUAGE].into();
        let headers: Vec<HeaderValue> = vary.values().collect();
        assert_eq!(
            headers,
            vec![
                HeaderValue::from_static("accept"),
                HeaderValue::from_static("accept-language")
            ]
        );
    }

    #[test]
    fn test_preflight_request_headers() {
        let mut headers = preflight_request_headers();
        assert_eq!(headers.next(), Some(ORIGIN));
        assert_eq!(headers.next(), Some(ACCESS_CONTROL_REQUEST_METHOD));
        assert_eq!(headers.next(), Some(ACCESS_CONTROL_REQUEST_HEADERS));
        assert_eq!(headers.next(), None);
    }
}