testkit

func GetFreePort ¶

func GetFreePort() (int, error)

GetFreePort asks the OS for an available TCP port by listening on :0, then closes the listener and returns the assigned port. This is useful for parallel tests that each need their own listener.

Note: there is an inherent TOCTOU race between closing the listener and the caller binding to the port. In practice this rarely causes issues in test environments, but callers should handle bind failures gracefully.

func NewLogger ¶

func NewLogger(t testing.TB) *slog.Logger

NewLogger returns a *slog.Logger that writes JSON output to t.Log so that log lines appear alongside test output and are suppressed on success unless -v is passed. The level is set to Debug so every message is captured.

func Respond ¶

func Respond(status int, body string) http.Handler

Respond returns an http.Handler that always replies with the given status code and body string, setting Content-Type to application/json.

func Sequence ¶

func Sequence(handlers ...http.Handler) http.Handler

Sequence returns an http.Handler that serves responses from a list of handlers in order, repeating the last handler for any extra requests.

func SetEnv ¶

func SetEnv(t testing.TB, envs map[string]string)

SetEnv sets the supplied environment variables and registers a t.Cleanup to unset them after the test. This is the building block for test config — pair it with config.MustLoad[T]() in your test to load typed configuration.

Example:

testkit.SetEnv(t, map[string]string{"PORT": "8080"})
cfg := config.MustLoad[AppConfig]()