unistore 0.4.0

simple storage abstraction that works on wasm and native Targets
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

use serde::{Deserialize, Serialize};
use tracing::Level;
use unistore::{Error, UniStoreItem, static_store};

static_store!(get_store, "com", "example", "unistore");

#[derive(UniStoreItem, Serialize, Deserialize, PartialEq, Debug)]
#[unistore(store = get_store)]
struct Entry {
    #[unistore(key)]
    id: u32,
    #[unistore(index)]
    name: String,
}

#[cfg(target_arch = "wasm32")]
fn main() {
    panic!("This example is not supported on wasm32. Please run it in a native environment.");
}

#[cfg(not(target_arch = "wasm32"))]
#[tokio::main]
async fn main() {
    tracing_subscriber::fmt().with_max_level(Level::INFO).init();
    if let Err(e) = inner().await {
        eprintln!("Error: {e}");
    }
}

async fn inner() -> Result<(), Error> {
    let value = Entry {
        id: 1,
        name: "One".to_string(),
    };
    value.save().await?;
    let retrieved = Entry::get(1).await?;
    assert_eq!(retrieved.as_ref(), Some(&value));

    // the index can be used by the static method `get_by_index` with the index name and value
    let index_retrieved = Entry::get_by_index("name", "One").await?;
    assert_eq!(index_retrieved[0].0, 1);
    assert_eq!(&index_retrieved[0].1, &value);

    // the macro also generates a get method for each index
    let index_retrieved = Entry::get_by_name("One").await?;
    assert_eq!(index_retrieved[0].0, 1);
    assert_eq!(&index_retrieved[0].1, &value);

    // multiple entries can have the same index value
    // this is why the functions return a vector of tuples
    let value2 = Entry {
        id: 2,
        name: "One".to_string(),
    };
    value2.save().await?;
    let index_retrieved = Entry::get_by_name("One").await?;
    assert_eq!(index_retrieved.len(), 2);
    assert_eq!(index_retrieved[0].0, 1);
    assert_eq!(&index_retrieved[0].1, &value);
    assert_eq!(index_retrieved[1].0, 2);
    assert_eq!(&index_retrieved[1].1, &value2);

    Ok(())
}