1.3 KiB
1.3 KiB
FPR Bench CLI
Run JMH benchmarks via a single Python CLI and export JSON results.
Requires Python 3.4+.
Run a benchmark
From the repo root:
python fpr-bench/tools/fpr_bench.py run
This builds the shaded JMH jar and writes results to fpr-bench/results/.
You will be prompted for benchmark types and common JMH settings.
Available types: throughput, latency, common (runs the combined bench).
Pass JMH arguments
Use -- to pass flags directly to JMH (this skips the menu):
python fpr-bench/tools/fpr_bench.py run -- --wi 5 -i 5 -f 5 -tu us
Results location
JSON output is stored in:
fpr-bench/results/YYYYMMDD_HHMMSS__<tag>__<type>.json
If multiple types are selected, one JSON file is produced per type.
Examples
Skip the build and use a custom tag:
python fpr-bench/tools/fpr_bench.py run --no-build --tag smoke
Run only latency and throughput types non-interactively:
python fpr-bench/tools/fpr_bench.py run --types latency,throughput -- --wi 3 -i 3 -f 1
Use custom mvn and java executables:
python fpr-bench/tools/fpr_bench.py run --mvn mvn.cmd --java java
If another JMH instance is detected, the tool will try to terminate it. If that
fails, it runs with -Djmh.ignoreLock=true.