miku_h2/
ext.rs

1//! Extensions specific to the HTTP/2 protocol.
2
3use crate::hpack::BytesStr;
4
5use bytes::Bytes;
6use std::fmt;
7
8/// Represents the `:protocol` pseudo-header used by
9/// the [Extended CONNECT Protocol].
10///
11/// [Extended CONNECT Protocol]: https://datatracker.ietf.org/doc/html/rfc8441#section-4
12#[derive(Clone, Eq, PartialEq)]
13pub struct Protocol {
14    value: BytesStr,
15}
16
17impl Protocol {
18    /// Converts a static string to a protocol name.
19    pub const fn from_static(value: &'static str) -> Self {
20        Self {
21            value: BytesStr::from_static(value),
22        }
23    }
24
25    /// Returns a str representation of the header.
26    pub fn as_str(&self) -> &str {
27        self.value.as_str()
28    }
29
30    pub(crate) fn try_from(bytes: Bytes) -> Result<Self, std::str::Utf8Error> {
31        Ok(Self {
32            value: BytesStr::try_from(bytes)?,
33        })
34    }
35}
36
37impl<'a> From<&'a str> for Protocol {
38    fn from(value: &'a str) -> Self {
39        Self {
40            value: BytesStr::from(value),
41        }
42    }
43}
44
45impl AsRef<[u8]> for Protocol {
46    fn as_ref(&self) -> &[u8] {
47        self.value.as_ref()
48    }
49}
50
51impl fmt::Debug for Protocol {
52    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
53        self.value.fmt(f)
54    }
55}
56
57#[derive(Debug, Clone, Copy, Eq, PartialEq)]
58/// Represents the pseudo-header type.
59pub enum PseudoType {
60    /// The `:method` pseudo-header.
61    Method,
62
63    /// The `:scheme` pseudo-header.
64    Scheme,
65
66    /// The `:authority` pseudo-header.
67    Authority,
68
69    /// The `:path` pseudo-header.
70    Path,
71}
miku_h2/ext.rs

miku_h2/
ext.rs
