testkit

Documentation

Overview

Package testkit provides lightweight test helpers for chassis-go services. It has zero dependencies on other chassis packages.

Index

• func GetFreePort() (int, error)
• func NewLogger(t testing.TB) *slog.Logger
• func SetEnv(t testing.TB, envs map[string]string)

Functions

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.

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 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]()