Struct TestDb 

pub struct TestDb { /* private fields */ }

A database created for one test and dropped when the test is done.

Implementations

impl TestDb

pub async fn create(admin: &PgBackend) -> Result<TestDb, RelError>

Create an empty database on the server admin is connected to and connect to it (a pool of up to 8 connections, the admin connection’s options otherwise).

pub fn name(&self) -> &str

The database’s name (persistant_test_...).

pub fn backend(&self) -> &PgBackend

The backend on the test database. Its pool is the sqlx pool for sqlx::query! and anything this layer does not carry.

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

Apply migrations to the test database (see PgBackend::migrate).

pub async fn drop_database(self) -> Result<(), RelError>

Drop the database now, and report whether that worked. The server ends every connection to it (WITH (FORCE)), including one the test still holds: the pool is not asked to close first, because closing waits for every checked-out connection to come back.

Trait Implementations

impl Debug for TestDb

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

Formats the value using the given formatter.

impl Drop for TestDb

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.