headers_ext/common/
vary.rs

1use util::FlatCsv;
2
3use {HeaderValue};
4
5/// `Vary` header, defined in [RFC7231](https://tools.ietf.org/html/rfc7231#section-7.1.4)
6///
7/// The "Vary" header field in a response describes what parts of a
8/// request message, aside from the method, Host header field, and
9/// request target, might influence the origin server's process for
10/// selecting and representing this response.  The value consists of
11/// either a single asterisk ("*") or a list of header field names
12/// (case-insensitive).
13///
14/// # ABNF
15///
16/// ```text
17/// Vary = "*" / 1#field-name
18/// ```
19///
20/// # Example values
21///
22/// * `accept-encoding, accept-language`
23///
24/// # Example
25///
26/// ```
27/// # extern crate headers_ext as headers;
28/// use headers::Vary;
29///
30/// let vary = Vary::any();
31/// ```
32#[derive(Debug, Clone, PartialEq, Header)]
33pub struct Vary(FlatCsv);
34
35impl Vary {
36    /// Create a new `Very: *` header.
37    pub fn any() -> Vary {
38        Vary(HeaderValue::from_static("*").into())
39    }
40
41    /// Check if this includes `*`.
42    pub fn is_any(&self) -> bool {
43        self.0.iter().any(|val| val == "*")
44    }
45
46    /// Iterate the header names of this `Vary`.
47    pub fn iter_strs(&self) -> impl Iterator<Item = &str> {
48        self.0.iter()
49    }
50}
51
52/*
53test_vary {
54    test_header!(test1, vec![b"accept-encoding, accept-language"]);
55
56    #[test]
57    fn test2() {
58        let mut vary: ::Result<Vary>;
59
60        vary = Header::parse_header(&"*".into());
61        assert_eq!(vary.ok(), Some(Vary::Any));
62
63        vary = Header::parse_header(&"etag,cookie,allow".into());
64        assert_eq!(vary.ok(), Some(Vary::Items(vec!["eTag".parse().unwrap(),
65                                                    "cookIE".parse().unwrap(),
66                                                    "AlLOw".parse().unwrap(),])));
67    }
68}
69*/
70
71#[cfg(test)]
72mod tests {
73    use super::*;
74
75    #[test]
76    fn any_is_any() {
77        assert!(Vary::any().is_any());
78    }
79}
headers_ext/common/vary.rs

headers_ext/common/
vary.rs
