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:").

Creates a connection pool with POOL_SIZE connections. Each connection is initialized with WAL mode, foreign keys, and synchronous=NORMAL. SQLite WAL mode allows concurrent readers while serializing writers.

Examples

use roboticus_db::Database;

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

pub fn conn(&self) -> PooledConnection

Gets a connection from the pool. Never blocks an async worker thread — the pool manages its own concurrency. Multiple readers can proceed in parallel; SQLite WAL serializes writers internally.

Panics if the pool is exhausted and the timeout expires. In practice this should never happen with POOL_SIZE=8 and short-lived connections.

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.