Struct InstrumentedDriver 

pub struct InstrumentedDriver { /* private fields */ }

Test-only driver wrapper that instruments an underlying driver: it records every operation for later assertion and can inject faults (connection loss, etc.) to exercise error-handling paths.

Implementations

impl InstrumentedDriver

pub fn new(driver: Box<dyn Driver>) -> Self

pub fn with_capability(self, capability: &'static Capability) -> Self

Report capability to the engine instead of the inner driver’s own, so a test can watch how the engine plans for a backend it does not have. The inner driver still executes whatever the engine asks of it.

pub fn handle(&self) -> InstrumentedHandle

Get the single control handle for this driver. The handle exposes both the operations log and the fault-injection queue.

Trait Implementations

impl Debug for InstrumentedDriver

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

Formats the value using the given formatter.

impl Driver for InstrumentedDriver

fn url(&self) -> Cow<'_, str>

Returns the URL this driver is connecting to.

fn capability(&self) -> &'static Capability

Describes the driver’s capability, which informs the query planner.

fn connect<'life0, 'life1, 'async_trait>( &'life0 self, cx: &'life1 ConnectContext, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn Connection>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Creates a new connection to the database.

fn generate_migration(&self, schema_diff: &Schema<'_>) -> Migration

Generates a migration from a diff::Schema.

fn reset_db<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Drops the entire database and recreates an empty one without applying migrations.

fn max_connections(&self) -> Option<usize>

Returns the maximum number of simultaneous database connections supported. For example, this is Some(1) for the in-memory SQLite driver which cannot be pooled.