timeitTimer

timeitTimer is a lightweight utility designed to facilitate the measurement of code execution times in Python programs. It builds upon the core functionality of the standard library’s timeit module by providing a specialized Timer class that streamlines the process of collecting timing statistics for snippets of code, repeating the tests, and aggregating results. The primary purpose of timeitTimer is to give developers a reproducible, accurate, and convenient way to benchmark small code fragments, compare alternative implementations, or verify performance regressions when refactoring.

The central component of timeitTimer is the Timer class, which accepts a statement string and an optional setup string, both of which are executed in separate namespaces. The class exposes two main methods: timeit and repeat. The timeit method runs the statement a specified number of times (default 1_000_000) and returns the total elapsed time in seconds. The repeat method executes the timeit call multiple times (default 3) and returns a list of timings, allowing users to evaluate consistency across runs. Internally, timeitTimer uses the time.perf_counter function to capture high‑resolution wall‑clock time, making it suitable for micro‑benchmarking even in multi‑threaded environments.

Typical usage follows a simple pattern: instantiate the Timer with desired code and setup, then call timeit or repeat. For example:

timer = Timer('sum(range(1000))', 'pass')

elapsed = timer.timeit();

results = timer.repeat()

The results are returned as plain float values representing seconds, which can be directly compared or averaged. timeitTimer also supports optional arguments for specifying the number of loops and repetitions, enabling fine‑grained control over the benchmarking process.

By wrapping the functionality of the standard timeit.Timer into a more user‑friendly API, timeitTimer lowers the barrier to performing rigorous performance tests in everyday Python development.