Struct ApiCache 

pub struct ApiCache { /* private fields */ }

Cache for API responses backed by a local SQLite database.

Implementations

impl ApiCache

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Open or create cache at the given path.

pub fn open_read_only(path: impl AsRef<Path>) -> Result<Self>

Open an existing cache in read-only mode without initializing schema.

pub fn open_in_memory() -> Result<Self>

Create an in-memory cache (for testing).

pub fn with_ttl(self, ttl: Duration) -> Self

Set the default TTL for cache entries.

pub fn with_max_size(self, max_size_bytes: u64) -> Self

Create a cache with a maximum size limit.

pub fn get<T: DeserializeOwned>(&self, key: &str) -> Result<Option<T>>

Get a cached value if it exists and hasn’t expired.

pub fn set<T: Serialize>(&self, key: &str, value: &T) -> Result<()>

Store a value in the cache.

pub fn set_with_ttl<T: Serialize>( &self, key: &str, value: &T, ttl: Duration, ) -> Result<()>

Store a value with a custom TTL.

pub fn contains(&self, key: &str) -> Result<bool>

Check if a key exists and hasn’t expired.

pub fn cleanup_expired(&self) -> Result<usize>

Remove expired entries from the cache.

pub fn count_older_than(&self, cutoff: DateTime<Utc>) -> Result<usize>

Count entries cached before the given cutoff.

pub fn cleanup_older_than(&self, cutoff: DateTime<Utc>) -> Result<usize>

Remove entries cached before the given cutoff.

pub fn clear(&self) -> Result<()>

Clear all entries from the cache.

pub fn stats(&self) -> Result<CacheStats>

Get cache statistics.

pub fn inspect(&self) -> Result<CacheInspection>

Inspect cache statistics and entry timestamp bounds.

Trait Implementations

impl Debug for ApiCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.