39 releases

0.20.3 Jul 2, 2024
0.20.0 Apr 26, 2024
0.20.0-alpha.9 Nov 27, 2023
0.20.0-alpha.3 Jul 13, 2023
0.6.0 Nov 26, 2019

#34 in Database interfaces

Download history 9492/week @ 2024-04-03 8891/week @ 2024-04-10 12558/week @ 2024-04-17 17355/week @ 2024-04-24 17817/week @ 2024-05-01 15984/week @ 2024-05-08 20363/week @ 2024-05-15 18938/week @ 2024-05-22 23300/week @ 2024-05-29 20512/week @ 2024-06-05 20349/week @ 2024-06-12 21337/week @ 2024-06-19 23590/week @ 2024-06-26 15487/week @ 2024-07-03 15549/week @ 2024-07-10 10371/week @ 2024-07-17

69,508 downloads per month
Used in 14 crates (9 directly)

MIT license

1MB
17K SLoC

C 11K SLoC // 0.2% comments Rust 5.5K SLoC // 0.0% comments

heed

License Crates.io Docs dependency status Build

A Rust-centric LMDB abstraction with minimal overhead. This library enables the storage of various Rust types within LMDB, extending support to include Serde-compatible types.

Simple Example Usage

Here is an example on how to store and read entries into LMDB in a safe and ACID way. For usage examples, see heed/examples/. To see more advanced usage techniques go check our Cookbook.

use std::fs;
use std::path::Path;
use heed::{EnvOpenOptions, Database};
use heed::types::*;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let env = unsafe { EnvOpenOptions::new().open("my-first-db")? };

    // We open the default unnamed database
    let mut wtxn = env.write_txn()?;
    let db: Database<Str, U32<byteorder::NativeEndian>> = env.create_database(&mut wtxn, None)?;

    // We open a write transaction
    db.put(&mut wtxn, "seven", &7)?;
    db.put(&mut wtxn, "zero", &0)?;
    db.put(&mut wtxn, "five", &5)?;
    db.put(&mut wtxn, "three", &3)?;
    wtxn.commit()?;

    // We open a read transaction to check if those values are now available
    let mut rtxn = env.read_txn()?;

    let ret = db.get(&rtxn, "zero")?;
    assert_eq!(ret, Some(0));

    let ret = db.get(&rtxn, "five")?;
    assert_eq!(ret, Some(5));

    Ok(())
}

Building from Source

You can use this command to clone the repository:

git clone --recursive https://github.com/meilisearch/heed.git
cd heed
cargo build

However, if you already cloned it and forgot to initialize the submodules, execute the following command:

git submodule update --init

Dependencies

~0.8–2.4MB
~49K SLoC