persistent-map 0.1.3

An easy-to-use, async, persistent key-value store for Rust, backed by SQLite and designed for extensibility with other storage backends.
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
123
124
125

#[cfg(feature = "sqlite")]
mod sqlite_persistence {
    use persistent_map::{PersistentMap, Result};
    use tempfile::tempdir;

    #[tokio::test]
    async fn test_sqlite_persistence() -> Result<()> {
        // Create a temporary directory for the test
        let dir = tempdir().unwrap();
        let db_path = dir.path().join("test_persistence.db");
        let db_path_str = db_path.to_str().unwrap();

        // First session: Create a map and insert data
        {
            let backend = persistent_map::sqlite::SqliteBackend::new(db_path_str).await?;
            let map: PersistentMap<String, String, _> = PersistentMap::new(backend).await?;

            // Insert some data
            map.insert("key1".to_string(), "value1".to_string()).await?;
            map.insert("key2".to_string(), "value2".to_string()).await?;

            // Ensure data is persisted
            map.flush().await?;

            // Map is dropped here, closing the connection
        }

        // Second session: Create a new map and verify data is still there
        {
            let backend = persistent_map::sqlite::SqliteBackend::new(db_path_str).await?;
            let map: PersistentMap<String, String, _> = PersistentMap::new(backend).await?;

            // Verify data was persisted
            assert_eq!(map.get(&"key1".to_string()), Some("value1".to_string()));
            assert_eq!(map.get(&"key2".to_string()), Some("value2".to_string()));
            assert_eq!(map.len(), 2);
        }

        // Clean up
        dir.close().unwrap();

        Ok(())
    }
}

#[cfg(feature = "csv_backend")]
mod csv_persistence {
    use persistent_map::{PersistentMap, Result};
    use tempfile::tempdir;

    #[tokio::test]
    async fn test_csv_persistence() -> Result<()> {
        // Create a temporary directory for the test
        let dir = tempdir().unwrap();
        let csv_path = dir.path().join("test_persistence.csv");
        let csv_path_str = csv_path.to_str().unwrap();

        // First session: Create a map and insert data
        {
            let backend = persistent_map::csv::CsvBackend::new(csv_path_str);
            let map: PersistentMap<String, String, _> = PersistentMap::new(backend).await?;

            // Insert some data
            map.insert("key1".to_string(), "value1".to_string()).await?;
            map.insert("key2".to_string(), "value2".to_string()).await?;

            // Ensure data is persisted
            map.flush().await?;

            // Map is dropped here
        }

        // Second session: Create a new map and verify data is still there
        {
            let backend = persistent_map::csv::CsvBackend::new(csv_path_str);
            let map: PersistentMap<String, String, _> = PersistentMap::new(backend).await?;

            // Verify data was persisted
            assert_eq!(map.get(&"key1".to_string()), Some("value1".to_string()));
            assert_eq!(map.get(&"key2".to_string()), Some("value2".to_string()));
            assert_eq!(map.len(), 2);
        }

        // Clean up
        dir.close().unwrap();

        Ok(())
    }
}

#[cfg(feature = "in_memory")]
mod in_memory_persistence {
    use persistent_map::{PersistentMap, Result};

    #[tokio::test]
    async fn test_in_memory_no_persistence() -> Result<()> {
        // First session: Create a map and insert data
        {
            let backend = persistent_map::in_memory::InMemoryBackend::new();
            let map: PersistentMap<String, String, _> = PersistentMap::new(backend).await?;

            // Insert some data
            map.insert("key1".to_string(), "value1".to_string()).await?;
            map.insert("key2".to_string(), "value2".to_string()).await?;

            // Ensure data is "persisted" (no-op for in-memory)
            map.flush().await?;

            // Map is dropped here
        }

        // Second session: Create a new map and verify data is NOT there (in-memory doesn't persist)
        {
            let backend = persistent_map::in_memory::InMemoryBackend::new();
            let map: PersistentMap<String, String, _> = PersistentMap::new(backend).await?;

            // Verify data was NOT persisted (in-memory doesn't persist)
            assert_eq!(map.get(&"key1".to_string()), None);
            assert_eq!(map.get(&"key2".to_string()), None);
            assert_eq!(map.len(), 0);
        }

        Ok(())
    }
}