test-summary

Overview ¶

test-summary turns a `go test -json` event stream into a Markdown summary for the GitHub Actions job page: the counts, every skipped test with its reason, and every failure.

Tests run verbosely, but a skipped test is still one line among tens of thousands in the log. A test that skips on every run, because a variable is never set or a tool is never installed, passes review and CI unnoticed indefinitely. The job summary puts the list where people look.

It reports and never judges: a failed test is the test run's verdict to give, so this exits zero whatever the results, and non-zero only when the stream cannot be read or holds no test results at all.

Usage:

test-summary [go-test-json-file] >> "$GITHUB_STEP_SUMMARY"