#sled #serde #bincode #ron #storage #base #minimalist #api #file #tiny

sleded

Minimalist API for storing data effortlessly persistently to a file

3 releases (1 stable)

1.0.0 Aug 21, 2022
0.1.1 Jul 7, 2022
0.1.0 Jul 7, 2022

#809 in Database interfaces

MIT license

10KB
238 lines

Sleded

A sled-ed database.

Description

a simple crate that exposes a minimalist API for storing persistent data to a file. Backed by sled and serde with RON.

Example

// Something to store, needs to be serializable.
#[derive(Debug, Serialize, Deserialize)]
pub struct Student {
    name: String,
    value: usize,
}

impl TableLayout for Student {
    // adding the name of the stored table.
    fn table_name() -> String {
        "student".into()
    }
}

// storing an item
let db = open("./db").unwrap();
let table = db.table();
let bob_key = table.push(Student {
    name: "bob".into(),
    value: 0,
});

// query one item
let bob = table.get(&bob_key);
dbg!(bob);

// query all items
for (key, value) in table.iter() {
    let key = key.value(&table);
    println!("key: {key}, student: {value:?}");
}

// update items
for key in table.keys() {
    table.update(&key, |student| {
        if let Some(student) = student {
            student.value += 1;
        }
    })
}

TODOs

  • store stuff.
  • table by type.
  • better error handling.
  • generate migrations.

Dependencies

~2.2–3MB
~61K SLoC