crous-core 1.1.0

Core encoder/decoder, block framing, and Value types for the Crous binary format
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

//! Error types for Crous encoding/decoding operations.

use thiserror::Error;

/// All errors that can occur during Crous operations.
#[derive(Debug, Error)]
pub enum CrousError {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Invalid magic bytes in file header: expected CROUSv1")]
    InvalidMagic,

    #[error("Unsupported format version: {0}")]
    UnsupportedVersion(u8),

    #[error("Invalid wire type tag: 0x{0:02x}")]
    InvalidWireType(u8),

    #[error("Varint overflow: encoded integer exceeds 64 bits")]
    VarintOverflow,

    #[error("Unexpected end of input at offset {0}")]
    UnexpectedEof(usize),

    #[error("Checksum mismatch: expected 0x{expected:016x}, got 0x{actual:016x}")]
    ChecksumMismatch { expected: u64, actual: u64 },

    #[error("Invalid UTF-8 in string field at offset {0}")]
    InvalidUtf8(usize),

    #[error("Nesting depth {0} exceeds maximum {1}")]
    NestingTooDeep(usize, usize),

    #[error("Block size {0} exceeds maximum {1}")]
    BlockTooLarge(usize, usize),

    #[error("Item count {0} exceeds maximum {1}")]
    TooManyItems(usize, usize),

    #[error("Unknown compression type: {0}")]
    UnknownCompression(u8),

    #[error("Decompression error: {0}")]
    DecompressionError(String),

    #[error("Invalid block type: {0}")]
    InvalidBlockType(u8),

    #[error("Text parse error at line {line}, col {col}: {message}")]
    ParseError {
        line: usize,
        col: usize,
        message: String,
    },

    #[error("Schema mismatch: {0}")]
    SchemaMismatch(String),

    #[error("Memory limit exceeded: requested {0} bytes, limit {1}")]
    MemoryLimitExceeded(usize, usize),

    #[error("Invalid base64 data: {0}")]
    InvalidBase64(String),

    #[error("Invalid data: {0}")]
    InvalidData(String),
}

/// Convenience Result alias.
pub type Result<T> = std::result::Result<T, CrousError>;