Struct SqliteCache 

pub struct SqliteCache { /* private fields */ }

SQLite cache backend. Cheap to clone (Arc<Mutex<Connection>> shared).

Implementations

impl SqliteCache

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

Open (or create) the cache database at path. Creates the parent directory if needed and applies the schema on first use.

Errors

• CacheError::Io when the parent directory cannot be created.
• CacheError::Backend when rusqlite cannot open the file or apply the schema.

pub fn in_memory() -> Result<Self>

Open an in-memory cache. Convenient for tests; data is lost on drop.

Errors

CacheError::Backend when rusqlite cannot open the in-memory connection or apply the schema (extremely unlikely in practice).

Trait Implementations

impl Cache for SqliteCache

fn record_batch<'life0, 'async_trait>( &'life0 mut self, events: Vec<BuildEvent>, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Override the default Cache::record_batch impl with a single SQLite transaction so the whole layer’s events land atomically. Without this the default loops record and any crash mid-batch leaves the cache half-updated.

fn last_build<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 ActionId, ) -> Pin<Box<dyn Future<Output = Option<BuildEvent>> + Send + 'async_trait>>

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

Last recorded event for id, or None if the action has never run.

fn last_record<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 ActionId, ) -> Pin<Box<dyn Future<Output = Option<BuildRecord>> + Send + 'async_trait>>

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

Same as Self::last_build, plus whatever storage metadata the backend tracks — currently just the write time.

fn record<'life0, 'async_trait>( &'life0 mut self, ev: BuildEvent, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Persist event. After success, Self::last_build for the event’s id must return this event.

impl Clone for SqliteCache

fn clone(&self) -> SqliteCache

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.