#sled-database #sled #db #database-table #strongly-typed

sled-tables

Structurized, strongly typed tables for sled to store associated sets of data (Vec/HashSet)

3 releases

0.2.2 May 31, 2022
0.2.1 Oct 16, 2021
0.2.0 Jun 17, 2021
0.1.0 Jun 17, 2021

#787 in Encoding

Download history 7/week @ 2024-02-18 11/week @ 2024-02-25 3/week @ 2024-03-03 2/week @ 2024-03-10 21/week @ 2024-03-17 2/week @ 2024-03-24 51/week @ 2024-03-31

77 downloads per month
Used in 2 crates (via teliox)

Apache-2.0

15KB
285 lines

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

Dependencies

~2.1–3MB
~59K SLoC