testkit

func NewIsolatedDB ¶

func NewIsolatedDB(t *testing.T, adminDSN string, migrate func(*sql.DB) error) *sql.DB

NewIsolatedDB carves a fresh Postgres database on the cluster that adminDSN points at, runs the supplied migrate callback against it, and returns a connection to the carved DB. The DB is dropped (and any lingering backends terminated) on t.Cleanup.

adminDSN must be a connection string with permission to create and drop databases (typically a superuser connecting to a maintenance DB like `postgres`). The helper hard-fails on missing or unusable DSNs — by design, never t.Skip. Tests that hand-roll t.Skip when a DB is missing pass without proving anything; this helper inverts that.

migrate is called exactly once with the connection to the new DB before the helper returns. Pass nil to skip schema setup.

func NewIsolatedDBWithName ¶

func NewIsolatedDBWithName(t *testing.T, adminDSN string, migrate func(*sql.DB) error) (*sql.DB, string)

NewIsolatedDBWithName is NewIsolatedDB but also returns the carved database name. Useful in tests that want to verify the DB exists independently of the returned connection.

func RewriteDBNameForTest ¶

func RewriteDBNameForTest(dsn, dbName string) (string, error)

RewriteDBNameForTest exposes rewriteDBName to the external test package so the parse-failure contract can be asserted directly. Not intended for production callers.

func ValidateAdminDSN ¶

func ValidateAdminDSN(dsn string) error

ValidateAdminDSN returns an error if the DSN is empty or obviously malformed. Exposed so tests can check the failure mode directly.