hyperfine

# Benchmark a single command
hyperfine 'sleep 0.3'

# Compare multiple commands
hyperfine 'find . -name "*.md"' 'fd -e md'

# Execute shell commands
hyperfine 'echo "Hello" && sleep 0.1'

# Add warmup runs (warm up the cache)
hyperfine --warmup 3 'cat large_file.txt'

# Specify prepare command
hyperfine --prepare 'sync; echo 3 | sudo tee /proc/sys/vm/drop_caches' 'cat large_file.txt'

# Specify cleanup command
hyperfine --cleanup 'rm -f output.txt' 'generate_output > output.txt'

# Specify minimum number of runs
hyperfine --min-runs 20 'command'

# Specify maximum number of runs
hyperfine --max-runs 100 'command'

# Specify exact number of runs
hyperfine --runs 50 'command'

# Compare with varying parameters
hyperfine -P threads 1 8 'make -j {threads}'

# Specify multiple values
hyperfine -L compiler gcc,clang '{compiler} -O2 main.c'

# Combination of multiple parameters
hyperfine -L size 100,1000,10000 -L algo quick,merge './sort --algo {algo} --size {size}'

# Output in JSON format
hyperfine --export-json results.json 'command1' 'command2'

# Output in CSV format
hyperfine --export-csv results.csv 'command1' 'command2'

# Output in Markdown format (for documentation)
hyperfine --export-markdown results.md 'command1' 'command2'

# Output in AsciiDoc format
hyperfine --export-asciidoc results.adoc 'command1' 'command2'

# Specify shell to use
hyperfine --shell=bash 'echo $BASH_VERSION'
hyperfine --shell=zsh 'echo $ZSH_VERSION'

# Run without shell (direct execution)
hyperfine --shell=none './my_program'

# Default shell (usually /bin/sh)
hyperfine 'command'

# Ignore failures and continue
hyperfine --ignore-failure 'command_that_might_fail'

# Set timeout
hyperfine --command-name 'slow command' 'sleep 10'

# Show output
hyperfine --show-output 'command'

# Compare find and fd
hyperfine --warmup 3 \
  'find . -name "*.rs"' \
  'fd -e rs'

# Compare grep and ripgrep
hyperfine --warmup 3 \
  'grep -r "TODO" .' \
  'rg "TODO"'

# Compare cat and bat
hyperfine --warmup 5 \
  'cat large_file.txt > /dev/null' \
  'bat --style=plain large_file.txt > /dev/null'

# Compare compiler optimization options
hyperfine --prepare 'make clean' \
  -L opt O0,O1,O2,O3 \
  'gcc -{opt} -o test main.c && ./test'

# Compare parallelism
hyperfine -P jobs 1 8 \
  --prepare 'make clean' \
  'make -j {jobs}'

# Compare algorithms
hyperfine \
  --export-markdown bench.md \
  './sort_bubble' \
  './sort_quick' \
  './sort_merge'

# Benchmark example in GitHub Actions
name: Benchmark
on: [push]
jobs:
  benchmark:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install hyperfine
        run: |
          wget https://github.com/sharkdp/hyperfine/releases/download/v1.18.0/hyperfine_1.18.0_amd64.deb
          sudo dpkg -i hyperfine_1.18.0_amd64.deb
      - name: Build
        run: cargo build --release
      - name: Benchmark
        run: |
          hyperfine --warmup 3 --export-markdown bench.md './target/release/myapp'
      - name: Upload results
        uses: actions/upload-artifact@v3
        with:
          name: benchmark-results
          path: bench.md

# Run after clearing cache (requires root)
hyperfine \
  --prepare 'sync; echo 3 | sudo tee /proc/sys/vm/drop_caches > /dev/null' \
  --warmup 0 \
  --min-runs 5 \
  'cat largefile.bin > /dev/null'

# File write benchmark
hyperfine \
  --cleanup 'rm -f testfile' \
  'dd if=/dev/zero of=testfile bs=1M count=100'