Crates.io | sled-tables |
lib.rs | sled-tables |
version | 0.2.2 |
source | src |
created_at | 2021-06-17 09:50:43.553695 |
updated_at | 2022-05-31 21:40:51.219859 |
description | Structurized, strongly typed tables for sled to store associated sets of data (Vec/HashSet) |
homepage | |
repository | https://github.com/35359595/sled-tables |
max_upload_size | |
id | 411279 |
size | 24,830 |
sled-tables
Intended to abstract storage of associated sets of data as Vec
or HashSet
seamlessly using serde_cbor serialization.
#Usage
For your data struct (should implement Serialize and Deserialize
):
use serde::{Serialize, Deserialize};
#[derive(Serialize, Deserialize, PartialEq, Debug)]
struct Data {
name: String,
inner: Vec<String>
}
impl Data {
fn save_rewrite(&self, db: &DataDb) -> Result<(), super::error::Error> {
db.values.put(db.names.designated_key(&self.name), self.inner.clone())
}
fn restore(name: &str, db: &DataDb) -> Result<Self, super::error::Error> {
if let Ok(Some(inner)) = db.values.get(db.names.designated_key(&name.into())) {
Ok(Data {
name: name.into(),
inner
})
} else {
Err(super::error::Error::NoDataError)
}
}
}
Implement struct to link your data with the db:
struct DataDb {
pub names: super::tables::SledEventTree<String>,
pub values: super::tables::SledEventTreeVec<String>,
}
impl DataDb {
fn new<'p, P>(path: P) -> Result<Self, super::error::Error>
where P: Into<&'p std::path::Path>{
let db = sled::open(path.into())?;
Ok(Self {
names: super::tables::SledEventTree::new(db.open_tree(b"names")?),
values: super::tables::SledEventTreeVec::new(db.open_tree(b"values")?),
})
}
}
That's it - you're good to go:
let data = Data {
name: "first".into(),
inner: vec!("a".into(), "b".into(), "c".into())
};
// Create database somewhere.
let db = DataDb::new(tmp.path())?;
// Store your data.
data.save_rewrite(&db)?;
// Read your data.
let restored = Data::restore("first", &db);
Bunch of other methods are present - go read the docs ;)
#License: Apache v2.0