codetiming

What it is and what it does

codetiming provides a Timer class for measuring code execution time in Python. It supports three usage patterns—as a standalone class with explicit start/stop calls, as a context manager for timing code blocks, and as a decorator for timing function calls. The Timer accepts optional arguments to customize output formatting (via a text template), redirect output to a logger function, and optionally display text when the timer starts.

The package includes named timer aggregation: when you create a Timer with a name, elapsed times accumulate in a class-level dictionary (Timer.timers) that provides statistics methods like mean, median, min, max, stdev, and count. The text formatting is template-based using .format() rather than f-strings, and can be a callable for custom time formatting. A single runtime dependency on dataclasses ensures compatibility with older Python versions.

Use it for:

• Measure execution time of specific code blocks during development and debugging without external profiling tools
• Track performance of repeated operations and gather statistics (mean, max, stdev) across multiple runs
• Add timing instrumentation to functions using decorators for quick performance monitoring
• Redirect timer output to logging frameworks instead of print for integration with application logging
• Benchmark different implementations by timing them with named timers and comparing accumulated statistics

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Measures elapsed time in Python code using a flexible Timer class that works as a decorator, context manager, or standalone object, with customizable output formatting and named timer aggregation.

Yes, if you need a lightweight, zero-configuration timer for development and learning. The package is stable and has no known vulnerabilities, but install with the understanding that it is no longer maintained—no bug fixes or feature updates will be released. For production performance monitoring, consider a more actively maintained alternative.

Install

codetiming on PyPI

pip install codetiming

uv add codetiming

poetry add codetiming

Installing codetiming

Before you install

Installation is straightforward with no compiled dependencies. However, the package has been abandoned since November 2022 (over 1375 days without updates), so no active maintenance or bug fixes should be expected.

License in practice

Licensed under MIT (permissive), which allows free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

from codetiming import Timer

# As a context manager
with Timer(name="example"):
    # Code to time
    pass

# As a decorator
@Timer(name="function")
def my_function():
    pass

# As a class
t = Timer()
t.start()
# Code to time
elapsed = t.stop()

Verify before relying

• Whether the package works correctly with Python versions beyond 3.11 despite no recent releases
• Current compatibility with modern Python async/await patterns
• Whether accumulated timer data in Timer.timers persists correctly across different execution contexts

Package facts

Evidence: codetiming-1.4.0-py3-none-any.whl

Keywords: timer, class, contextmanager, decorator

Tags

More Python Modules packages