siamesedb

The simple local key-value store.

Features

• key-value store.
• in-memory and file store.
• DbMapString has keys as utf-8 string.
• DbMapU64 has keys as u64.
• The value is any bytes included utf-8 string.
• The file store is implemented the basic B-Tree. (no hash and no leaf)
• Small db file size.
• Separated files. (data record file and index file)
• One database has some db-map-string and some db-map-u64.
• minimum support rustc rustc 1.53.0 (53cb7b09b 2021-06-17)

Compatibility

• Nothing?

Examples

Example DbMapString:

```rust use siamesedb::{DbMapString, DbXxx};

fn main() -> std::io::Result<()> { let dbname = "target/tmp/doc-test1.siamesedb"; // remove database let _ = std::fs::removedirall(dbname); // create or open database let db = siamesedb::openfile(dbname)?; // create or get db map let mut dbmap = db.dbmapstring("somemap1")?; // let r = dbmap.getstring("key1")?; asserteq!(r, None); dbmap.putstring("key1".tostring(), "value1")?; let r = dbmap.getstring("key1")?; asserteq!(r, Some("value1".tostring())); dbmap.syncdata()?; Ok(()) } ```

Example DbMapU64:

```rust use siamesedb::{DbMapU64, DbXxx};

fn main() -> std::io::Result<()> { let dbname = "target/tmp/doc-test2.siamesedb"; // remove database let _ = std::fs::removedirall(dbname); // create or open database let db = siamesedb::openfile(dbname)?; let mut dbmap = db.dbmapu64("somelist1")?; let r = dbmap.getstring(&120)?; asserteq!(r, None); dbmap.putstring(120, "value120")?; let r = dbmap.getstring(&120)?; asserteq!(r, Some("value120".tostring())); dbmap.sync_data()?; Ok(()) } ```

Example Iterator:

```rust use siamesedb::{DbMapString, DbMap, DbXxx};

fn main() -> std::io::Result<()> { let dbname = "target/tmp/doc-test3.siamesedb"; // remove database let _ = std::fs::removedirall(dbname); // create or open database let db = siamesedb::openfile(dbname)?; // create or get db map let mut dbmap = db.dbmapstring("somemap1")?; // // insert dbmap.putstring("key01".into(), "value1").unwrap(); dbmap.putstring("key02".into(), "value2").unwrap(); dbmap.putstring("key03".into(), "value3").unwrap(); // // iterator let mut iter = dbmap.iter(); asserteq!(iter.next(), Some(("key01".into(), "value1".into()))); asserteq!(iter.next(), Some(("key02".into(), "value2".into()))); asserteq!(iter.next(), Some(("key03".into(), "value3".into()))); asserteq!(iter.next(), None); // dbmap.sync_data()?; Ok(()) } ```

Changelogs

This crate's changelog here.

License

This project is licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.