Crate smolldb

SmollDB

Small in-memory key value database for rust

This is a small in-memory key-value database, which can be easly backed up in a file or stream and later loaded from it

It ain’t much but it’s honest work

This database is nothing but an hashmap, it already comes with function to easly load and save the hashmap on file though, so you don’t have to implement it. It also compress it in a Zlib compatible format

Inspired by Pickles

This crate was inspired by pickleDB and it works in similars use cases

Now with streams

since 0.4.0

You can use function SmollDB::load_from_stream to load from anything that implements std::io::Read, and you can use SmollDB::backup_to_stream to backup on antything that implements std::io::Write

Some examples

Basic use

use smolldb::{DataType, SmollDB};
 
let mut db = SmollDB::default();
 
db.set("Nome", "Mario".to_string());
db.set("Eta", 34_i16);
db.set("Stinky", true);
db.set("Height", 23.3_f32);
db.set("CF", vec![0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
 
assert_eq!(DataType::STRING("Mario".to_string()),*(db.get(&"Nome").unwrap()));
assert_eq!(DataType::INT16(34_i16), *(db.get(&"Eta").unwrap()));
assert_eq!(DataType::BOOL(true), *(db.get(&"Stinky").unwrap()));
assert_eq!(DataType::FLOAT32(23.3_f32), *(db.get(&"Height").unwrap()));
assert_eq!(DataType::BYTES(vec![0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]),*(db.get(&"CF").unwrap()));

Loading from file

use smolldb::{DataType, SmollDB};

let mut db = SmollDB::default();
 
db.set("bool", false);
db.set("int8", 8_i8);
db.set("int16", 8_i16);
db.set("int32", 8_i32);
db.set("int64", 8_i64);
db.set("float32", 4_f32);
db.set("float64", 4_f64);
db.set("string", String::from("8_i8"));
db.set("bytes",vec![1, 2, 3, 4, 5, 6, 7, 8, 243, 123,46, 11, 123, 65, 2, 3, 5, 7, 2,],);
db.backup(&"database").unwrap();
 
let db_copy = SmollDB::load(&"database").unwrap();
 
assert_eq!(db, db_copy);

Load and backup from stream

use smolldb::{DataType, SmollDB};
use std::fs::{OpenOptions};
use std::io::{Seek};
 
let mut database = SmollDB::default();
let mut stream = OpenOptions::new().create(true).read(true).write(true).open("myfile.smoll").unwrap();
let data = String::from("data");
let key = String::from("example");
 
database.set(key.clone(), data.clone());
database.backup_to_stream(&mut stream).unwrap();
stream.seek(std::io::SeekFrom::Start(0)).unwrap();
 
let database = SmollDB::load_from_stream(&mut stream).unwrap();
let result = database.get(&key).unwrap();
 
assert_eq!(*result, DataType::STRING(data));

since 0.4.2

You can use SmollDB::extract to automatically convert from datetype to the inner type

use smolldb::{DataType, SmollDB};
 
let mut db = SmollDB::default();
let str1 = String::from("Mario");

db.set("Nome", "Mario".to_string());

let str2 : &String = db.extract(&"Nome").unwrap().unwrap();

assert_eq!(str2,&str1)

Structs

SmollDB

Object to represent the in memory database

Enums

DataType

A union for all the types supported by smolldb

Error

Error type for smolldb

Type Aliases

Result