Code-Memo

Testing in CI

Unit tests

go test ./...

Race tests

go test -race ./...

Race tests are slower and mostly supported on linux/amd64 in typical CI setups.

Coverage

go test -cover ./...
go test -coverprofile=cover.out ./...
go tool cover -func=cover.out

Integration tests

Use one of:

• Build tags (e.g. //go:build integration)
• -short gate
• Separate packages with explicit naming

Example -short pattern:

if testing.Short() {
	t.Skip("skipping integration tests")
}

Golden tests

Good for CLI output stability:

• Compare output to “golden” files under testdata/
• Provide a -update flag to refresh snapshots intentionally

Flake control

• Prefer deterministic time (time.Now injected) and randomness (seeded)
• Re-run on failure sparingly; fix the nondeterminism