bcrypt-speed-tests 0.1.0

CLI for benchmarking bcrypt cost factors on local hardware.

bcrypt-speed-tests

Small CLI for benchmarking bcrypt cost factors so you can pick a sensible value on your target hardware.

What it does

• Hashes a fixed password multiple times per cost factor.
• Reports average time per cost in milliseconds.
• Runs locally on the same machine your app will use.

Requirements

• Python 3.9+
• bcrypt (installed via project dependencies)

Install

uv sync

uv sync creates a local .venv by default.

Activate virtual environment

source .venv/bin/activate

Deactivate when done:

deactivate

Windows (PowerShell):

.venv\Scripts\Activate.ps1

Or with pip:

pip install -e .

Run

bcrypt-speed-tests

CLI options

Available options:

Usage: bcrypt-speed-tests [OPTIONS] COMMAND [ARGS]...

Run the benchmark and print a timing table.

Options:
  --iterations  -i  INTEGER RANGE [x>=1]      Hashes to run per cost factor.
                                              [default: 3]
  --cost        -c  INTEGER RANGE [4<=x<=31]  Cost factor(s). Repeat to pass
                                              multiple values.
  --help                                     Show this message and exit.

Override defaults at runtime:

bcrypt-speed-tests --iterations 5 --cost 10 --cost 12 --cost 14

Tasks

Run via poethepoet:

poe ruff
poe mypy
poe format

Configure

Edit defaults in src/bcrypt_speed_tests/benchmark.py:

• ITERATIONS: hashes per cost factor
• COSTS: cost factor range
• PASSWORD: fixed input

Example output

Iterations per cost: 3

Cost | Avg time (ms)
----------------------
  10 |        23.4
  11 |        46.8
  12 |        93.1
  13 |       185.7
  14 |       370.9

License

MIT