okv 0.3.1

A versatile key-value storage library
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

use eyre::Result;
use okv::backend::rocksdb::RocksDbOptimistic;
use okv::Env;

fn main() -> Result<()> {
    // ensure that the directory exists
    std::fs::create_dir_all("database/example-transactions")?;

    // initialize the storage backend
    // You can either use RocksDbOptimistic or RocksDbPessimistic
    // see https://github.com/facebook/rocksdb/wiki/Transactions
    let rocksdb = RocksDbOptimistic::new("database/example-transactions")?;
    let env = Env::new(rocksdb);

    // open a database with the specified key and value types
    let db = env.open::<&str, &str>("test")?;

    let tx = db.transaction()?;
    tx.set_nx("hello", "world")?;
    tx.commit()?;

    // after commit, we can't use tx anymore as it has been consumed
    // tx.set_nx("hello", "world3")?; <- borrow of moved value: `tx`

    let tx = db.transaction()?;
    tx.set("hello", "sailor")?;
    tx.rollback()?;

    // hello is still world as the transaction was rolled back
    assert_eq!(db.get("hello")?, Some("world".to_string()));

    Ok(())
}

#[test] // ensure that the example always works
fn test() -> Result<()> {
    main()
}