boringdb 0.4.1

Robust, reasonably high-performance key-value database built on SQLite
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

use crate::dict::Dict;
use crate::low_level::LowLevel;
use crate::types::BoringResult;

use std::path::PathBuf;
use std::sync::Arc;

/// A database full of maps.
pub struct Database {
    low_level: Arc<LowLevel>,
}

impl Database {
    /// Opens a database given a filename.
    pub fn open(path: impl Into<PathBuf>) -> BoringResult<Self> {
        let low_level: LowLevel = LowLevel::open(path)?;
        Ok(Self {
            low_level: Arc::new(low_level),
        })
    }

    /// Opens a dictionary given its name. Creates a new empty map if the map doesn't exist
    pub fn open_dict(&self, name: &str) -> BoringResult<Dict> {
        self.low_level.transaction(|transaction| {
            transaction.execute(
                &format!(
                    "create table if not exists {} (key BLOB PRIMARY KEY, value BLOB NOT NULL)",
                    name
                ),
                [],
            )?;
            transaction.commit()?;
            Ok(())
        })?;
        Ok(Dict::new(self.low_level.clone(), name))
    }
}