h3x 0.6.1

Peer-to-peer DHTTP/3 transport over QUIC
Documentation 
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use crate::{
    dhttp::settings::{Setting, SettingId, Settings},
    varint::VarInt,
};

/// `H3_DATAGRAM` (0x33). No default.
///
/// Indicates support for HTTP/3 datagrams (RFC 9297). The value MUST be 0 or 1.
pub struct H3Datagram;

impl H3Datagram {
    pub const ID: VarInt = VarInt::from_u32(0x33);

    pub const fn setting(enabled: bool) -> Setting {
        Setting::new(Self::ID, VarInt::from_u32(enabled as u32))
    }
}

impl SettingId for H3Datagram {
    type Value = bool;

    fn id(&self) -> VarInt {
        Self::ID
    }

    fn value_from(&self, settings: &Settings) -> bool {
        settings
            .get_raw(Self::ID)
            .is_some_and(|value| value == VarInt::from_u32(1))
    }
}

impl Settings {
    pub fn h3_datagram(&self) -> bool {
        self.get(H3Datagram)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::varint::VarInt;

    #[test]
    fn h3_datagram_uses_boolean_value() {
        let mut settings = Settings::default();
        assert!(!settings.h3_datagram());

        settings.set(H3Datagram::setting(true));
        assert!(settings.h3_datagram());
        assert_eq!(
            settings.get(VarInt::from_u32(0x33)),
            Some(VarInt::from_u32(1))
        );
    }

    #[test]
    fn h3_datagram_exposes_id_and_treats_only_one_as_enabled() {
        assert_eq!(H3Datagram.id(), H3Datagram::ID);

        let mut settings = Settings::default();
        settings.set(H3Datagram::setting(false));
        assert!(!settings.h3_datagram());
        assert_eq!(
            settings.get(VarInt::from_u32(0x33)),
            Some(VarInt::from_u32(0))
        );

        settings.set(Setting::new(H3Datagram::ID, VarInt::from_u32(2)));
        assert!(!settings.h3_datagram());
    }
}