Struct LazyFrankenDb 

pub struct LazyFrankenDb { /* private fields */ }

Lazy-opening wrapper for FrankenConnection (frankensqlite).

Constructing a LazyFrankenDb is cheap (no I/O). The underlying FrankenConnection is opened on the first call to [get]. Subsequent calls return the cached connection.

Implementations

impl LazyFrankenDb

pub fn new(path: PathBuf) -> Self

Create a lazy handle pointing at path. No I/O is performed.

pub fn from_overrides( data_dir: &Option<PathBuf>, db_override: Option<PathBuf>, ) -> Self

Resolve path from optional CLI overrides.

Uses data_dir / agent_search.db as fallback.

pub fn get(&self, reason: &str) -> Result<LazyFrankenDbGuard<'_>, LazyDbError>

Get the connection, opening the database on first access.

reason is logged alongside the open duration so callers can identify which command triggered the open.

pub fn get_with_timeout( &self, reason: &str, timeout: Duration, ) -> Result<LazyFrankenDbGuard<'_>, LazyDbError>

Get the connection with a timeout, opening the database on first access.

Like [get] but spawns the open in a background thread and waits up to timeout for it to complete. Returns LazyDbError::FrankenOpenFailed with a descriptive message if the timeout elapses. Fix for #128.

pub fn path(&self) -> &Path

Path to the database file (even if not yet opened).

pub fn is_open(&self) -> bool

Whether the connection has been opened.

Trait Implementations

impl Drop for LazyFrankenDb

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.