modelvault 0.15.1

Application-focused embedded database for typed models — validation, migrations, nested objects, single-file deploy.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

#![cfg(feature = "async")]

use std::borrow::Cow;
use std::collections::BTreeMap;

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

#[tokio::test]
async fn async_in_memory_register_insert_get_delete_roundtrip() {
    let db = modelvault::AsyncDatabase::open_in_memory().await.unwrap();

    let fields = vec![
        FieldDef {
            path: FieldPath::new([Cow::Borrowed("title")]).unwrap(),
            ty: Type::String,
            constraints: vec![],
        },
        FieldDef {
            path: FieldPath::new([Cow::Borrowed("year")]).unwrap(),
            ty: Type::Int64,
            constraints: vec![],
        },
    ];
    let (cid, _v) = db
        .register_collection("books".to_string(), fields, "title".to_string())
        .await
        .unwrap();

    db.insert(cid, {
        let mut m = BTreeMap::new();
        m.insert("title".to_string(), RowValue::String("Hello".to_string()));
        m.insert("year".to_string(), RowValue::Int64(2020));
        m
    })
    .await
    .unwrap();

    let got = db
        .get(cid, ScalarValue::String("Hello".to_string()))
        .await
        .unwrap()
        .unwrap();
    assert_eq!(got.get("year"), Some(&RowValue::Int64(2020)));

    db.delete(cid, ScalarValue::String("Hello".to_string()))
        .await
        .unwrap();
    let got2 = db
        .get(cid, ScalarValue::String("Hello".to_string()))
        .await
        .unwrap();
    assert!(got2.is_none());
}

#[tokio::test]
async fn async_transaction_commits_on_ok_and_rolls_back_on_err() {
    let db = modelvault::AsyncDatabase::open_in_memory().await.unwrap();

    let fields = vec![FieldDef {
        path: FieldPath::new([Cow::Borrowed("title")]).unwrap(),
        ty: Type::String,
        constraints: vec![],
    }];
    let (cid, _v) = db
        .register_collection("books".to_string(), fields, "title".to_string())
        .await
        .unwrap();

    // Commit case.
    db.transaction(move |tx| {
        tx.insert(
            cid,
            BTreeMap::from([("title".to_string(), RowValue::String("A".to_string()))]),
        )?;
        Ok(())
    })
    .await
    .unwrap();

    // Rollback case.
    let res: Result<(), DbError> = db
        .transaction(move |tx| {
            tx.insert(
                cid,
                BTreeMap::from([("title".to_string(), RowValue::String("B".to_string()))]),
            )?;
            Err(DbError::NotImplemented)
        })
        .await;
    assert!(res.is_err());

    // Only A should exist.
    let a = db
        .get(cid, ScalarValue::String("A".to_string()))
        .await
        .unwrap();
    assert!(a.is_some());
    let b = db
        .get(cid, ScalarValue::String("B".to_string()))
        .await
        .unwrap();
    assert!(b.is_none());
}

#[tokio::test]
async fn async_open_on_disk_and_collection_names_work() {
    let dir = tempfile::tempdir().unwrap();
    let path = dir.path().join("t.modelvault");

    let db = modelvault::AsyncDatabase::open(path.clone()).await.unwrap();
    assert_eq!(db.collection_names().await.unwrap(), Vec::<String>::new());

    drop(db);
    // Re-open with explicit options after releasing the in-process writer slot.
    let db2 = modelvault::AsyncDatabase::open_with_options(path, OpenOptions::default())
        .await
        .unwrap();
    assert_eq!(db2.collection_names().await.unwrap(), Vec::<String>::new());
}