fixenv

Fixenv is a fixture management engine for Go that helps developers describe repeatable test environments and reuse them safely across an entire test suite. It provides precise control over fixture caching scopes, automatic dependency tracking, and deterministic cleanup, making test setup more efficient and reliable.

Key Features

• Scope-aware caching — Run expensive setup only once per test, test tree, or package using configurable scopes.
• Deterministic cleanup — Register cleanup callbacks that are invoked automatically when the owning scope ends, even on test failure.
• Fixture dependency tree — Compose fixtures freely; cached results are shared across the dependency tree to avoid duplicated work.
• Skip-aware execution — Short-circuit tests without leaking resources by returning a special error from fixtures.
• Parallel-ready fixtures — Caching and cleanup remain correct when tests run in parallel.
• Zero dependencies — A lightweight helper that works with the standard testing package.
• Starter fixtures included — Ready-to-use helpers like cancellable contexts, temporary directories, and TCP listeners.

Philosophy

Fixenv focuses on composing reusable fixtures with deterministic lifecycle control, complementing assertion libraries and environment provisioning tools rather than replacing them.