easy_safe 0.1.9

an easy way to save string values on disk, in short -string maps on disk-
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

/// easy_safe
/// yes it is not easy_save since this crate also wants to be safe to use while saving I called
/// it easy_safe
///
/// This is a crate that should make it possible to save and load strings with keys from disk
/// It works as a map and actually wraps a map
/// It keeps the ownership model as you know it
/// but you may always call create_or_load_map_env("somename")
/// at any place in your code, with the same name it was first being called
/// This makes it possible to leak data through places where the data should not be
/// as you can imagine, you should be careful to not trying to use multiple environments concurrently


/// # Example
/// ```
/// use easy_safe::{create_or_load_map_env, MapEnv};
///
/// let mut  map_env: MapEnv = create_or_load_map_env("somename");
/// map_env.put("somekey", "somevalue");
/// let value = map_env.get("somekey").unwrap();
/// assert_eq!(value, "somevalue");
/// ```


/// map environment
mod mapenv;
pub use crate::mapenv::disk_pers::{create_or_load_map_env, MapEnv, create_or_load_late_save_map_env, LateSaveMapEnv};

extern crate core;

#[cfg(test)]
mod tests {
    use std::fs;
    use crate::{create_or_load_late_save_map_env, LateSaveMapEnv};
    use crate::mapenv::disk_pers::{create_or_load_map_env, MapEnv};

    fn clear_files(name: &str) {
        if fs::remove_file(name).is_ok() {};
    }

    #[test]
    fn create_env_and_check_name() {
        let map_env: MapEnv = create_or_load_map_env("name1");
        assert_eq!(map_env.get_name(), "name1");
        clear_files("name1");
    }

    #[test]
    fn create_env_put_and_get() {
        let mut map_env: MapEnv = create_or_load_map_env("name2");
        map_env.put("somekey", "somevalue");
        let value = map_env.get("somekey").unwrap();
        assert_eq!(value, "somevalue");
        clear_files("name2");
    }

    #[test]
    fn create_env_put_and_delete() {
        let mut map_env: MapEnv = create_or_load_map_env("name4");
        map_env.put("somekey", "somevalue");
        map_env.delete("somekey");
        let value = map_env.get("somekey");
        assert_eq!(value, None);
        clear_files("name4");
    }

    #[test]
    fn create_env_and_check_name_with_late_save() {
        let map_env: LateSaveMapEnv = create_or_load_late_save_map_env("name6");
        assert_eq!(map_env.get_name(), "name6");
        clear_files("name6");
    }

    #[test]
    fn create_env_put_and_get_with_late_save() {
        let mut map_env: LateSaveMapEnv = create_or_load_late_save_map_env("name7");
        map_env.put("somekey", "somevalue");
        map_env.save();

        let mut new_map_env_instance: LateSaveMapEnv = create_or_load_late_save_map_env("name7");

        let value = new_map_env_instance.get("somekey").unwrap();
        assert_eq!(value, "somevalue");
        clear_files("name7");
    }

    #[test]
    fn create_env_put_and_get_with_late_save_without_saving_to_disk() {
        let mut map_env: LateSaveMapEnv = create_or_load_late_save_map_env("name8");
        map_env.put("somekey", "somevalue");
        /// map_env.save();

        let mut new_map_env_instance: LateSaveMapEnv = create_or_load_late_save_map_env("name8");

        let value = new_map_env_instance.get("somekey");
        assert_eq!(value, None);
        clear_files("name8");
    }


}