rawdb 0.10.3

Single-file, low-level and space efficient storage engine with filesystem-like API
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

use std::{fs, io, result};

use thiserror::Error;

pub type Result<T, E = Error> = result::Result<T, E>;

/// Error types for rawdb operations.
#[derive(Debug, Error)]
pub enum Error {
    #[error(transparent)]
    IO(#[from] io::Error),

    #[error("Database is locked by another process")]
    TryLock(#[from] fs::TryLockError),

    // Region errors
    #[error("Region not found")]
    RegionNotFound,

    #[error("Region metadata has unwritten data")]
    RegionMetadataUnwritten,

    #[error("Region already exists")]
    RegionAlreadyExists,

    #[error("Cannot remove region '{id}': still held by {} reference(s)", ref_count - 1)]
    RegionStillReferenced { id: String, ref_count: usize },

    // Write errors
    #[error("Write position {position} is beyond region length {region_len}")]
    WriteOutOfBounds { position: usize, region_len: usize },

    // Truncate errors
    #[error("Cannot truncate to {from} bytes (current length: {current_len})")]
    TruncateInvalid { from: usize, current_len: usize },

    // Metadata errors
    #[error("Invalid region ID")]
    InvalidRegionId,

    #[error("Invalid metadata size: expected {expected} bytes, got {actual}")]
    InvalidMetadataSize { expected: usize, actual: usize },

    #[error("Empty region metadata")]
    EmptyMetadata,

    // Layout errors
    #[error("Region index mismatch in layout")]
    RegionIndexMismatch,

    #[error("Hole too small: have {hole_size} bytes, need {requested}")]
    HoleTooSmall { hole_size: usize, requested: usize },

    // Internal invariant errors
    #[error("Internal invariant violated: {0}")]
    InvariantViolation(String),

    #[error("Corrupted metadata: {0}")]
    CorruptedMetadata(String),

    #[error("Region size would overflow: current={current}, requested={requested}")]
    RegionSizeOverflow { current: usize, requested: usize },

    #[error("Overlapping copy ranges not supported (src={src}..{src_end}, dst={dst}..{dst_end})")]
    OverlappingCopyRanges {
        src: usize,
        src_end: usize,
        dst: usize,
        dst_end: usize,
    },

    // Hole punching errors
    #[error("Failed to punch hole at offset {start} (length {len}): {source}")]
    HolePunchFailed {
        start: usize,
        len: usize,
        source: io::Error,
    },

    #[error("Hole punching is not supported on this platform")]
    HolePunchUnsupported,
}

impl Error {
    pub fn other(e: impl ToString) -> Self {
        Self::InvariantViolation(e.to_string())
    }
}