use std::fmt; #[allow(unused)] use std::ascii::AsciiExt; use header::{Header, Raw, parsing}; /// The `Pragma` header defined by HTTP/1.0. /// /// > The "Pragma" header field allows backwards compatibility with /// > HTTP/1.0 caches, so that clients can specify a "no-cache" request /// > that they will understand (as Cache-Control was not defined until /// > HTTP/1.1). When the Cache-Control header field is also present and /// > understood in a request, Pragma is ignored. /// > In HTTP/1.0, Pragma was defined as an extensible field for /// > implementation-specified directives for recipients. This /// > specification deprecates such extensions to improve interoperability. /// /// Spec: [https://tools.ietf.org/html/rfc7234#section-5.4][url] /// /// [url]: https://tools.ietf.org/html/rfc7234#section-5.4 /// /// # Examples /// /// ``` /// use hyper::header::{Headers, Pragma}; /// /// let mut headers = Headers::new(); /// headers.set(Pragma::NoCache); /// ``` /// /// ``` /// use hyper::header::{Headers, Pragma}; /// /// let mut headers = Headers::new(); /// headers.set(Pragma::Ext("foobar".to_owned())); /// ``` #[derive(Clone, PartialEq, Debug)] pub enum Pragma { /// Corresponds to the `no-cache` value. NoCache, /// Every value other than `no-cache`. Ext(String), } impl Header for Pragma { fn header_name() -> &'static str { static NAME: &'static str = "Pragma"; NAME } fn parse_header(raw: &Raw) -> ::Result { parsing::from_one_raw_str(raw).and_then(|s: String| { let slice = &s.to_ascii_lowercase()[..]; match slice { "no-cache" => Ok(Pragma::NoCache), _ => Ok(Pragma::Ext(s)), } }) } fn fmt_header(&self, f: &mut ::header::Formatter) -> fmt::Result { f.fmt_line(self) } } impl fmt::Display for Pragma { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.write_str(match *self { Pragma::NoCache => "no-cache", Pragma::Ext(ref string) => &string[..], }) } } #[test] fn test_parse_header() { let a: Pragma = Header::parse_header(&"no-cache".into()).unwrap(); let b = Pragma::NoCache; assert_eq!(a, b); let c: Pragma = Header::parse_header(&"FoObar".into()).unwrap(); let d = Pragma::Ext("FoObar".to_owned()); assert_eq!(c, d); let e: ::Result = Header::parse_header(&"".into()); assert_eq!(e.ok(), None); }