modelvault-core 0.16.0

Core engine for ModelVault — application-focused embedded storage with model schemas, validation, and migrations.
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

use std::fs;

use modelvault_core::Database;
use modelvault_core::DbError;

#[test]
fn open_writes_header_on_new_file() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("new.modelvault");

    let mut db = Database::open(&path).expect("open");
    let bytes = db.read_image_for_test().expect("read");
    assert!(bytes.len() >= 4);
    assert_eq!(&bytes[0..4], b"TDB0");
}

#[test]
fn open_validates_header_on_reopen() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("reopen.modelvault");

    {
        let _a = Database::open(&path).expect("open a");
    }
    let _b = Database::open(&path).expect("open b");
}

#[test]
fn open_non_modelvault_file_returns_format_error() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("not_modelvault.modelvault");

    fs::write(&path, b"NOPE").expect("write");
    let res = Database::open(&path);
    assert!(matches!(res, Err(DbError::Format(_))));
}

#[test]
fn open_wrong_magic_with_full_header_returns_format_error() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("bad_magic.modelvault");

    // Make the file long enough to pass the truncated-header check, but with wrong magic.
    let mut bytes = vec![0u8; 32];
    bytes[0..4].copy_from_slice(b"NOPE");
    fs::write(&path, bytes).expect("write");

    let res = Database::open(&path);
    assert!(matches!(res, Err(DbError::Format(_))));
}

#[test]
fn open_unsupported_version_returns_format_error() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("bad_version.modelvault");

    let mut bytes = vec![0u8; 32];
    bytes[0..4].copy_from_slice(b"TDB0");
    // major=9, minor=9 in little-endian at offsets 4..8
    bytes[4] = 9;
    bytes[6] = 9;
    fs::write(&path, bytes).expect("write");

    let res = Database::open(&path);
    assert!(matches!(res, Err(DbError::Format(_))));
}

#[test]
fn open_truncated_file_returns_format_error() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("truncated.modelvault");

    // Non-empty but shorter than the header size.
    fs::write(&path, b"T").expect("write");
    let res = Database::open(&path);
    assert!(matches!(res, Err(DbError::Format(_))));
}

#[test]
fn open_does_not_overwrite_existing_header() {
    let dir = tempfile::tempdir().expect("tempdir");
    let path = dir.path().join("no_overwrite.modelvault");

    let bytes = {
        let mut db = Database::open(&path).expect("open");
        let mut bytes = db.read_image_for_test().expect("read");
        assert!(bytes.len() >= 32);

        // Mutate a byte in the header to simulate some future header field changes
        // (while keeping the magic intact so open() continues to read/validate).
        bytes[20] ^= 0b1010_1010;
        bytes
    };
    fs::write(&path, &bytes).expect("write mutated header");

    let mut db2 = Database::open(&path).expect("open again");
    let bytes2 = db2.read_image_for_test().expect("read again");
    assert_eq!(bytes2, bytes);
}