Struct TestDatabase 

pub struct TestDatabase { /* private fields */ }

Database access for tests.

Examples

let db = TestDatabase::from_url("postgres://localhost/test_db").await?;
let db = TestDatabase::from_env().await?;

Implementations

impl TestDatabase

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

Connect to database at the given URL.

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

Connect using TEST_DATABASE_URL, or start a container if the testcontainers feature is enabled and the var is unset.

pub fn pool(&self) -> &PgPool

Get the connection pool.

pub fn url(&self) -> &str

Get the database URL.

pub async fn execute(&self, sql: &str) -> Result<()>

Run raw SQL to set up test data or schema.

pub async fn isolated(&self, test_name: &str) -> Result<IsolatedTestDb>

Creates a dedicated database for a single test, providing full isolation.

Each call creates a new database with a unique name. Use this when tests modify data and could interfere with each other.