Trait FileCache 

pub trait FileCache<V> {
    // Required methods
    async fn get(&self, key: &str) -> Result<Option<V>>;
    async fn get_stale(&self, key: &str) -> Result<Option<V>>;
    async fn set(&self, key: &str, value: &V) -> Result<()>;
    async fn remove(&self, key: &str) -> Result<()>;
}

Trait for TTL-based filesystem caching.

Provides a unified interface for caching serializable data with time-to-live validation.

async_fn_in_trait is suppressed because this trait is re-exported for use by crate consumers but is never intended to be implemented externally or used as dyn FileCache. All known implementors are in this crate, so auto-trait bounds are not a concern.

Required Methods

async fn get(&self, key: &str) -> Result<Option<V>>

Get a cached value if it exists and is valid.

Arguments

• key - Cache key (filename without extension)

Returns

The cached value if it exists and is within TTL, None otherwise.

async fn get_stale(&self, key: &str) -> Result<Option<V>>

Get a cached value regardless of TTL (stale fallback).

Arguments

• key - Cache key (filename without extension)

Returns

The cached value if it exists, None otherwise.

async fn set(&self, key: &str, value: &V) -> Result<()>

Set a cached value.

Arguments

• key - Cache key (filename without extension)
• value - Value to cache

async fn remove(&self, key: &str) -> Result<()>

Remove a cached value.

Arguments

• key - Cache key (filename without extension)

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl<V> FileCache<V> for FileCacheImpl<V>

where V: Serialize + for<'de> Deserialize<'de>,