Recent Releases of hyperfine
hyperfine - v1.19.0
Features
- Add a new
--reference <cmd>option to specify a reference command for the relative speed comparison, see #579, #577 and #744 (@JanEricNitschke) - Add
--concludeargument (analog to--prepare), see #565 and #719 as well as the docs here (@jackoconnordev) - Allow
--output=…to appear once for each command, enabling use cases likehyperfine --output=null my-cmd --output=./file.log my-cmd, see #529 and #775 (@sharkdp) - The environment variable
$HYPERFINE_ITERATIONwill now contain the current iteration number for each benchmarked command, see #775 (@sharkdp) - Add iteration information to failure error message, see #771 and #772 (@sharkdp)
- Python scripts:
- legend modification parameters and output DPI, see #758 (@Spreadcat)
- Nicer whiskers plot, see #727 (@serpent7776)
Bugfixes
- ETA not clearly visible on terminals with a block cursor, see #698 and #699 (@overclockworked64)
- Fix zsh completions, see #717 (@xzfc)
Other
- Build binaries for aarch64-apple-darwin, see #728 (@Phault)
- Various cleanups (@hamirmahal, @one230six)
- Rust
Published by sharkdp over 1 year ago
hyperfine - v1.17.0
Features
- Add new
--sortoption to control the order in the rel. speed comparison and in markup export formats, see #601, #614, #655 (@sharkdp) - Parameters which are unused in the command line are now displayed in parentheses, see #600 and #644 (@sharkdp).
- Added
--log-countoption for histogram plots, seescripts/plot_histogram.py(@sharkdp)
Changes
- Updated hyperfine to use
windows-sysinstead of the unmaintainedwinapi, see #624, #639, #636, #641 (@clemenswasser) - Silenced deprecation warning in Python scripts, see #633 (@nicovank)
- Major update of the man page, see 0ce6578, #647 (@sharkdp)
Bugfixes
- Do not export intermediate results to stdout when using
-as a file name, see #640 and #643 (@sharkdp) - Markup exporting does not fail if benchmark results are zero, see #642 (@sharkdp)
- Rust
Published by sharkdp almost 3 years ago
hyperfine - v1.16.0
Features
- Added new
--inputoption, see #541 and #563 (@snease) - Added possibility to specify
-as the filename in the--export-*options, see #615 and #623 (@humblepenguinn)
Changes
- Improve hints for outlier warnings if
--warmupor--prepareare in use already, see #570 (@sharkdp)
Bugfixes
- Fix uncolored output on Windows if
TERMis not set, see #583 (@nabijaczleweli) - On Windows, only run
cmd.exewith the/Coption. Use-cfor all other shells, see #568 and #582 (@FilipAndersson245)
Other
- Thanks to @berombau for working on dependency upgrades, see #584
- Fixed installationm on Windows, see #595 and #596 (@AntoniosBarotsis)
- Rust
Published by sharkdp about 3 years ago
hyperfine - v1.15.0
Features
- Disable colorized output in case of
TERM=dumborNO_COLOR=1, see #542 and #555 (@nabijaczleweli) - Add new (experimental)
--min-benchmarking-time <secs>option, see #527 (@sharkdp)
Bugfixes
- Fix user and kernel times on Windows, see #368 and #538 (@clemenswasser)
Other
- Improve
--helptexts of--export-*options, see #506 and #522 (@Engineer-of-Efficiency)
- Rust
Published by sharkdp over 3 years ago
hyperfine - v1.14.0
- Add a new
--output={null,pipe,inherit,<FILE>}option to control where the output of the benchmarked program is redirected (if at all), see #377 and #509 (@tavianator, originally suggested by @BurntSushi) - Add Emacs org-mode as a new export format, see #491 (@ppaulweber)
- Relax glibc requirements, see #508 and #512 (@sharkdp)
- Rust
Published by sharkdp about 4 years ago
hyperfine - v1.13.0
Features
- Added a new
--shell=none/-Noption to disable the intermediate shell for executing the benchmarked commands. Hyperfine normally measures and subtracts the shell spawning time, but the intermediate shell always introduces a certain level of measurement noise. Using--shell=none/-Nallows users to benchmark very fast commands (with a runtime on the order of a few milliseconds). See #336, #429, and #487 (@cipriancraciun and @sharkdp) - Added
--setup/-soption that can be used to runmake allor similar. It runs once per set of tests, like--cleanup/-c(@avar) - Added new
plot_progression.pyscript to debug background interference effects.
Changes
- Breaking change: the
-sshort option for--styleis now used for the new--setupoption. - The environment offset randomization is now also available on Windows, see #484
Other
- Improved documentation and test coverage, cleaned up code base for future improvements.
- Rust
Published by sharkdp about 4 years ago
hyperfine - v1.12.0
Features
--command-namecan now take parameter names from--parameter-*options, see #351 and #391 (@silathdiir)- Exit codes (or signals) are now printed in cases of command failures, see #342 (@KaindlJulian)
- Exit codes are now part of the JSON output, see #371 (@JordiChauzi)
- Colorized output should now be enabled on Windows by default, see #427
Changes
- When
--export-*commands are used, result files are created before benchmark execution to fail early in case of, e.g., wrong permissions. See #306 (@s1ck). - When
--export-*options are used, result files are written after each individual benchmark command instead of writing after all benchmarks have finished. See #306 (@s1ck). - Reduce number of shell startup time measurements from 200 to 50, generally speeding up benchmarks. See #378
- User and system time are now in consistent time units, see #408 and #409 (@film42)
- Rust
Published by sharkdp over 4 years ago
hyperfine - v1.11.0
Features
- The
-L/--parameter-listoption can now be specified multiple times to evaluate all possible combinations of the listed parameters:
bash
hyperfine -L number 1,2 -L letter a,b,c \
"echo {number}{letter}" \
"printf '%s\n' {number}{letter}"
# runs 12 benchmarks: 2 commands (echo and printf) times 6 combinations of
# the "letter" and "number" parameters
See: #253, #318 (@wchargin)
- Add CLI option to identify a command with a custom name, see #326 (@scampi)
Changes
- When parameters are used with
--parameter-listor--parameter-scan, the JSON export format now contains a dictionaryparametersinstead of a single keyparameter. See #253, #318. - The
plot_parametrized.pyscript now infers the parameter name, and its--parameter-nameargument has been deprecated. See #253, #318.
Bugfixes
- Fix a bug in the outlier detection which would only detect "slow outliers" but not the fast ones (runs that are much faster than the rest of the benchmarking runs), see #329
- Better error messages for very fast commands that would lead to inf/nan results in the relative speed comparison, see #319
- Show error message if
--warmupor--*runsarguments can not be parsed, see #337 - Keep output colorized when the output is not interactive and
--style=fullor--style=coloris used.
- Rust
Published by sharkdp over 5 years ago
hyperfine - v1.10.0
Features
- Hyperfine now comes with shell completion files for Bash, Zsh, Fish and PowerShell, see #290 (@four0000four).
- Hyperfine now comes with a basic man page, see #257 (@cadeef)
- During execution of benchmarks, hyperfine will now set a
HYPERFINE_RANDOMIZED_ENVIRONMENT_OFFSETenvironment variable in order to randomize the memory layout. See #235 and #241 for references and details. - A few enhancements for the histogram plotting scripts and the advanced statistics script
- Updates for the
plot_whisker.pyscript, see #275 (@ghaiklor)
Bugfixes
- Fix Spin Icon on Windows, see #229
- A few typos have been fixed, see #292 (@McMartin)
Packaging
hyperfineis now available on MacPorts for macOS, see #281 (@herbygillot)hyperfineis now available on OpenBSD, see #289 (@minusf)
Package authors: note that Hyperfine now comes with a set of shell completion files and a man page (see above)
- Rust
Published by sharkdp about 6 years ago
hyperfine - v1.9.0
Features
- The new
--parameter-list <VAR> <VALUES>option can be used to run a parametrized benchmark on a user-specified list of values. This is similar to--parameter-scan <VAR> <MIN> <MAX>, but doesn't necessarily required numeric arguments.
bash
hyperfine --parameter-list compiler "gcc,clang" \
"{compiler} -O2 main.cpp"
See: #227, #234 (@JuanPotato)
Added
noneas a possible choice for the--styleoption to runhyperfinewithout any output, see #193 (@knidarkness)Added a few new scripts for plotting various types of benchmark results (https://github.com/sharkdp/hyperfine/tree/master/scripts)
Changes
The
--preparecommand is now also run during the warmup phase, see #182 (@sseemayer)Better estimation of the remaining benchmark time due to an update of the
indicatifcrate.
Other
hyperfineis now available on NixOS, see #240 (@tuxinaut)
- Rust
Published by sharkdp over 6 years ago
hyperfine - v1.8.0
Features
- The
--prepare <CMD>option can now be specified multiple times to run specific preparation commands for each of the benchmarked programs:
bash
hyperfine --prepare "make clean; git checkout master" "make" \
--prepare "make clean; git checkout feature" "make"
See: #216, #218 (@iamsauravsharma)
Added a new
welch_ttest.pyscript to test whether or not the two benchmark results are the same, see #222 (@uetchy)The Markdown export has been improved. The relative speed is now exported with a higher precision (see #208) and includes the standard deviation (see #225).
Other
- Improved documentation for
scriptsfolder (@matthieusb)
- Rust
Published by sharkdp over 6 years ago
hyperfine - v1.7.0
Features
- Added a new
-D,--parameter-step-sizeoption that can be used to control the step size for--parameter-scanbenchmarks. In addition, decimal numbers are now allowed for parameter scans. For example, the following command runssleep 0.3,sleep 0.5andsleep 0.7:bash hyperfine --parameter-scan delay 0.3 0.7 -D 0.2 'sleep {delay}'For more details, see #184 (@piyushrungta25)
Other
- hyperfine is now in the official Alpine repositories, see #177 (@maxice8, @5paceToast)
- hyperfine is now in the official Fedora repositories, see #196 (@ignatenkobrain)
- hyperfine is now in the official Arch Linux repositories
- hyperfine can be installed on FreeBSD, see #204 (@0mp)
- Enabled LTO for slightly smaller binary sizes, see #179 (@Calinou)
- Various small improvements all over the code base, see #194 (@phimuemue)
- Rust
Published by sharkdp over 6 years ago
hyperfine - v1.6.0
Features
- Added a
-c, --cleanup <CMD>option to executeCMDafter the completion of all benchmarking runs for a given command. This is useful if the commands to be benchmarked produce artifacts that need to be cleaned up. See #91 (@RalfJung and @colinwahl) - Add parameter values (for
--parameter-scanbenchmarks) to exported CSV and JSON files. See #131 (@bbannier) - Added AsciiDoc export option, see #137 (@5paceToast)
- The relative speed is now part of the Markdown export, see #127 (@mathiasrw and @sharkdp).
- The median run time is now exported via CSV and JSON, see #171 (@hosewiejacke and @sharkdp).
Other
- Hyperfine has been updated to Rust 2018 (@AnderEnder). The minimum supported Rust version is now 1.31.
- Rust
Published by sharkdp almost 7 years ago
hyperfine - v1.5.0
Features
- Show the number of runs in
hyperfines output (@tcmal) - Added two Python scripts to post-process exported benchmark results (see
scripts/folder)
Other
- Refined
--helptext for the--export-*flags (@psteinb) - Added Snapcraft file (@popey)
- Small improvements in the progress bar "experience".
- Rust
Published by sharkdp over 7 years ago
hyperfine - v1.4.0
Features
- Added
-S/--shelloption to override the default shell, see #61 (@mqudsi and @jasonpeacock) - Added
-u/--time-unitoption to change the unit of time (secondormillisecond), see #80 (@jasonpeacock) - Markdown export auto-selects time unit, see #71 (@jasonpeacock)
- Rust
Published by sharkdp over 7 years ago
hyperfine - v1.3.0
Feature
- Compute and print standard deviation of the speed ratio, see #83 (@Shnatsel)
- More compact output format, see #70 (@jasonpeacock)
- Added
--style=color, see #70 (@jasonpeacock) - Added options to specify the max/exact numbers of runs, see #77 (@orium)
Bugfixes
- Change Windows
cmdinterpreter tocmd.exeto prevent accidentally calling other programs, see #74 (@tathanhdinh)
Other
- Binary releases for Windows are now available, see #87
- Rust
Published by sharkdp over 7 years ago
hyperfine - v1.0.0
Features
- Support for various export-formats like CSV, JSON and Markdown - see #38, #44, #49, #42 (@stevepentland)
- Summary output that compares the different benchmarks, see #6 (@stevepentland)
- Parameterized benchmarks via
-P,--parameter-scan <VAR> <MIN> <MAX>, see #19
Thanks
I'd like to say a big THANK YOU to @stevepentland for implementing new features, for reviewing pull requests and for giving very valuable feedback.
- Rust
Published by sharkdp about 8 years ago
hyperfine - v0.3.0
Features
- In addition to 'real' (wall clock) time, Hyperfine can now also measure 'user' and 'system' time (see #5).
- Added
--prepareoption that can be used to clear up disk caches before timing runs, for example (see #8).
Other
- Arch Linux package for Hyperfine (@jD91mZM2).
- Ubuntu/Debian packages are now are available.
- Rust
Published by sharkdp over 8 years ago