testkit

func AllowRenderPanics ¶ added in v0.86.0

func AllowRenderPanics(t testing.TB, next http.Handler) http.Handler

AllowRenderPanics returns a handler that keeps production HTTP status behavior after recovered render panics. Use it only to test intentional panic recovery. It does not silence error logs or TestHarness failure reporters.

The exemption ends at t.Cleanup; later requests through the returned handler again receive the test-only 500. Requests already admitted may finish with production status. Register server cleanup after calling this helper. It is safe with t.Parallel when each test owns its wrapper and server; never share the returned handler or server with tests that did not opt out. It panics outside a Go test binary. No request header or query opts out.

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.