timingtracer 0.1.2

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", "fetch data"):
    # ... code to measure ...
    pass

Or with method chaining:

with TimeTracer("MyModule").operation("fetch data"):
    # ... code to measure ...
    pass

Output: [MyModule] - fetch data took 10.5ms

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
• tt.end() - Stop timing and print elapsed time
• tt.elapsed - Get elapsed time in seconds (after calling end())
• tt.operation(name) - Set operation name for context manager chaining