testutil

package

v1.0.0 Latest Latest Go to latest Published: Apr 27, 2026 License: MIT Imports: 6 Imported by: 0

Details

Package testutil provides testing helpers, mock beans, and test application container utilities for the Helix framework.

This section is empty.

This section is empty.

func GetBean[T any](app *App) T

GetBean resolves a component from the test app container and fails the test immediately if resolution is impossible.

type App struct {
	// contains filtered or unexported fields
}

App is a Helix application container scoped to a Go test.

func NewApp(t testing.TB, options ...Option) *App

NewApp creates, configures, starts, and registers cleanup for a test app.

func (a *App) Close() error

Close shuts down the test app once.

func (a *App) Config() config.Loader

Config returns the configuration loader used by the test app.

func (a *App) Container() *core.Container

Container returns the underlying Helix DI container.

type Option func(*appOptions)

Option configures a Helix test application.

func MockBean[T any](impl T) Option

MockBean replaces components assignable to T with impl in a Helix test app.

func WithComponents(components ...any) Option

WithComponents registers components in the test container before startup.

func WithConfigDefaults(values map[string]any) Option

WithConfigDefaults configures fallback values for the test config loader.

func WithConfigPaths(paths ...string) Option

WithConfigPaths overrides directories searched for application test config.

func WithContainerOptions(containerOptions ...core.Option) Option

WithContainerOptions appends core container options to the test container.