testing

func AssertDatabaseCount ¶

func AssertDatabaseCount(t testing.TB, db *lucid.DB, table string, expected int64, conditions map[string]any)

AssertDatabaseCount asserts the table has exactly n records (optionally matching conditions).

nimbustesting.AssertDatabaseCount(t, db, "users", 5, nil)
nimbustesting.AssertDatabaseCount(t, db, "users", 2, map[string]any{"role": "admin"})

func AssertDatabaseHas ¶

func AssertDatabaseHas(t testing.TB, db *lucid.DB, table string, conditions map[string]any)

AssertDatabaseHas asserts that a record matching the given conditions exists in the specified table. Conditions is a map[string]any of column=value pairs.

nimbustesting.AssertDatabaseHas(t, db, "users", map[string]any{"email": "alice@example.com"})

func AssertDatabaseMissing ¶

func AssertDatabaseMissing(t testing.TB, db *lucid.DB, table string, conditions map[string]any)

AssertDatabaseMissing asserts that no record matching the given conditions exists in the specified table.

nimbustesting.AssertDatabaseMissing(t, db, "users", map[string]any{"email": "deleted@example.com"})

func AssertModelExists ¶

func AssertModelExists(t testing.TB, db *lucid.DB, model any)

AssertModelExists asserts that the given GORM model exists in the database.

func AssertModelMissing ¶

func AssertModelMissing(t testing.TB, db *lucid.DB, model any)

AssertModelMissing asserts that the given GORM model does NOT exist.

func AssertNotSoftDeleted ¶

func AssertNotSoftDeleted(t testing.TB, db *lucid.DB, table string, conditions map[string]any)

AssertNotSoftDeleted asserts that a record exists and is NOT soft-deleted.

func AssertSoftDeleted ¶

func AssertSoftDeleted(t testing.TB, db *lucid.DB, table string, conditions map[string]any)

AssertSoftDeleted asserts that a soft-deleted record exists in the table (i.e., deleted_at IS NOT NULL).

func AssertStatus ¶

func AssertStatus(w *httptest.ResponseRecorder, want int) bool

AssertStatus is a legacy helper (use TestResponse assertions instead).

func RefreshDatabase ¶

func RefreshDatabase(t testing.TB, db *lucid.DB) *lucid.DB

RefreshDatabase wraps a test in a database transaction that is rolled back after the test completes. This ensures each test starts with a clean database state without running migrations.

Usage:

func TestCreateUser(t *testing.T) {
    tx := nimbustesting.RefreshDatabase(t, db)
    // use tx instead of db in your test
    tx.Create(&User{Name: "Alice"})
    // transaction is automatically rolled back when test ends
}

func SeedDatabase ¶

func SeedDatabase(db *lucid.DB, seeder func(db *lucid.DB) error) error

SeedDatabase runs a seeder function within test scope. The seeder receives a *lucid.DB (which could be a transaction).

func TruncateTables ¶

func TruncateTables(db *lucid.DB, tables ...string) error

TruncateTables truncates the given table names. Useful for test setup when RefreshDatabase (transaction-per-test) is not suitable.