Struct BoundedLruCache 

pub struct BoundedLruCache { /* private fields */ }

Capacity-bounded LRU cache with optional TTL per entry.

Wraps lru::LruCache behind a Mutex for thread safety. When the cache reaches capacity, the least-recently-used entry is evicted automatically. TTL is enforced on read: expired entries are treated as misses.

Example

use stygian_graph::adapters::cache::BoundedLruCache;
use stygian_graph::ports::CachePort;
use std::num::NonZeroUsize;
use std::time::Duration;

let cache = BoundedLruCache::new(NonZeroUsize::new(128).unwrap());
cache.set("k", "v".to_string(), Some(Duration::from_secs(60))).await.unwrap();
assert_eq!(cache.get("k").await.unwrap(), Some("v".to_string()));

Implementations

impl BoundedLruCache

pub fn new(capacity: NonZeroUsize) -> Self

Create a new bounded LRU cache with the given capacity.

Example

use stygian_graph::adapters::cache::BoundedLruCache;
use std::num::NonZeroUsize;

let cache = BoundedLruCache::new(NonZeroUsize::new(256).unwrap());

Trait Implementations

impl CachePort for BoundedLruCache

fn get<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get value from cache

fn set<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, value: String, ttl: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Set value in cache with optional TTL

fn invalidate<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Invalidate cache entry

fn exists<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Check if key exists in cache