titanite 0.3.0

Client/Server Library for Gemini protocol with Titan support
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

use anyhow::{bail, Result};

pub const CODE: &[u8] = b"52";

/// [Gone](https://geminiprotocol.net/docs/protocol-specification.gmi#status-52-gone)
pub struct Gone {
    pub message: Option<String>,
}

impl Gone {
    /// Build `Self` from UTF-8 header bytes
    /// * expected buffer includes leading status code, message, CRLF
    pub fn from_bytes(buffer: &[u8]) -> Result<Self> {
        use crate::tool::Header;
        let h = buffer.header_bytes()?;
        if h.get(..2)
            .is_none_or(|c| c[0] != CODE[0] || c[1] != CODE[1])
        {
            bail!("Invalid status code")
        }
        Ok(Self {
            message: String::from_utf8((h[3..]).to_vec()).map(|m| {
                if m.is_empty() {
                    None
                } else {
                    Some(m)
                }
            })?,
        })
    }

    /// Convert `Self` into UTF-8 bytes presentation
    pub fn into_bytes(self) -> Vec<u8> {
        match self.message {
            Some(message) => {
                let mut bytes = Vec::with_capacity(message.len() + 5);
                bytes.extend(CODE);
                bytes.push(b' ');
                bytes.extend(message.into_bytes());
                bytes.extend([b'\r', b'\n']);
                bytes
            }
            None => {
                let mut bytes = Vec::with_capacity(4);
                bytes.extend(CODE);
                bytes.extend([b'\r', b'\n']);
                bytes
            }
        }
    }
}

#[test]
fn test() {
    let request = format!("52 message\r\n");
    let source = Gone::from_bytes(request.as_bytes()).unwrap();

    assert_eq!(source.message, Some("message".to_string()));
    assert_eq!(source.into_bytes(), request.as_bytes());
}