fondue 0.1.1

A Rust caching library with TTL, LRU, and namespace 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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

/// Cache macros
///
/// Cache lookup and insertion macro.
/// Usage: `cache!("namespace", "key", || compute_value())`
///
/// Expands to call `cache_get` with the provided namespace, key, and compute closure.
#[macro_export]
macro_rules! cache {
    ($ns:expr, $key:expr, $compute:expr) => {
        $crate::cache_get($ns, $key, $compute)
    };
}

/// Cache macro with TTL support.
/// Usage: `cache_with_ttl!("namespace", "key", "200ms", TtlType::Fixed, || compute_value())`
///
/// Parses the TTL string using `parse_duration` and calls `cache_get_with_ttl`.
#[macro_export]
macro_rules! cache_with_ttl {
    ($ns:expr, $key:expr, $ttl:expr, $ttl_type:expr, $compute:expr) => {
        $crate::cache_get_with_ttl(
            $ns,
            $key,
            $crate::parse_duration($ttl).expect("Invalid TTL"),
            $ttl_type,
            $compute,
        )
    };
}

/// Cache macro with limit support specifying maximum entries.
/// Usage: `cache_with_limit!("namespace", "key", 10, || compute_value())`
///
/// Calls `cache_get_with_limit` with provided parameters.
#[macro_export]
macro_rules! cache_with_limit {
    ($ns:expr, $key:expr, $limit:expr, $compute:expr) => {
        $crate::cache_get_with_limit($ns, $key, $limit, $compute)
    };
}

/// Cache macro with both TTL and limit support.
/// Usage: `cache_with_ttl_and_limit!("namespace", "key", "500ms", 5, TtlType::Sliding, || compute_value())`
///
/// Parses TTL string and calls `cache_get_with_ttl_and_limit`.
#[macro_export]
macro_rules! cache_with_ttl_and_limit {
    ($ns:expr, $key:expr, $ttl:expr, $limit:expr, $ttl_type:expr, $compute:expr) => {
        $crate::cache_get_with_ttl_and_limit(
            $ns,
            $key,
            $crate::parse_duration($ttl).expect("Invalid TTL"),
            $limit,
            $ttl_type,
            $compute,
        )
    };
}