vibesql-storage 0.2.0

Storage engine for vibesql SQL database
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160

// ============================================================================
// Low-Level I/O Primitives
// ============================================================================
//
// Handles reading and writing primitive types with proper endianness.

use std::io::{Read, Write};

use crate::StorageError;

pub fn read_u8<R: Read>(reader: &mut R) -> Result<u8, StorageError> {
    let mut buf = [0u8; 1];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(buf[0])
}

pub fn write_u8<W: Write>(writer: &mut W, value: u8) -> Result<(), StorageError> {
    writer
        .write_all(&[value])
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn write_u32<W: Write>(writer: &mut W, value: u32) -> Result<(), StorageError> {
    writer
        .write_all(&value.to_le_bytes())
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_u32<R: Read>(reader: &mut R) -> Result<u32, StorageError> {
    let mut buf = [0u8; 4];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(u32::from_le_bytes(buf))
}

pub fn write_u64<W: Write>(writer: &mut W, value: u64) -> Result<(), StorageError> {
    writer
        .write_all(&value.to_le_bytes())
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_u64<R: Read>(reader: &mut R) -> Result<u64, StorageError> {
    let mut buf = [0u8; 8];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(u64::from_le_bytes(buf))
}

pub fn write_i16<W: Write>(writer: &mut W, value: i16) -> Result<(), StorageError> {
    writer
        .write_all(&value.to_le_bytes())
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_i16<R: Read>(reader: &mut R) -> Result<i16, StorageError> {
    let mut buf = [0u8; 2];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(i16::from_le_bytes(buf))
}

pub fn write_i64<W: Write>(writer: &mut W, value: i64) -> Result<(), StorageError> {
    writer
        .write_all(&value.to_le_bytes())
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_i64<R: Read>(reader: &mut R) -> Result<i64, StorageError> {
    let mut buf = [0u8; 8];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(i64::from_le_bytes(buf))
}

pub fn write_f32<W: Write>(writer: &mut W, value: f32) -> Result<(), StorageError> {
    writer
        .write_all(&value.to_le_bytes())
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_f32<R: Read>(reader: &mut R) -> Result<f32, StorageError> {
    let mut buf = [0u8; 4];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(f32::from_le_bytes(buf))
}

pub fn write_f64<W: Write>(writer: &mut W, value: f64) -> Result<(), StorageError> {
    writer
        .write_all(&value.to_le_bytes())
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_f64<R: Read>(reader: &mut R) -> Result<f64, StorageError> {
    let mut buf = [0u8; 8];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(f64::from_le_bytes(buf))
}

pub fn write_bool<W: Write>(writer: &mut W, value: bool) -> Result<(), StorageError> {
    writer
        .write_all(&[if value { 1 } else { 0 }])
        .map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_bool<R: Read>(reader: &mut R) -> Result<bool, StorageError> {
    let mut buf = [0u8; 1];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    Ok(buf[0] != 0)
}

pub fn write_string<W: Write>(writer: &mut W, s: &str) -> Result<(), StorageError> {
    let bytes = s.as_bytes();
    write_u32(writer, bytes.len() as u32)?;
    writer.write_all(bytes).map_err(|e| StorageError::NotImplemented(format!("Write error: {}", e)))
}

pub fn read_string<R: Read>(reader: &mut R) -> Result<String, StorageError> {
    let len = read_u32(reader)?;
    let mut buf = vec![0u8; len as usize];
    reader
        .read_exact(&mut buf)
        .map_err(|e| StorageError::NotImplemented(format!("Read error: {}", e)))?;
    String::from_utf8(buf)
        .map_err(|e| StorageError::NotImplemented(format!("Invalid UTF-8: {}", e)))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_primitives() {
        let mut buf = Vec::new();

        write_u32(&mut buf, 12345).unwrap();
        write_i64(&mut buf, -9876543210).unwrap();
        write_f64(&mut buf, 3.14159).unwrap();
        write_bool(&mut buf, true).unwrap();
        write_string(&mut buf, "Hello, VBSQL!").unwrap();

        let mut reader = &buf[..];
        assert_eq!(read_u32(&mut reader).unwrap(), 12345);
        assert_eq!(read_i64(&mut reader).unwrap(), -9876543210);
        assert!((read_f64(&mut reader).unwrap() - 3.14159).abs() < 1e-10);
        assert!(read_bool(&mut reader).unwrap());
        assert_eq!(read_string(&mut reader).unwrap(), "Hello, VBSQL!");
    }
}