pretty-bench

Render benchmark charts to PNG. No browser, no JS deps.

Install

npm install -D pretty-bench

Quick Start

cat > bench.yaml <<'EOF'version: 1type: grouped-bartitle: JSON parselabels: [run-1, run-2, run-3]series: - { name: main, values: [1200, 1180, 1215] } - { name: branch, values: [1350, 1340, 1362] }EOF
npx pretty-bench render bench.yaml bench.png

Supports JSON, YAML, and TOML. Chart types: bar, grouped-bar, line.

CLI

pretty-bench render <input> <output>
pretty-bench validate <input>
pretty-bench init <output> [--type grouped-bar]

pretty-bench validate bench.yaml
pretty-bench render bench.yaml bench.png
pretty-bench init benchmarks/example.yaml --type line

Node API

import{render,validate}from"pretty-bench";awaitvalidate("bench.yaml");awaitrender("bench.yaml","bench.png");

Spec

version: 1type: grouped-bartitle: JSON parsesubtitle: main vs branchunit: ops/seclabels: [run-1, run-2, run-3]series:
- name: mainvalues: [1200, 1180, 1215]
- name: branchvalues: [1350, 1340, 1362]

Optional fields:

• subtitle
• unit
• width
• height
• series[].color
• yAxis.min
• yAxis.max

Full schema: schemas/pretty-bench-v1.schema.json.

Starter specs:

• pretty-bench init bench.json
• pretty-bench init bench.yaml --type grouped-bar
• pretty-bench init bench.toml --type line

CI

- run: npx pretty-bench render bench.yaml bench.png
- run: git diff --exit-code bench.png

Contributing

Build, packaging, and publishing notes live in CONTRIBUTING.md.

License

MIT