st-protocol 0.1.0

Binary wire protocol for smart-tree daemon communication
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

//! Protocol error types

/// Protocol-specific errors
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ProtocolError {
    /// Invalid or unknown verb byte
    InvalidVerb(u8),
    /// Frame is too short to be valid
    FrameTooShort,
    /// Frame exceeds maximum size
    FrameTooLarge,
    /// Missing END marker
    MissingEndMarker,
    /// Invalid escape sequence
    InvalidEscape,
    /// Payload decode error
    PayloadError,
    /// Invalid address format
    InvalidAddress,
    /// Authentication required
    AuthRequired,
    /// Authentication failed
    AuthFailed,
    /// Invalid auth block structure
    InvalidAuthBlock,
    /// Insufficient privileges
    InsufficientPrivileges,
    /// Session expired or invalid
    InvalidSession,
    /// Unknown host in cache
    UnknownHost(u8),
    /// I/O error (std only)
    #[cfg(feature = "std")]
    Io(String),
}

impl core::fmt::Display for ProtocolError {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        match self {
            ProtocolError::InvalidVerb(b) => write!(f, "invalid verb byte: 0x{:02X}", b),
            ProtocolError::FrameTooShort => write!(f, "frame too short"),
            ProtocolError::FrameTooLarge => write!(f, "frame exceeds maximum size"),
            ProtocolError::MissingEndMarker => write!(f, "missing END marker (0x00)"),
            ProtocolError::InvalidEscape => write!(f, "invalid escape sequence"),
            ProtocolError::PayloadError => write!(f, "payload decode error"),
            ProtocolError::InvalidAddress => write!(f, "invalid address format"),
            ProtocolError::AuthRequired => write!(f, "authentication required"),
            ProtocolError::AuthFailed => write!(f, "authentication failed"),
            ProtocolError::InvalidAuthBlock => write!(f, "invalid auth block structure"),
            ProtocolError::InsufficientPrivileges => write!(f, "insufficient privileges"),
            ProtocolError::InvalidSession => write!(f, "invalid or expired session"),
            ProtocolError::UnknownHost(idx) => write!(f, "unknown host at index {}", idx),
            #[cfg(feature = "std")]
            ProtocolError::Io(msg) => write!(f, "I/O error: {}", msg),
        }
    }
}

#[cfg(feature = "std")]
impl std::error::Error for ProtocolError {}

/// Result type for protocol operations
pub type ProtocolResult<T> = Result<T, ProtocolError>;