benchregress

Documentation

Overview

benchregress compares go test -bench output against a pre-computed baseline and reports regressions beyond a configurable threshold.

Two modes:

-update         read raw benchmark output from stdin, write normalized
                baseline to stdout.

(default)       compare -current file against -base file; exit 0 if
                all benchmarks pass, 1 if any regression, 2 on error.

Usage:

# Generate baseline from N runs.
go test -bench=. -count=10 -benchmem ./term \
  | benchregress -update > baseline.txt

# Check regressions.
go test -bench=. -count=10 -benchmem ./term > current.txt
benchregress -base baseline.txt -current current.txt