3 stable releases
1.3.10 | Oct 3, 2024 |
---|---|
1.3.9 | Jul 19, 2024 |
1.3.8 | May 10, 2024 |
#50 in Database implementations
195 downloads per month
1MB
11K
SLoC
bbolt-rs
bbolt-rs is an implementation of the etcd-io/bbolt database in Rust. It successfully reads and commits, but it has some limitations.
The current version matches Bolt v1.3.10.
I'm rather pleased with my work as I believe the public API I've created has substantially fewer footguns than the Go code has.
- The database can't be dropped until all sessions are dropped.
- No resources from the transaction can escape the transaction.
- You can't deadlock the database by opening up a RW transaction and then opening up a R transaction right afterwards.
It also is interesting that, despite the increased memory usage, this code is about 90% faster in a synthetic large transaction than the equivalent Go code. Further benchmarking is postponed until the database is fully feature complete and we can have a proper duel (in progress!).
Lastly, I must express my eternal gratitude to the bbolt developers who have created such a simple and easy to understand project to learn from.
Features:
- Arena memory allocation per transaction
- Explicitly designed to prevent transaction dependant resources from escaping the transaction.
- RwLock based transactions
- File backed database
- Memory backed database
- Miri tested to prevent memory errors in unsafe blocks
- Simple and straightforward public APIs
Currently not supported:
- Tx.copy
- Most of the main application
- A variety of DB Options including
- no freelist sync
- file open timeout
- Panic handling during bench
Dependencies
~7–17MB
~233K SLoC