cache-mod 1.0.0

High-performance in-process caching with multiple eviction policies (LRU, LFU, TinyLFU, TTL, size-bounded). Async-safe, lock-minimized internals. Typed key-value API. No dependency on any external store.
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

//! Internal utilities shared across cache implementations.
//!
//! Nothing in this module is part of the public API.

use std::sync::{Mutex, MutexGuard};

/// Extension trait giving every cache a poison-tolerant `lock`.
///
/// A panic inside any operation that holds an inner `Mutex` poisons it.
/// The cache's invariants are not weakened by a poisoned lock — every
/// operation re-establishes consistency before returning — so we recover
/// the guard rather than propagating the poison upward as a user-visible
/// error.
pub(crate) trait MutexExt<T> {
    fn lock_recover(&self) -> MutexGuard<'_, T>;
}

impl<T> MutexExt<T> for Mutex<T> {
    fn lock_recover(&self) -> MutexGuard<'_, T> {
        match self.lock() {
            Ok(guard) => guard,
            Err(poisoned) => poisoned.into_inner(),
        }
    }
}