beachcomber 0.5.1

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
use beachcomber::cache::Cache;
use beachcomber::provider::{ProviderResult, Value};

/// Test 1: A fresh entry with an interval is not stale.
#[test]
fn fresh_entry_is_not_stale() {
    let cache = Cache::new();
    let mut result = ProviderResult::new();
    result.insert("value", Value::String("hello".to_string()));

    // Put with a 60-second interval — entry is brand new, should not be stale.
    cache.put_with_interval("myprov", None, result, Some(60));

    let entry = cache.get("myprov", None).unwrap();
    assert!(
        !entry.is_stale(),
        "Freshly written entry should not be stale"
    );
}

/// Test 2: An entry whose age exceeds the interval is stale.
/// We use an interval of 0 seconds so any elapsed time makes it stale.
#[test]
fn expired_entry_is_stale() {
    let cache = Cache::new();
    let mut result = ProviderResult::new();
    result.insert("value", Value::String("hello".to_string()));

    // Interval of 0 seconds means the entry is immediately stale after any elapsed time.
    cache.put_with_interval("myprov", None, result, Some(0));

    // Sleep just enough to ensure elapsed > 0 seconds (i.e. >= 1s is not needed;
    // elapsed().as_secs() > 0 requires at least 1s, so we use a 1ms sleep but
    // the check is > interval_secs, so with interval=0 even 1ms elapsed gives
    // elapsed.as_secs()=0 which is NOT > 0. Use interval=0 and rely on:
    // is_stale checks elapsed.as_secs() > interval, so we need elapsed >= 1s.
    // Instead, use interval of 0 and sleep 1100ms to guarantee staleness.
    std::thread::sleep(std::time::Duration::from_millis(1100));

    let entry = cache.get("myprov", None).unwrap();
    assert!(
        entry.is_stale(),
        "Entry older than its interval should be stale"
    );
}

/// Test 3: An entry stored with no interval (e.g. Once providers) is never stale.
#[test]
fn no_interval_entry_is_never_stale() {
    let cache = Cache::new();
    let mut result = ProviderResult::new();
    result.insert("value", Value::String("hello".to_string()));

    // put() sets interval to None.
    cache.put("myprov", None, result);

    let entry = cache.get("myprov", None).unwrap();
    assert!(
        !entry.is_stale(),
        "Entry with no interval should never be stale"
    );
}