qbase 0.5.0

Core structure of the QUIC protocol, a part of dquic
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
73
74
75
76
77
78
79
80
81
82
83

use super::EncodeSize;
use crate::frame::{GetFrameType, io::WriteFrameType};
/// HandshakeDone frame
///
/// ```text
/// HANDSHAKE_DONE Frame {
///   Type (i) = 0x1e,
/// }
/// ```
///
/// See [HANDSHAKE_DONE Frames](https://www.rfc-editor.org/rfc/rfc9000.html#name-handshake_done-frames)
/// of [QUIC](https://www.rfc-editor.org/rfc/rfc9000.html) for more details.
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
pub struct HandshakeDoneFrame;

impl super::GetFrameType for HandshakeDoneFrame {
    fn frame_type(&self) -> super::FrameType {
        super::FrameType::HandshakeDone
    }
}

impl EncodeSize for HandshakeDoneFrame {}

/// Parse a HANDSHAKE_DONE frame from the input buffer,
/// [nom](https://docs.rs/nom/latest/nom/) parser style.
#[allow(unused)]
pub fn be_handshake_done_frame(input: &[u8]) -> nom::IResult<&[u8], HandshakeDoneFrame> {
    Ok((input, HandshakeDoneFrame))
}

impl<T: bytes::BufMut> super::io::WriteFrame<HandshakeDoneFrame> for T {
    fn put_frame(&mut self, frame: &HandshakeDoneFrame) {
        self.put_frame_type(frame.frame_type());
    }
}

#[cfg(test)]
mod tests {
    use crate::{
        frame::{
            EncodeSize, FrameType, GetFrameType, HandshakeDoneFrame,
            io::{WriteFrame, WriteFrameType},
        },
        varint::VarInt,
    };

    #[test]
    fn test_handshake_done_frame() {
        assert_eq!(HandshakeDoneFrame.frame_type(), FrameType::HandshakeDone);
        assert_eq!(HandshakeDoneFrame.max_encoding_size(), 1);
        assert_eq!(HandshakeDoneFrame.encoding_size(), 1);
    }

    #[test]
    fn test_read_handshake_done_frame() {
        use nom::{Parser, combinator::flat_map};

        use super::be_handshake_done_frame;
        use crate::varint::be_varint;
        let handshake_done_frame_type = VarInt::from(FrameType::HandshakeDone);
        let buf = vec![handshake_done_frame_type.into_inner() as u8];
        let (input, frame) = flat_map(be_varint, |frame_type| {
            if frame_type == handshake_done_frame_type {
                be_handshake_done_frame
            } else {
                panic!("wrong frame type: {frame_type}")
            }
        })
        .parse(buf.as_ref())
        .unwrap();
        assert!(input.is_empty());
        assert_eq!(frame, super::HandshakeDoneFrame);
    }

    #[test]
    fn test_write_handshake_done_frame() {
        let mut buf = Vec::new();
        buf.put_frame(&HandshakeDoneFrame);
        let mut expected = Vec::new();
        expected.put_frame_type(FrameType::HandshakeDone);
        assert_eq!(buf, expected);
    }
}