amethystate 0.11.0

Type-safe reactive persistence for Rust GUI apps
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

use amethystate::store::Store;
use amethystate::store::builder::StoreBuilder;
use amethystate::{ReactiveMap, amethystate};
use amethystate_core::test_utils::unique_path;

mod before {
    use super::*;

    #[amethystate(prefix = "seed")]
    pub struct Cfg {
        #[amestate(default = {"a": 1u64})]
        pub first: ReactiveMap<String, u64>,
    }
}

#[amethystate(prefix = "seed")]
pub struct Cfg {
    #[amestate(default = {"a": 1u64})]
    pub first: ReactiveMap<String, u64>,

    #[amestate(default = {"x": 10u64, "y": 20u64})]
    pub second: ReactiveMap<String, u64>,
}

/// The initialized flag used to be one per scope, set when the struct was first
/// built, so a map added to that struct later never seeded its defaults for
/// anyone already running - it came up empty with nothing to say why.
#[test]
fn a_map_added_later_still_gets_its_defaults() {
    let path = unique_path("map_defaults_added");

    {
        let store = StoreBuilder::new(&path).build().unwrap();
        let old = before::Cfg::new_with(&store).unwrap();
        assert_eq!(old.first().len().unwrap(), 1);
        store.save_now().unwrap();
    }

    let store = StoreBuilder::new(&path).build().unwrap();
    let cfg = Cfg::new_with(&store).unwrap();

    assert_eq!(
        cfg.second().keys().unwrap(),
        ["x", "y"],
        "the map added in this version must be seeded"
    );
    assert_eq!(cfg.first().keys().unwrap(), ["a"]);
}

/// Upgrading must not undo removals: keys already on disk count as evidence the
/// map was seeded before, so its defaults are not written again.
#[test]
fn upgrading_does_not_restore_a_removed_entry() {
    let path = unique_path("map_defaults_removed");

    {
        let store = StoreBuilder::new(&path).build().unwrap();
        let cfg = Cfg::new_with(&store).unwrap();
        cfg.second().remove("x".to_string()).unwrap();
        assert_eq!(cfg.second().keys().unwrap(), ["y"]);
        store.save_now().unwrap();
    }

    let store = StoreBuilder::new(&path).build().unwrap();
    let cfg = Cfg::new_with(&store).unwrap();

    assert_eq!(cfg.second().keys().unwrap(), ["y"], "x stays removed");
}

#[test]
fn a_fresh_store_seeds_every_map() {
    let path = unique_path("map_defaults_fresh");
    let store = StoreBuilder::new(&path).build().unwrap();
    let cfg = Cfg::new_with(&store).unwrap();

    assert_eq!(cfg.first().keys().unwrap(), ["a"]);
    assert_eq!(cfg.second().keys().unwrap(), ["x", "y"]);
}