http_types/cache/cache_control/
mod.rs

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
//! HTTP `Cache-Control` headers.
//!
//! # Specifications
//!
//! - [RFC 8246: HTTP Immutable Responses](https://tools.ietf.org/html/rfc8246)
//! - [RFC 7234: Hypertext Transfer Protocol (HTTP/1.1): Caching](https://tools.ietf.org/html/rfc7234)
//! - [RFC 5861: HTTP Cache-Control Extensions for Stale Content](https://tools.ietf.org/html/rfc5861)

#[allow(clippy::module_inception)]
mod cache_control;
mod cache_directive;

pub use cache_control::CacheControl;
pub use cache_directive::CacheDirective;

#[cfg(test)]
mod test {
    use super::*;
    use crate::headers::{Headers, CACHE_CONTROL};

    #[test]
    fn smoke() -> crate::Result<()> {
        let mut entries = CacheControl::new();
        entries.push(CacheDirective::Immutable);
        entries.push(CacheDirective::NoStore);

        let mut headers = Headers::new();
        entries.apply(&mut headers);

        let entries = CacheControl::from_headers(headers)?.unwrap();
        let mut entries = entries.iter();
        assert_eq!(entries.next().unwrap(), &CacheDirective::Immutable);
        assert_eq!(entries.next().unwrap(), &CacheDirective::NoStore);
        Ok(())
    }

    #[test]
    fn ignore_unkonwn_directives() -> crate::Result<()> {
        let mut headers = Headers::new();
        headers.insert(CACHE_CONTROL, "barrel_roll");
        let entries = CacheControl::from_headers(headers)?.unwrap();
        let mut entries = entries.iter();
        assert!(entries.next().is_none());
        Ok(())
    }

    #[test]
    fn bad_request_on_parse_error() {
        let mut headers = Headers::new();
        headers.insert(CACHE_CONTROL, "min-fresh=0.9"); // floats are not supported
        let err = CacheControl::from_headers(headers).unwrap_err();
        assert_eq!(err.status(), 400);
    }
}