mmtkvdb

mmtkvdb is a crate for Rust which provides a memory-mapped key-value database. It uses LMDB and links with an existing liblmdb on the system.

Safety

Because of how memory-mapped I/O is being used and also because of certain assumptions of the underlying LMDB API, opening environments and databases requires unsafe Rust (i.e. the programmer must ensure that certain preconditions are met that cannot be enforced by the compiler to avoid undefined behavior). If you aim to program in safe Rust only, this Rust library is not suitable for you.

API Documentation

For documentation on how to use this crate, refer to the example in src/lib.rs.

License

See contained LICENSE file (MIT License).

Changelog

• 2022-07-12: Version 0.8.0
  • Trait Ord is no longer required for Storable types.
  • Use deref_owned version 0.10.1
  • Improved documentation
  • Bugfixes
    • The constant Storable::TRIVIAL_CMP was set to true for signed byte slices, which led to wrong comparisons of keys or duplicate values.
    • The macro impl_ord_for_storable was broken. The macro is no longer needed and has been removed, thus the bug does not exist anymore.
  • Changed re-exports
    • A new module cow has been added, which re-exports items from crate deref_owned.
    • All relevant items are now re-exported by the crate-level module as well.
  • Code cleanup
    • Internal macros in storable module have been cleaned up.
    • Cleaner implementation for BorrowStorable which allowed removing the private IsType trait and the public StorableWithOwned trait.
    • Consistent use of GenericCow where applicable
  • Added more tests
• 2022-07-02: Version 0.7.0
  • Use deref_owned version 0.8.0
• 2022-07-01: Version 0.6.0
  • Use deref_owned version 0.7.0 (this changes bounds on Storable::AlignedRef)
• 2022-07-01: Version 0.5.0
  • Use deref_owned version 0.6.1
  • deref_owned::GenericCow and deref_owned::Owned are no longer re-exported

For older changes, refer to the CHANGELOG.md file.