Rustbreak is an Daybreak inspired self-contained file database. It is meant to be fast and simple to use. You add it to your application and it should just work for you. The only thing you will have to take care of is saving.
This library started out because of a need to be able to quickly write an application in rust that needed some persistence while still being able to write arbitrary data to it.
In Ruby there is Daybreak however for Rust there was no similar crate, until now!
Rustbreak makes several trade-offs to be easy to use and extend, so knowing of these drawbacks is important if you wish to use the library:
- The Database needs to fit into memory (Rustbreak cannot do partial loads/saves, so if the Database exceeds your available memory you will run OOM)
- Not all backends support atomic saves, so if your program crashes while it is saving you might save incomplete data (Notably only
PathBackendsupports atomic saves)
- Simple To Use, Fast, Secure
- Threadsafe
- Serde compatible storage (ron, bincode, or yaml included)
Add this to your Cargo.toml:
[dependencies.rustbreak]
version = "2"
features = ["ron_enc"] # You can also use "yaml_enc" or "bin_enc"
# Check the documentation to add your own!extern crate rustbreak;
use std::collections::HashMap;
use rustbreak::{MemoryDatabase, deser::Ron};
fn main() -> rustbreak::Result<()> {
let db = MemoryDatabase::<HashMap<u32, String>, Ron>::memory(HashMap::new())?;
println!("Writing to Database");
db.write(|db| {
db.insert(0, String::from("world"));
db.insert(1, String::from("bar"));
});
db.read(|db| {
// db.insert("foo".into(), String::from("bar"));
// The above line will not compile since we are only reading
println!("Hello: {:?}", db.get(&0));
})?;
Ok(())
}Usage is quite simple:
- Create/open a database using one of the Database constructors:
- Create a
FileDatabasewithFileDatabase::from_path. - Create a
MemoryDatabasewithMemoryDatabase::memory. - Create a
MmapDatabasewithMmapDatabase::mmaporMmapDatabase::mmap_with_sizewithmmapfeature. - Create a
DatabasewithDatabase::from_parts.
- Create a
Write/Readdata from the Database- Don't forget to run
saveperiodically, or whenever it makes sense.- You can save in parallel to using the Database. However you will lock write acess while it is being written to storage.
# use std::collections::HashMap;
use rustbreak::{MemoryDatabase, deser::Ron};
let db = MemoryDatabase::<HashMap<String, String>, Ron>::memory(HashMap::new(), Ron);
println!("Writing to Database");
db.write(|db| {
db.insert("hello".into(), String::from("world"));
db.insert("foo".into(), String::from("bar"));
});
db.read(|db| {
// db.insert("foo".into(), String::from("bar"));
// The above line will not compile since we are only reading
println!("Hello: {:?}", db.get("hello"));
});The following parts explain how to enable the respective features. You can also enable several at the same time.
If you would like to use yaml you need to specify yaml_enc as a feature:
[dependencies.rustbreak]
version = "2"
features = ["yaml_enc"]You can now use rustbreak::deser::Yaml as deserialization struct.
If you would like to use ron you need to
specify ron_enc as a feature:
[dependencies.rustbreak]
version = "2"
features = ["ron_enc"]You can now use rustbreak::deser::Ron as deserialization struct.
If you would like to use bincode you need to specify bin_enc as a feature:
[dependencies.rustbreak]
version = "2"
features = ["bin_enc"]You can now use rustbreak::deser::Bincode as deserialization struct.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent