Struct SourceCache 

pub struct SourceCache { /* private fields */ }

Thread-safe cache for resolved source data.

Provides an in-memory layer with optional SQLite-backed disk persistence and optional TTL-based expiration.

Implementations

impl SourceCache

pub fn new() -> Self

Create a new in-memory-only cache (no TTL).

pub fn with_ttl(ttl: Duration) -> Self

Create a new in-memory-only cache with a TTL. Entries older than ttl are considered expired and will not be returned.

pub fn with_sqlite(path: &Path) -> Result<Self, String>

Create a cache backed by a SQLite database at the given path.

The table is created if it does not exist. Existing cached values are loaded into memory on construction.

pub fn with_sqlite_and_ttl( path: &Path, ttl: Option<Duration>, ) -> Result<Self, String>

Create a SQLite-backed cache with an optional TTL.

pub fn store(&self, source_id: &str, value: &Value)

Store a resolved value in the cache (memory + disk if available).

pub fn get(&self, source_id: &str) -> Option<Value>

Retrieve a cached value for a source. Returns None if no entry exists or if the entry has expired (when TTL is set).

pub fn invalidate(&self, source_id: &str)

Remove a cached entry (memory + disk).

pub fn clear(&self)

Clear all cached entries (memory + disk).

pub fn evict_expired(&self)

Remove all expired entries from the cache (memory + disk). Only meaningful when a TTL is configured.

pub fn len(&self) -> usize

Returns the number of cached entries (including potentially expired ones).

pub fn is_empty(&self) -> bool

Returns true if the cache is empty.

pub fn ttl(&self) -> Option<Duration>

Returns the configured TTL, if any.

Trait Implementations

impl Default for SourceCache

fn default() -> Self

Returns the “default value” for a type.