cachet 0.1.0

A composable, customizable multi-tier caching library with rich feature support.
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

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.

//! `get_or_insert`: fetch from cache, or compute and cache on miss.

use std::time::Duration;

use cachet::Cache;
use tick::Clock;

async fn fetch_from_db(id: &str, clock: &Clock) -> String {
    clock.delay(Duration::from_millis(10)).await; // simulate latency
    format!("User<{id}>")
}

#[tokio::main]
async fn main() {
    let clock = Clock::new_tokio();
    let cache = Cache::builder::<String, String>(clock.clone()).memory().build();

    let key = "user:1".to_string();

    // First call: cache miss, calls fetch_from_db
    let entry = cache
        .get_or_insert(&key, || fetch_from_db("1", &clock))
        .await
        .expect("get_or_insert failed");
    println!("first call: {}", entry.value());

    // Second call: cache hit, no fetch
    let entry = cache
        .get_or_insert(&key, || fetch_from_db("1", &clock))
        .await
        .expect("get_or_insert failed");
    println!("second call: {}", entry.value());
}