modelvault (Rust facade)

Application-focused embedded database

Schema-first typed storage for application models. The recommended Rust crate for ModelVault — the database for application models.

• Model-driven schemas — collections from field definitions or #[derive(DbModel)]
• Validation on write — types and constraints enforced before persistence
• Migrations — schema catalog versioning and compatibility helpers
• Nested objects — typed multi-segment field paths
• Single-file deploy — on-disk .modelvault or in-memory for tests

Documentation: modelvault.readthedocs.io · rustdoc: docs.rs/modelvault

Install

[dependencies]
modelvault = "0.15"

Features: derive (default, #[derive(DbModel)]) · async (AsyncDatabase on a thread pool with concurrent reads and exclusive writes — experimental) — see async policy.

Example

cargo run -p modelvault --example open

use std::borrow::Cow;

use modelvault::prelude::*;
use modelvault::schema::FieldPath;
use modelvault::FieldDef;
use modelvault::Type;

fn main() -> Result<(), DbError> {
    let mut db = Database::open_in_memory()?;
    println!("opened: {}", db.path().display());
    let (id, ver) = db.register_collection(
        "books",
        vec![FieldDef {
            path: FieldPath::new([Cow::Borrowed("title")])?,
            ty: Type::String,
            constraints: vec![],
        }],
        "title",
    )?;
    println!("registered collection id={} version={}", id.0, ver.0);
    Ok(())
}

Output:

opened: :memory:
registered collection id=1 version=1

DbModel and nested schemas: Models & collections

Related crates

License

MIT — LICENSE