fcache 0.2.0

File caching library with lazy creation, automatic refresh, and callback-based initialization
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

mod common;

use std::sync::atomic::{AtomicUsize, Ordering};

use common::*;

#[test]
fn test_file_auto_refresh() -> anyhow::Result<()> {
    let i: AtomicUsize = AtomicUsize::new(0);

    // Create a new cache instance
    let cache = fcache::new()?.with_refresh_interval(Duration::ZERO); // Zero refresh interval to always refresh

    // Create a file in the cache
    let cache_file = cache.get_lazy("file.txt", move |mut file| {
        file.write_fmt(format_args!("{}", i.load(Ordering::SeqCst)))?;
        i.fetch_add(1, Ordering::SeqCst);
        Ok(())
    })?;

    // Read the initial content
    {
        let mut content = String::new();
        cache_file.open()?.read_to_string(&mut content)?;
        assert_eq!(content, "0");
    }

    // Refresh the file during the next access
    {
        let mut content = String::new();
        cache_file.open()?.read_to_string(&mut content)?;
        assert_eq!(content, "1");
    }

    Ok(())
}

#[test]
fn test_file_manual_refresh() -> anyhow::Result<()> {
    let i: AtomicUsize = AtomicUsize::new(0);

    // Create a new cache instance
    let cache = fcache::new()?.with_refresh_interval(Duration::MAX); // Max refresh interval to avoid auto-refresh

    // Create a file in the cache
    let cache_file = cache.get("file.txt", move |mut file| {
        file.write_fmt(format_args!("{}", i.load(Ordering::SeqCst)))?;
        i.fetch_add(1, Ordering::SeqCst);
        Ok(())
    })?;

    // Read the initial content
    {
        let mut content = String::new();
        cache_file.open()?.read_to_string(&mut content)?;
        assert_eq!(content, "0");
    }

    // Set to zero to allow immediate refresh
    let cache_file = cache_file.with_refresh_interval(Duration::ZERO);

    // Manually refresh the file
    cache_file.refresh()?;

    // Set to max to avoid auto-refresh
    let cache_file = cache_file.with_refresh_interval(Duration::MAX);

    // Read the content after manual refresh
    {
        let mut content = String::new();
        cache_file.open()?.read_to_string(&mut content)?;
        assert_eq!(content, "1");
    }

    Ok(())
}

#[test]
fn test_file_force_refresh() -> anyhow::Result<()> {
    let i: AtomicUsize = AtomicUsize::new(0);

    // Create a new cache instance
    let cache = fcache::new()?.with_refresh_interval(Duration::MAX); // Max refresh interval to avoid auto-refresh

    // Create a file in the cache
    let cache_file = cache.get("file.txt", move |mut file| {
        file.write_fmt(format_args!("{}", i.load(Ordering::SeqCst)))?;
        i.fetch_add(1, Ordering::SeqCst);
        Ok(())
    })?;

    // Read the initial content
    {
        let mut content = String::new();
        cache_file.open()?.read_to_string(&mut content)?;
        assert_eq!(content, "0");
    }

    // Force refresh the file
    cache_file.force_refresh()?;

    // Read the content after force refresh
    {
        let mut content = String::new();
        cache_file.open()?.read_to_string(&mut content)?;
        assert_eq!(content, "1");
    }

    Ok(())
}