http_types_rs/
version.rs

1/// The version of the HTTP protocol in use.
2#[derive(Copy, Clone, Debug, Eq, Ord, PartialEq, PartialOrd)]
3#[non_exhaustive]
4pub enum Version {
5    /// HTTP/0.9
6    Http0_9,
7
8    /// HTTP/1.0
9    Http1_0,
10
11    /// HTTP/1.1
12    Http1_1,
13
14    /// HTTP/2.0
15    Http2_0,
16
17    /// HTTP/3.0
18    Http3_0,
19}
20
21#[cfg(feature = "serde")]
22mod serde {
23    use super::Version;
24    use serde::{
25        de::{Error, Unexpected, Visitor},
26        Deserialize, Deserializer, Serialize, Serializer,
27    };
28
29    impl Serialize for Version {
30        fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
31        where
32            S: Serializer,
33        {
34            serializer.serialize_str(self.as_ref())
35        }
36    }
37
38    struct VersionVisitor;
39
40    impl<'de> Visitor<'de> for VersionVisitor {
41        type Value = Version;
42
43        fn expecting(&self, formatter: &mut std::fmt::Formatter) -> std::fmt::Result {
44            write!(formatter, "a HTTP version as &str")
45        }
46
47        fn visit_str<E>(self, v: &str) -> Result<Self::Value, E>
48        where
49            E: Error,
50        {
51            match v {
52                "HTTP/0.9" => Ok(Version::Http0_9),
53                "HTTP/1.0" => Ok(Version::Http1_0),
54                "HTTP/1.1" => Ok(Version::Http1_1),
55                "HTTP/2" => Ok(Version::Http2_0),
56                "HTTP/3" => Ok(Version::Http3_0),
57                _ => Err(Error::invalid_value(Unexpected::Str(v), &self)),
58            }
59        }
60
61        fn visit_string<E>(self, v: String) -> Result<Self::Value, E>
62        where
63            E: Error,
64        {
65            self.visit_str(&v)
66        }
67    }
68
69    impl<'de> Deserialize<'de> for Version {
70        fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
71        where
72            D: Deserializer<'de>,
73        {
74            deserializer.deserialize_str(VersionVisitor)
75        }
76    }
77}
78
79impl AsRef<str> for Version {
80    fn as_ref(&self) -> &'static str {
81        match self {
82            Version::Http0_9 => "HTTP/0.9",
83            Version::Http1_0 => "HTTP/1.0",
84            Version::Http1_1 => "HTTP/1.1",
85            Version::Http2_0 => "HTTP/2",
86            Version::Http3_0 => "HTTP/3",
87        }
88    }
89}
90
91impl std::fmt::Display for Version {
92    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
93        f.write_str(self.as_ref())
94    }
95}
96
97#[cfg(test)]
98mod test {
99    use super::*;
100
101    #[test]
102    fn as_ref() {
103        assert_eq!(Version::Http0_9.as_ref(), "HTTP/0.9");
104        assert_eq!(Version::Http1_0.as_ref(), "HTTP/1.0");
105        assert_eq!(Version::Http1_1.as_ref(), "HTTP/1.1");
106        assert_eq!(Version::Http2_0.as_ref(), "HTTP/2");
107        assert_eq!(Version::Http3_0.as_ref(), "HTTP/3");
108    }
109
110    #[test]
111    fn to_string() {
112        let output = format!(
113            "{} {} {} {} {}",
114            Version::Http0_9,
115            Version::Http1_0,
116            Version::Http1_1,
117            Version::Http2_0,
118            Version::Http3_0
119        );
120        assert_eq!("HTTP/0.9 HTTP/1.0 HTTP/1.1 HTTP/2 HTTP/3", output);
121    }
122
123    #[test]
124    fn ord() {
125        use Version::*;
126        assert!(Http3_0 > Http2_0);
127        assert!(Http2_0 > Http1_1);
128        assert!(Http1_1 > Http1_0);
129        assert!(Http1_0 > Http0_9);
130    }
131
132    #[test]
133    fn serde() -> Result<(), serde_json::Error> {
134        assert_eq!("\"HTTP/3\"", serde_json::to_string(&Version::Http3_0)?);
135        assert_eq!(Version::Http1_1, serde_json::from_str("\"HTTP/1.1\"")?);
136        Ok(())
137    }
138}
http_types_rs/version.rs

http_types_rs/
version.rs
