net.lewisship.bench — io.github.hlship/trace 1.1

Useful wrappers around criterium.

bench clj macro

(bench & exprs)

Benchmarks a sequence of expressions. Criterium is used to perform the benchmarking, then the results are reported in a tabular format, which the fastest and slowest expressions highlighted (marked in green and yellow, respectively).

The first argument may be a map of options, rather than an expression to benchmark.

Options: : :quick? If true (the default), used quick benchmarking options : :round-robin? If true (the default), used round-robin testing of the expressions rather than running a benchmark for each expression. : report? If true (the default), print a report and return nil. Otherwise, returns a seq of benchmarking stats as returned by Criterium. : progress? If true (the default is false), enable Criterium progress reporting during benchmark collection. : sort? If true (the default is false), then when results are printed, they are sorted fastest to slowest (with no highlighting).

In addition, the options are passed to Criterium, allowing overrides of the options it uses when benchmarking, such as :samples, etc.

bench* clj

(bench* opts & blocks)