Struct Db 

pub struct Db { /* private fields */ }

The database dependency: a cloneable connection handle. Register app-wide with App::new().extend(db) (or .provide(db) — extend is the §6 seam).

Implementations

impl Db

pub async fn connect(url: &str) -> Result<Self>

Connect by URL: sqlite::memory:, sqlite://path.db, postgres://….

pub async fn from_env() -> Result<Self>

JERRYCAN_DATABASE_URL, defaulting to sqlite::memory: for dev.

pub fn conn(&self) -> &DatabaseConnection

The underlying sea-orm connection. Generated repos and migrations execute through this handle (execute_unprepared, query_one, …).

pub fn backend(&self) -> Backend

pub fn url(&self) -> &str

The URL this handle connected with. Extension crates (jerrycan-realtime) use it to open sessions the pool cannot serve: LISTEN connections, the replication socket, and long-held advisory-lock sessions.

pub fn sql(&self, query: &str) -> String

Backend-correct placeholders for a ?-style query string.

pub fn query_builder(&self) -> &'static dyn QueryBuilder

The sea-query builder matching this connection’s dialect. Generated repos pass it to build_any so one builder call renders correct SQL (placeholders, RETURNING, quoting) for whichever engine is connected.

impl Db

pub async fn migrate(&self, migrations: &[Migration]) -> Result<Vec<String>>

Apply pending migrations in slice order; returns the names applied. Tracking table _jerrycan_migrations remembers what ran. The whole run is atomic and concurrency-safe: it runs in one transaction guarded by a Postgres advisory lock, so several app instances booting at once can’t race the not-yet-applied check and double-apply the DDL — a failure rolls the entire run back (all-or-nothing; no half-migrated state).

pub async fn migrate_owned( &self, migrations: &[OwnedMigration], ) -> Result<Vec<String>>

Owned-migration twin of migrate — same runner.

Trait Implementations

impl Clone for Db

fn clone(&self) -> Db

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Extension for Db

fn register(self, app: App) -> App