Documentation
¶
Overview ¶
Package adaptertest holds test helpers shared by the adapter packages.
It exists for one purpose today: centralise the os.Stderr-capture pipe pattern the per-adapter SetStderr-nil-resets tests use. Round-3 of the PR-#50 review surfaced that the pattern had been copy-pasted to three adapter test packages (claude / opencode / codex) and that the deferred-cleanup fix had to be applied identically to all three — the kind of triplication that silently invites drift the next time something subtle changes. Sharing the helper as a normal (non-_test) package follows the stdlib `httptest` precedent: ordinary code that happens to take a `*testing.T`.
This package MUST NOT depend on any concrete adapter (claude / opencode / codex) — that would invert the layering, since each adapter package already imports adapter, and the test helper is shared across them.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CaptureOsStderr ¶
CaptureOsStderr swaps os.Stderr for a pipe, runs fn, then restores the original os.Stderr and returns whatever fn wrote to the pipe. Cleanup is deferred BEFORE invoking fn so a t.Fatalf / panic (both unwind via runtime.Goexit and through defers) does not leak the read goroutine or leave os.Stderr swapped for the rest of the process.
Use it to verify an adapter's SetStderr(nil) actually routes back to the os.Stderr default — a faulty implementation routing to io.Discard would otherwise pass an "is the previous buffer empty?" assertion while silently dropping every future warning.
Not safe for concurrent use within a package: it swaps a process-global. Callers MUST NOT t.Parallel a test that calls this.
Types ¶
type SwapOnFirstWriteBuffer ¶
type SwapOnFirstWriteBuffer struct {
bytes.Buffer
OnFirstWrite func()
// contains filtered or unexported fields
}
SwapOnFirstWriteBuffer is a bytes.Buffer that, on its first Write call, invokes OnFirstWrite (once) before writing. Used by per- adapter snapshot tests to swap the adapter's Stderr to a sibling buffer mid-Ingest. If the adapter snapshots `warn := a.stderr()` at Ingest entry (the documented adapter.WarnEmitter contract), subsequent warnings still land in this buffer; if the adapter instead re-reads `a.stderr()` per warning, they land in the sibling and the snapshot assertion catches it.
Zero-value ready; set OnFirstWrite before passing to the adapter.
func (*SwapOnFirstWriteBuffer) Fired ¶
func (b *SwapOnFirstWriteBuffer) Fired() bool
Fired reports whether OnFirstWrite has been invoked. Tests use it to fail-loudly when the fixture didn't actually trigger any write (which would let the snapshot assertion pass vacuously).
Source Files