sharkdp/hyperfine
1
1
Fork 0
mirror of https://github.com/sharkdp/hyperfine.git synced 2024-11-25 19:19:31 +03:00
Code Issues Projects Releases Wiki Activity

Add section about param. benchmarks and export

Browse Source
This commit is contained in:
sharkdp 2018-03-24 21:01:41 +01:00
parent 233a995ba4
commit fdc4c655d3
1 changed files with 23 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
README.md
View File

@ -18,7 +18,8 @@ A command-line benchmarking tool (*inspired by [bench](https://github.com/Gabrie
* Warmup runs can be executed before the actual benchmark. * Warmup runs can be executed before the actual benchmark.
* Cache-clearing commands can be set up before each timing run. * Cache-clearing commands can be set up before each timing run.
* Statistical outlier detection. * Statistical outlier detection.
* Export results to various formats (CSV, JSON, Markdown). * Export results to various formats: CSV, JSON, Markdown.
* Parameterized benchmarks.
* Cross-platform * Cross-platform
## Usage ## Usage
@ -61,6 +62,27 @@ and then call:
hyperfine --prepare 'sync; echo 3 | sudo tee /proc/sys/vm/drop_caches' 'grep -R TODO *' hyperfine --prepare 'sync; echo 3 | sudo tee /proc/sys/vm/drop_caches' 'grep -R TODO *'
``` ```
### Parameterized benchmarks
If you want to run a benchmark where only a single parameter is varied (say, the number of
threads), you can use the `-P`/`--parameter-scan` option and call:
``` bash
hyperfine --prepare 'make clean' --parameter-scan num_threads 1 12 'make -j {num_threads}'
```
### Export results
Hyperfine has multiple options for exporting benchmark results: CSV, JSON, Markdown (see `--help`
text for details). To export results to Markdown, for example, you can use the `--export-markdown`
option that will create tables like this:
| Benchmark | Mean [ms] | Min. [ms] | Max. [ms] |
|----|----|----|----|
| `find ~ -iregex '.*[0-9]\.jpg$'` | 6911.0 ± 44.2 | 6837.5 | 6968.2 |
| `find ~ -iname '*[0-9].jpg'` | 3747.7 ± 29.1 | 3711.5 | 3801.5 |
| `fd -HI '[0-9]\.jpg$' ~` | 803.7 ± 33.4 | 784.7 | 882.9 |
| `fd '.*[0-9]\.jpg$' ~` | 122.0 ± 2.1 | 120.0 | 129.5 |
## Installation ## Installation
Hyperfine can be installed via [cargo](https://doc.rust-lang.org/cargo/): Hyperfine can be installed via [cargo](https://doc.rust-lang.org/cargo/):