tick-encoding 0.1.4

A simple encoding scheme to encode binary data into ASCII strings
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

use crate::{hex_bytes_to_byte, requires_escape, DecodeError};

#[derive(Debug, Default, Clone, Copy)]
pub enum Decoder {
    #[default]
    Ready,
    Finished,
    Tick,
    TickHalfHex(u8),
}

impl Decoder {
    #[inline]
    pub fn push(&mut self, input: Option<u8>) -> DecodeStatus {
        match (*self, input) {
            (Self::Finished, _) => DecodeStatus::Emit(None),
            (Self::Ready, Some(input)) => {
                if input == b'`' {
                    *self = Self::Tick;
                    DecodeStatus::NeedMore
                } else if requires_escape(input) {
                    *self = Self::Finished;
                    DecodeStatus::Emit(Some(Err(DecodeError::InvalidByte(input))))
                } else {
                    DecodeStatus::Emit(Some(Ok(input)))
                }
            }
            (Self::Ready, None) => {
                *self = Self::Finished;
                DecodeStatus::Emit(None)
            }
            (Self::Tick, Some(input)) => {
                if input == b'`' {
                    *self = Self::Ready;
                    DecodeStatus::Emit(Some(Ok(b'`')))
                } else {
                    *self = Self::TickHalfHex(input);
                    DecodeStatus::NeedMore
                }
            }
            (Self::Tick | Self::TickHalfHex(_), None) => {
                *self = Self::Finished;
                DecodeStatus::Emit(Some(Err(DecodeError::UnexpectedEnd)))
            }
            (Self::TickHalfHex(high), Some(low)) => {
                let byte_result = hex_bytes_to_byte(high, low);
                match byte_result {
                    Ok(byte) => {
                        *self = Self::Ready;
                        DecodeStatus::Emit(Some(Ok(byte)))
                    }
                    Err(error) => {
                        *self = Self::Finished;
                        DecodeStatus::Emit(Some(Err(error)))
                    }
                }
            }
        }
    }
}

pub enum DecodeStatus {
    NeedMore,
    Emit(Option<Result<u8, DecodeError>>),
}