Struct Database 

pub struct Database { /* private fields */ }

Implementations

impl Database

pub fn new(path: &str) -> Result<Self>

Opens a new database at the given path (or in-memory if ":memory:").

Examples

use roboticus_db::Database;

let db = Database::new(":memory:").unwrap();
// database is now ready for use

pub fn conn(&self) -> MutexGuard<'_, Connection>

Acquires the database connection mutex, recovering from poison if a prior holder panicked.

Rationale: the Connection is a handle to a WAL-mode SQLite database. If a thread panics mid-transaction, SQLite’s journal automatically rolls back uncommitted changes on the next access, so the database file is never left in a corrupt state. Propagating the poison would make the entire database permanently unavailable for all threads, which is worse than allowing the next caller to proceed with a connection that SQLite has already self-healed.

Trait Implementations

impl Clone for Database

fn clone(&self) -> Database

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Database

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

Formats the value using the given formatter.