19 stable releases

new 1.9.0 Apr 19, 2025
1.8.0 Mar 29, 2025
1.5.5 Feb 21, 2025
1.4.0 Dec 4, 2024
0.0.1 Mar 12, 2024

#41 in Database implementations

Download history 295/week @ 2024-12-28 788/week @ 2025-01-04 796/week @ 2025-01-11 620/week @ 2025-01-18 717/week @ 2025-01-25 1036/week @ 2025-02-01 1115/week @ 2025-02-08 1516/week @ 2025-02-15 1250/week @ 2025-02-22 969/week @ 2025-03-01 1044/week @ 2025-03-08 681/week @ 2025-03-15 1756/week @ 2025-03-22 1714/week @ 2025-03-29 1373/week @ 2025-04-05 1146/week @ 2025-04-12

6,127 downloads per month
Used in 22 crates (via lsm-tree)

MIT/Apache

110KB
2.5K SLoC

CI docs.rs Crates.io MSRV dependency status

Generic value log implementation for key-value separated storage, inspired by RocksDB's BlobDB [1] and Titan [2] and implemented in safe, stable Rust.

Note

This crate is intended as a building block for key-value separated storage. You probably want to use https://github.com/fjall-rs/fjall instead.

Features

  • Thread-safe API
  • 100% safe & stable Rust
  • Supports generic KV-index structures (LSM-tree, ...)
  • Generic per-blob compression (optional)
  • In-memory blob cache for hot data (can be shared between multiple value logs to cap memory usage)
  • On-line garbage collection

Keys are limited to 65536 bytes, values are limited to 2^32 bytes.

Feature flags

serde

Enables serde derives.

Disabled by default.

bytes

Uses bytes as the underlying Slice type.

Disabled by default.

Stable disk format

The disk format is stable as of 1.0.0.

License

All source code is licensed under MIT OR Apache-2.0.

All contributions are to be licensed as MIT OR Apache-2.0.

Footnotes

[1] https://github.com/facebook/rocksdb/wiki/BlobDB

[2] https://docs.pingcap.com/tidb/stable/titan-overview/

Dependencies

~2–11MB
~144K SLoC