internet 0.0.5

Network library for rust
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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! Change Cipher Spec encoding following [RFC 2246].
//!
//! Encoding is supported for the following structures:
//!
//!  - [`ChangeCipherSpecType`]
//!  - [`ChangeCipherSpec`]
//!
//! [RFC 2246]: https://datatracker.ietf.org/doc/html/rfc2246

use crate::{
    Buf,
    BufError::{self},
    BufMut, BufResult, Codec, Cursor,
};

/// A ChangeCipherSpec type following [Section 7.1].
///
/// [Section 7.1]: https://datatracker.ietf.org/doc/html/rfc2246#section-7.1
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[repr(u8)]
pub enum ChangeCipherSpecType {
    /// change_cipher_spec(1)
    ChangeCipherSpec = 1,
}

impl Codec for ChangeCipherSpecType {
    fn encode<W: BufMut>(&self, writer: &mut Cursor<W>, _: ()) -> BufResult<()> {
        (*self as u8).encode(writer, ())
    }

    fn decode<R: Buf>(reader: &mut Cursor<R>, _: ()) -> BufResult<Self> {
        match u8::decode(reader, ())? {
            x if x == (Self::ChangeCipherSpec as u8) => Ok(Self::ChangeCipherSpec),
            _ => Err(BufError::UnexpectedValue),
        }
    }
}

/// A ChangeCipherSpec following [Section 7.1].
///
/// [Section 7.1]: https://datatracker.ietf.org/doc/html/rfc2246#section-7.1
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct ChangeCipherSpec {
    /// The type of the change cipher spec.
    pub type_: ChangeCipherSpecType,
}

impl Codec for ChangeCipherSpec {
    fn encode<W: BufMut>(&self, writer: &mut Cursor<W>, _: ()) -> BufResult<()> {
        self.type_.encode(writer, ())
    }

    fn decode<R: Buf>(reader: &mut Cursor<R>, _: ()) -> BufResult<Self> {
        Ok(Self {
            type_: ChangeCipherSpecType::decode(reader, ())?,
        })
    }
}

#[cfg(test)]
mod tests {
    use core::fmt::Debug;

    use super::{ChangeCipherSpec, ChangeCipherSpecType};
    use crate::{Codec, Cursor};

    fn codec_roundtrip<T: Codec<C> + Debug + Eq, C: Copy>(
        etalon_struct: T,
        etalon_bytes: &[u8],
        context: C,
    ) {
        let mut encoded_bytes = vec![];
        {
            let writer = &mut Cursor::new(&mut encoded_bytes);
            etalon_struct.encode(writer, context).unwrap();
        }
        assert_eq!(etalon_bytes, &encoded_bytes);

        let decoded_struct = {
            let reader = &mut Cursor::new(&mut encoded_bytes);
            T::decode(reader, context).unwrap()
        };
        assert_eq!(etalon_struct, decoded_struct);

        encoded_bytes.fill(0x00);
        {
            let writer = &mut Cursor::new(&mut encoded_bytes);
            decoded_struct.encode(writer, context).unwrap();
        }
        assert_eq!(etalon_bytes, &encoded_bytes);
    }

    #[test]
    fn change_cipher_spec() {
        let etalon_bytes = &[0x01];
        let etalon_struct = ChangeCipherSpec {
            type_: ChangeCipherSpecType::ChangeCipherSpec,
        };

        codec_roundtrip(etalon_struct, etalon_bytes, ());
    }
}