Struct ReaderGuard 

pub struct ReaderGuard<'pool> { /* private fields */ }

A reader connection checked out from the pool. Returns the connection to the pool on drop.

Implementations

impl<'pool> ReaderGuard<'pool>

pub fn query_row<T, P, F>( &self, sql: &str, params: P, f: F, ) -> Result<T, SqliteError>

where P: Params, F: FnOnce(&ReaderRow<'_, '_>) -> Result<T>,

Run one read-only statement against this reader lease and map the first resulting row, for callers outside khive-db.

Unlike a raw Connection, this never hands out a capability that can change connection-local or database state: sql is checked against the same allow-listed read-shape classifier (SELECT/WITH ... SELECT/VALUES/EXPLAIN/a fixed read-only PRAGMA set) the pooled SqlReader surface admits raw SQL through, and anything else — BEGIN, DML, DDL, a setting PRAGMA, ATTACH — is refused before it ever reaches SQLite. An admitted statement still marks the checkout dirty unconditionally, so Drop always pays the pristine-state scan (or, in degraded shared-lease mode, the settings/rollback verification) on return.

SQL stepping cooperatively observes the current request’s cancellation and original absolute deadline. Synchronous mapper/native callback code cannot be forcibly preempted; a post-check refuses a successful result if the request stopped while that code ran.

Trait Implementations

impl<'pool> Drop for ReaderGuard<'pool>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.