stack-db 0.3.5

A (basically) infinitely stacking & extendable CoW database that has both readonly safety and incredible write speeds at the same time.
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

use stack_db::prelude::*;

fn main() {
    let allocator = SkdbDirAlloc::new("db.skdb").unwrap(); // or `SkdbDiskAlloc::new()`
    let mut database = StackDB::new(allocator).unwrap();

    // writing
    database.write(256, b"hello, ").unwrap();
    database.write(256+7, b"world").unwrap();

    // reading
    assert_eq!(&*database.read(256..268).unwrap(), b"hello, world");

    // flush to save all changes
    database.commit().unwrap();

    // over-writting
    database.write(256, b"H").unwrap();
    database.write(256+7, b"W").unwrap();
    database.write(268, b"!").unwrap();

    // flush again
    database.commit().unwrap();

    let mut database = StackDB::new(SkdbDirAlloc::load("db.skdb").unwrap()).unwrap();

    // reading
    assert_eq!(&*database.read(256..269).unwrap(), b"Hello, World!");

    // rebase to save space
    // database.rebase(256).unwrap(); // rebase with a 256 byte buffer
}