mew

A tool for microbenchmarking Python code, powered by Google Benchmark.

import mew


@mew.benchmark
def bench_sorted(state: mew.State) -> None:
    data = list(range(1000, 0, -1))
    for _ in state:
        sorted(data)

$ mew run
mew · host=laptop cpus=10 @ 3200MHz scaling=enabled
Benchmark                              │     Iters │       Real │        CPU
────────────────────────────────────────────────────────────────────────────
benchmarks/bench_sort.py::bench_sorted │ 1,000,000 │   32.10 ns │   32.05 ns

• Decorate: @mew.benchmark, @mew.parametrize, @mew.product register one benchmark or a benchmark family.
• Run: mew run discovers bench_*.py files, streams results to a formatted table, JSON, or a JSONL archive.
• Profiling: mew run --sample (in-process pyinstrument) and --profile-memory (memray allocations) in the same run, driven by Google Benchmark's own profiler/memory managers.
• Compare: mew compare head.json baseline.json --regression-threshold 5% --exit-non-zero-on-regression for CI jobs.

Installation

$ uv add mew-bench                 # or: pip install mew-bench
$ uv add 'mew-bench[cpu,memory]'   # opt-in profilers

Requires Python 3.11+. A pre-built wheel is installed where available; otherwise the C++ extension is compiled via CMake + nanobind.

Docs

• Quickstart, concepts, user guide: https://mew.readthedocs.io/
• API reference: https://mew.readthedocs.io/en/latest/reference/api/
• CLI reference: https://mew.readthedocs.io/en/latest/reference/cli.html

License

This project is licensed under the Apache-2.0 license.