OKV - Okay Key-Value Storage

OKV is a versatile key-value storage library designed for Rust. It offers a simple yet powerful API, inspired by the heed crate, and supports various databases and serialization formats.

Features

• Multiple Database Backends:
  • memdb: In-memory database for rapid prototyping and testing.
  • rocksdb: RocksDB integration for robust, disk-based storage.
• Serialization Formats:
  • serde_json: JSON serialization for human-readable data storage.
  • rmp-serde: MessagePack serialization for efficient binary format.

Installation

Add OKV to your project:

cargo add okv

Quick Start

use okv::{Env};
use okv::backend::memory::MemDB;

fn main() -> eyre::Result<()> {
    // initialize the storage backend
    let memdb = MemDB::new();
    let env = Env::new(memdb);

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

    // Working with data
    db.set_nx("key", "val")?;
    assert_eq!(db.get("key")?, Some("val".to_string()));

    Ok(())
}

Supported Types

OKV can work with any type that implements Serialize. Additionally, it supports the following types out of the box without any serialization overhead:

• Integer types: [u8], [u16], [u32], [u64], u128, [i8], [i16], [i32], [i64], i128
• Basic types: (), &str, String, bool
• Binary data: u8 slices (&[u8]), byte vectors (Vec<u8>), and byte arrays ([u8; N])

Acknowledgements

Special thanks to the authors of the heed crate for their inspiring work, which greatly influenced the development of OKV.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in OKV by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.