README
¶
gotestsplit
Timing-aware Go test splitter. Forked from gotesplit (MIT, Songmu).
Where gotesplit splits by test count, gotestsplit reads prior JUnit XML output
to bin-pack by measured wallclock time, and chunks hot packages across shards
using -run regexes.
Usage
gotestsplit simulate -junit-dir=.gotest-timings [-min=2] [-max=10]
gotestsplit plan -junit-dir=.gotest-timings -total=8 -index=0 ./pkg/...
gotestsplit run -junit-dir=.gotest-timings -total=8 -index=0 ./pkg/... -- -race
See tools/gotestsplit/CLAUDE.md for design rationale and architecture details.
Documentation
¶
Overview ¶
Package main is gotestsplit, a timing-aware fork of gotesplit (https://github.com/Songmu/gotesplit, MIT). It splits Go tests across CI shards based on measured per-test duration rather than test count.
Source Files
Click to show internal directories.
Click to hide internal directories.