prettybench

command module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 1, 2021 License: MIT Imports: 11 Imported by: 1

README

Prettybench

A tool for transforming go test's benchmark output a bit to make it nicer for humans.

Problem

Go benchmarks are great, particularly when used in concert with benchcmp. But the output can be a bit hard to read:

before

Solution

$ go get github.com/cespare/prettybench
$ go test -bench=. | prettybench

after

  • Column headers
  • Columns are aligned
  • Time output is adjusted to convenient units

Notes

  • Right now the units for the time are chosen based on the smallest value in the column.

  • Prettybench has to buffer all the rows of output before it can print them (for column formatting), so you won't see intermediate progress. If you want to see that too, you could tee your output so that you see the unmodified version as well. If you do this, you'll want to use the prettybench's -no-passthrough flag so it doesn't print all the other lines (because then they'd be printed twice):

      $ go test -bench=. | tee >(prettybench -no-passthrough)
    

To Do (maybe)

  • Handle benchcmp output
  • Change the units for non-time columns as well (these are generally OK though).

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL