timingtracer 0.1.5

A simple utility class for timing and tracing code execution. Mark operations and print elapsed times between them.

TimeTracer

A simple utility for timing code execution.

Installation

Using uv (recommended)

uv add timingtracer

Using pip

pip install timingtracer

Usage

start/end

from timingtracer import TimeTracer

tt = TimeTracer("MyModule")
tt.start("fetch data")
# ... code to measure ...
tt.end()

Output: [MyModule] - fetch data took 10.5ms

Context manager

from timingtracer import TimeTracer

with TimeTracer("MyModule"):
    tt.start("fetch data")
    # ... code to measure ...
    tt.end()

Get elapsed time

tt = TimeTracer("MyModule")
tt.start("fetch data")
# ... code to measure ...
elapsed = tt.end()

print(f"It took {elapsed:.3f}s")

API

• TimeTracer(tracer="TimeTracer") - Create a tracer with a name for your module
• tt.start(operation_name) - Start timing an operation (default: "Operation")
• tt.end() - Stop timing and print elapsed time
• tt.elapsed - Get elapsed time in seconds (after calling end())