Crate lazy_db

source ·
Expand description

A simple, bare-bones and lazily loaded database for small projects

Concepts

This will be quite short as lazy-db is bare-bones.

  • LazyDB

    • An obstraction of a LazyContainer that makes sure that incompatible databases won’t be corrupted by incompatible versions of lazy-db
    • The actual ‘Lazy Database’

  • LazyData

    • Binary files that only support the primative types; nothing more nothing less

  • LazyContainer

    • A collection of LazyData, think of it like an object from OOP or a directory in a file system
    • An abstaction of the underlying filesystem directory

Examples

Some basic usage

Here is a really basic LazyDB that holds some information about a hypothetical person named ‘Dave’

use lazy_db::*;
 
let path = "example_db"; // path to the database
let database = LazyDB::init_db(path).unwrap(); // initialise the database
 
// Writing to the database with a concise macro
// The individual containers are separated by `/` while the `LazyData` is separted with `::`.
// The assigning `=` sign indicates the `LazyData` that is being written to the path
// The function after the `=` sign is formatted like this: new_<primative_type>
write_database!((&database) /people/Dave::fav_colour = new_string("Blue")).unwrap();
write_database!((&database) /people/Dave::age = new_u8(21)).unwrap();
write_database!((&database) /people/Dave::unemployed = new_bool(true)).unwrap();
 
// Reading from the database with a concise macro
// Same path as before
// The search macro only creates a `LazyData` object, you must collect it with a collect function formatted like this: collect_<primative>
let fav_colour: String = search_database!((&database) /people/Dave::fav_colour).unwrap().collect_string().unwrap();
let age: u8 = search_database!((&database) /people/Dave::age).unwrap().collect_u8().unwrap();
let unemployed: bool = search_database!((&database) /people/Dave::unemployed).unwrap().collect_bool().unwrap();

Re-exports

Modules

Macros

Constants