beachcomber 0.4.0

A centralized daemon that caches shell state (git, battery, hostname, etc.) so every consumer reads from one fast cache instead of independently forking shells
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

use beachcomber::watcher::FsWatcher;
use std::fs;
use tempfile::TempDir;
use tokio::time::{Duration, timeout};

#[tokio::test]
async fn watcher_detects_file_creation() {
    let tmp = TempDir::new().unwrap();
    let (mut watcher, mut rx) = FsWatcher::new().expect("Failed to create watcher");
    watcher
        .watch(tmp.path())
        .expect("Failed to watch directory");

    fs::write(tmp.path().join("test.txt"), "hello").unwrap();

    let event = timeout(Duration::from_secs(2), rx.recv()).await;
    assert!(event.is_ok(), "Should receive event within timeout");
    let paths = event.unwrap().unwrap();
    assert!(!paths.is_empty(), "Event should have affected paths");
}

#[tokio::test]
async fn watcher_detects_file_modification() {
    let tmp = TempDir::new().unwrap();
    let file_path = tmp.path().join("test.txt");
    fs::write(&file_path, "initial").unwrap();

    let (mut watcher, mut rx) = FsWatcher::new().expect("Failed to create watcher");
    watcher
        .watch(tmp.path())
        .expect("Failed to watch directory");

    tokio::time::sleep(Duration::from_millis(100)).await;
    while rx.try_recv().is_ok() {}

    fs::write(&file_path, "modified").unwrap();

    let event = timeout(Duration::from_secs(2), rx.recv()).await;
    assert!(event.is_ok(), "Should receive modification event");
}

#[tokio::test]
async fn watcher_unwatch_stops_events() {
    let tmp = TempDir::new().unwrap();
    let (mut watcher, mut rx) = FsWatcher::new().expect("Failed to create watcher");

    watcher
        .watch(tmp.path())
        .expect("Failed to watch directory");
    watcher.unwatch(tmp.path()).expect("Failed to unwatch");

    fs::write(tmp.path().join("test.txt"), "hello").unwrap();

    let result = timeout(Duration::from_millis(500), rx.recv()).await;
    assert!(result.is_err(), "Should NOT receive events after unwatch");
}

#[tokio::test]
async fn watcher_multiple_paths() {
    let tmp1 = TempDir::new().unwrap();
    let tmp2 = TempDir::new().unwrap();

    let (mut watcher, mut rx) = FsWatcher::new().expect("Failed to create watcher");
    watcher.watch(tmp1.path()).expect("Failed to watch dir 1");
    watcher.watch(tmp2.path()).expect("Failed to watch dir 2");

    fs::write(tmp1.path().join("a.txt"), "a").unwrap();

    let event = timeout(Duration::from_secs(2), rx.recv()).await;
    assert!(event.is_ok(), "Should receive event from first watched dir");
}