shdp 1.2.0

A new protocol (SHDP)
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
103
104
105
106
107
108
109
110

//!
//! Defines everything for the 0x0004 event.
//!

use bitvec::order::Msb0;

use crate::protocol::{
    client::bits::utils::{FyveImpl, OperatingCode},
    prelude::common::{
        bits::{util::BitReversible, BitDecoder, Frame},
        error::Error,
        event::{EventDecoder, EventEncoder},
    },
};

///
/// Describe an full fyve response.
///
pub struct FullFyveResponse {
    decoder: BitDecoder<Msb0>,
    /// The filename.
    pub filename: String,
    /// The file's content.
    pub content: String,
}

impl FullFyveResponse {
    ///
    /// Creates a new [FullFyveResponse].
    ///
    /// # Arguments
    /// * `decoder` - The [`BitDecoder<Msb0>`] to decode the request.
    ///
    /// # Returns
    /// * [FullFyveResponse] - The created [FullFyveResponse].
    ///
    /// # Example
    /// ```rust
    /// use shdp::prelude::client::versions::v1::r0x0004::FullFyveResponse;
    /// use shdp::prelude::common::bits::BitDecoder;
    /// use bitvec::order::Msb0;
    ///
    /// let decoder = BitDecoder::<Msb0>::new(Vec::new());
    /// let response = FullFyveResponse::new(decoder);
    ///
    /// // These are default values.
    /// assert_eq!(response.filename, String::new());
    /// assert_eq!(response.content, String::new());
    /// ```
    pub fn new(decoder: BitDecoder<Msb0>) -> Self {
        if cfg!(feature = "debug") {
            println!("[\x1b[38;5;187mSHDP\x1b[0m] \x1b[38;5;21m0x0004\x1b[0m received");
        }

        FullFyveResponse {
            decoder,
            filename: String::new(),
            content: String::new(),
        }
    }
}

impl EventDecoder<Msb0> for FullFyveResponse {
    fn decode(&mut self, frame: Frame<Msb0>) -> Result<(), Error> {
        // Read bytes till hits 0.
        let mut bytes = Vec::<u8>::new();

        loop {
            let byte = self.decoder.read_data(8)? as u8;
            if byte == 0 {
                break;
            }

            bytes.push(byte);
        }

        self.filename = String::from_utf8(bytes).unwrap();

        let mut content = String::new();

        loop {
            if self.decoder.position >= (frame.data_size + 56).into() {
                break;
            }

            let op = FyveImpl::get_op(&mut self.decoder)?;

            if op.kind == OperatingCode::Character {
                let char = op.get_char()?;
                content.push(char);
            } else {
                return Err(Error {
                    code: 400,
                    message: format!("Invalid operation: {:?}", op),
                    kind: crate::protocol::errors::ErrorKind::BadRequest,
                });
            }
        }

        self.content = content;

        Ok(())
    }

    fn get_responses(
        &self,
    ) -> Result<Vec<Box<dyn EventEncoder<<Msb0 as BitReversible>::Opposite>>>, Error> {
        Ok(Vec::new())
    }
}