rama_http_headers/common/
etag.rs

1use std::str::FromStr;
2
3use crate::util::EntityTag;
4
5/// `ETag` header, defined in [RFC7232](https://datatracker.ietf.org/doc/html/rfc7232#section-2.3)
6///
7/// The `ETag` header field in a response provides the current entity-tag
8/// for the selected representation, as determined at the conclusion of
9/// handling the request.  An entity-tag is an opaque validator for
10/// differentiating between multiple representations of the same
11/// resource, regardless of whether those multiple representations are
12/// due to resource state changes over time, content negotiation
13/// resulting in multiple representations being valid at the same time,
14/// or both.  An entity-tag consists of an opaque quoted string, possibly
15/// prefixed by a weakness indicator.
16///
17/// # ABNF
18///
19/// ```text
20/// ETag       = entity-tag
21/// ```
22///
23/// # Example values
24///
25/// * `"xyzzy"`
26/// * `W/"xyzzy"`
27/// * `""`
28///
29/// # Examples
30///
31/// ```
32/// let etag = "\"xyzzy\"".parse::<rama_http_headers::ETag>().unwrap();
33/// ```
34#[derive(Clone, Debug, PartialEq, Eq)]
35pub struct ETag(pub(super) EntityTag);
36
37derive_header! {
38    ETag(_),
39    name: ETAG
40}
41
42impl ETag {
43    #[cfg(test)]
44    pub(crate) fn from_static(src: &'static str) -> ETag {
45        ETag(EntityTag::from_static(src))
46    }
47}
48
49rama_utils::macros::error::static_str_error! {
50    #[doc = "etag is not valid"]
51    pub struct InvalidETag;
52}
53
54impl FromStr for ETag {
55    type Err = InvalidETag;
56    fn from_str(src: &str) -> Result<Self, Self::Err> {
57        let val = src.parse().map_err(|_| InvalidETag)?;
58
59        EntityTag::from_owned(val).map(ETag).ok_or(InvalidETag)
60    }
61}
62
63/*
64test_etag {
65    // From the RFC
66    test_header!(test1,
67        vec![b"\"xyzzy\""],
68        Some(ETag(EntityTag::new(false, "xyzzy".to_owned()))));
69    test_header!(test2,
70        vec![b"W/\"xyzzy\""],
71        Some(ETag(EntityTag::new(true, "xyzzy".to_owned()))));
72    test_header!(test3,
73        vec![b"\"\""],
74        Some(ETag(EntityTag::new(false, "".to_owned()))));
75    // Own tests
76    test_header!(test4,
77        vec![b"\"foobar\""],
78        Some(ETag(EntityTag::new(false, "foobar".to_owned()))));
79    test_header!(test5,
80        vec![b"\"\""],
81        Some(ETag(EntityTag::new(false, "".to_owned()))));
82    test_header!(test6,
83        vec![b"W/\"weak-etag\""],
84        Some(ETag(EntityTag::new(true, "weak-etag".to_owned()))));
85    test_header!(test7,
86        vec![b"W/\"\x65\x62\""],
87        Some(ETag(EntityTag::new(true, "\u{0065}\u{0062}".to_owned()))));
88    test_header!(test8,
89        vec![b"W/\"\""],
90        Some(ETag(EntityTag::new(true, "".to_owned()))));
91    test_header!(test9,
92        vec![b"no-dquotes"],
93        None::<ETag>);
94    test_header!(test10,
95        vec![b"w/\"the-first-w-is-case-sensitive\""],
96        None::<ETag>);
97    test_header!(test11,
98        vec![b""],
99        None::<ETag>);
100    test_header!(test12,
101        vec![b"\"unmatched-dquotes1"],
102        None::<ETag>);
103    test_header!(test13,
104        vec![b"unmatched-dquotes2\""],
105        None::<ETag>);
106    test_header!(test14,
107        vec![b"matched-\"dquotes\""],
108        None::<ETag>);
109    test_header!(test15,
110        vec![b"\""],
111        None::<ETag>);
112}
113*/
rama_http_headers/common/etag.rs

rama_http_headers/common/
etag.rs
