Struct IsolatedTestDb 

pub struct IsolatedTestDb { /* private fields */ }

A test database scoped to a single test. Call cleanup() to drop it immediately, or rely on future test runs to clean up orphaned databases.

Implementations

impl IsolatedTestDb

pub async fn setup( test_name: &str, internal_sql: &str, migrations_dir: &Path, ) -> Result<IsolatedTestDb, ForgeError>

Convenience: from_env() → isolated() → run_sql(internal_sql) → migrate().

pub fn pool(&self) -> &Pool<Postgres>

pub fn db_name(&self) -> &str

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

Run raw SQL for test setup.

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

Run multi-statement SQL, handling PL/pgSQL dollar-quoted strings.

pub async fn cleanup(self) -> Result<(), ForgeError>

Drop the isolated database and close all connections.

pub async fn migrate(&self, migrations_dir: &Path) -> Result<(), ForgeError>

Run migrations: loads all .sql files from the directory, sorts alphabetically, executes in order.