philiprehberger-timerfunc 0.1.6

Measure execution time of any function

philiprehberger-timerfunc

Measure execution time of any function.

Installation

pip install philiprehberger-timerfunc

Usage

Context Manager

from philiprehberger_timerfunc import timer

with timer() as t:
    do_work()
print(f"Took {t.elapsed_ms:.1f}ms")

Decorator

from philiprehberger_timerfunc import timed

@timed
def process_data():
    ...  # logs: "process_data took 42.3ms"

@timed(threshold_ms=100)
def api_call():
    ...  # only logs if slower than 100ms

Benchmark

from philiprehberger_timerfunc import benchmark

result = benchmark(my_function, args=(data,), iterations=1000)
print(f"Mean: {result.mean_ms:.2f}ms, P95: {result.p95_ms:.2f}ms")
print(result)  # full stats summary

API

Function / Class	Description
timer()	Context manager returning TimerResult
@timed / @timed(threshold_ms=0)	Decorator logging execution time
benchmark(fn, args, kwargs, iterations, warmup)	Returns BenchmarkResult

Development

pip install -e .
python -m pytest tests/ -v

License

MIT