keyv 0.3.0

Simple key-value storage with support for multiple 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

#[cfg(feature = "sqlite")]
use keyv::{adapter::sqlite::SqliteStoreBuilder, Keyv};

#[cfg(feature = "sqlite")]
#[tokio::main]
async fn main() {
    // Instead of using a URI, we will use SQLite's in-memory database for testing purposes.
    let store = SqliteStoreBuilder::new()
        .uri("sqlite::memory:") // In-memory database, good for tests
        .table_name("cache") // Optional if you want to specify a different table name
        .build()
        .await
        .unwrap();

    let keyv = Keyv::try_new(store).await.unwrap();

    // Setting various types of data
    keyv.set("number", 42).await.unwrap(); // set initial value
    keyv.set("number", 10).await.unwrap(); // update value
    keyv.set("array", vec!["hello", "world"]).await.unwrap();
    keyv.set("string", "test value").await.unwrap();

    // Test retrieving and validating data
    match keyv.get("number").await.unwrap() {
        Some(number) => {
            let number: i32 = serde_json::from_value(number).unwrap(); // Deserialize
            println!("number: {}", number);
        }
        None => println!("number not found"),
    }

    match keyv.get("string").await.unwrap() {
        Some(string) => {
            let string: String = serde_json::from_value(string).unwrap(); // Deserialize
            println!("string: {}", string);
        }
        None => println!("string not found"),
    }

    match keyv.get("array").await.unwrap() {
        Some(array) => {
            let array: Vec<String> = serde_json::from_value(array).unwrap(); // Deserialize
            println!("array: {:?}", array);
        }
        None => println!("array not found"),
    }
}

#[cfg(not(feature = "sqlite"))]
fn main() {
    println!("This example requires the 'sqlite' feature to be enabled.");
    println!("Please run the command as follows:");
    println!("cargo run --example sqlite --features sqlite");
}