Struct TestDatabase 

pub struct TestDatabase { /* private fields */ }

Test database wrapper that provides isolated database environments

Each TestDatabase creates a fresh in-memory SQLite database with migrations applied. The database is automatically registered in the test container, so any code using DB::connection() or #[inject] db: Database will receive this test database.

When the TestDatabase is dropped, the test container is cleared, ensuring complete isolation between tests.

Example

use ferro_rs::testing::TestDatabase;
use ferro_rs::migrations::Migrator;

#[tokio::test]
async fn test_user_creation() {
    let db = TestDatabase::fresh::<Migrator>().await.unwrap();

    // Actions using DB::connection() automatically get this test database
    let action = CreateUserAction::new();
    let user = action.execute("test@example.com").await.unwrap();

    // Query directly using db.conn()
    let found = users::Entity::find_by_id(user.id)
        .one(db.conn())
        .await
        .unwrap();
    assert!(found.is_some());
}

Implementations

impl TestDatabase

pub async fn fresh<M: MigratorTrait>() -> Result<Self, FrameworkError>

Create a fresh test database with migrations applied

This creates an in-memory SQLite database, runs all migrations, and registers the connection in the test container.

Type Parameters

• M - The migrator type implementing MigratorTrait. Typically this is crate::migrations::Migrator from your application.

Errors

Returns an error if:

• Database connection fails
• Migration execution fails

Example

use ferro_rs::testing::TestDatabase;
use ferro_rs::migrations::Migrator;

#[tokio::test]
async fn test_example() {
    let db = TestDatabase::fresh::<Migrator>().await.unwrap();
    // ...
}

pub fn conn(&self) -> &DatabaseConnection

Get a reference to the underlying database connection

Use this when you need to execute queries directly in your tests.

Example

let db = test_database!();
let users = users::Entity::find().all(db.conn()).await?;

pub fn db(&self) -> &DbConnection

Get the DbConnection wrapper

Use this when you need the full DbConnection type.