sfsdb 0.1.0

A simple, optionally cached and indexed, extensible file-system database you already know how to use
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

use serde::{Deserialize, Serialize};
use sfsdb::GenericDatabase;

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq)]
pub struct User {
    pub name: String,
    pub age: u64,
}

/*
 * A cached database can greatly increase performance when some objects
 * are loaded more than others.
 *
 * For cached database you really don't have to do anything differently.
 * It'll automatically cache the top Some(N) most used objects and pick
 * the cached version instead, if it exists when using db.load().
 *
 * It'll resync which objects are cached every X load where X is
 * the third parameter of new_cached(), but you can also force a
 * resync manually through the db.resync() method.
 *
 * For performance comparison with an uncached database run the 'benchmark'
 * example. Just remember to pass the --release flag to cargo!
 */

fn main() {
    // Second parameter is maximum amount of cached objects
    let mut db = sfsdb::new_cached("db", Some(20), 100);

    let u = User {
        name: "Justin Evans".to_string(),
        age: 22,
    };

    db.save("some key", &u).unwrap();
    db.save("other key", &u).unwrap();

    assert_eq!(db.exists("some key"), true);
    assert_eq!(u, db.load::<User>("some key").unwrap());
    assert_eq!(u, db.load::<User>("other key").unwrap());
}