MicroDB

A microsized database for use in programs with too much data for the RAM, but not necessarily for your next incredibly successful Discord clone (tho I suppose you could make that work too)* (correction below).

* So it turns out when I compared this against postgres in terms of speed, THIS WON BY MILES. And by miles, I mean a factor of about 160*2 (0.067ms vs 0.0004ms). So I suppose you can actually use this for your next Discord clone.

*2 So it turns out when I compared this here, I actually gave postgres an advantage! If I just access the items as booleans (a RawObj), I get a factor of 600! (0.067ms vs 0.0001ms). I'm honestly not sure how to react to this, but alright, I like it.

Completed features

• Disk storage
• Getting, setting, allocation, deallocation
• Caching
• Automatic recovery on error
• Serialization for basic types (numbers, strings, vecs, options, results)
• Easy-to-implement serialization
• Derivable serialization
• (maybe) Multi-client support over TCP
• (maybe) Mirroring operations to backup server (needs TCP)

How to use it

MicroDB runs where your application does: Saving, cache synchronization, etc all happen simply in another thread of your application.

To get started, create a DB:

let db = MicroDB::create(
    "example_db.data.mdb",
    "example_db.meta.mdb",
    MicroDB::sensible_cache_period(
        /*requests of unique objects per second*/10.0, 
        /*max ram usage*/0.1, 
        /*average object size in mb*/0.01, 
        /*safety (how important staying within ram spec is)*/1.0),
    MicroDB::sensible_block_size(
        /*object amount*/500.0, 
        /*average object size in bytes*/10_0000.0, 
        /*object size fluctuation in bytes*/0.0, 
        /*storage tightness*/1.0
    ),
)

Or load one using ::new and leave out the block_size arg.

And now you're good to go!