stopuhr

stopuhr.stopuhr(msg: str, printer: callable = <built-in function print>, res: int = 2)

Context manager to measure the time taken in a block.

Example

Stop the time with a simple context manager and print the duration.

>>> import time

>>> from stopuhr import stopuhr

>>> with stopuhr("Sleeping"):
>>>     time.sleep(0.1)
Sleeping took 0.10s

Instead of printing, one can pass any callable to the printer argument, e.g. a logger.

>>> import logging

>>> logger = logging.getLogger(__name__)
>>> logger.setLevel(logging.INFO)
>>> handler = logging.StreamHandler()
>>> handler.setFormatter(logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s"))
>>> logger.addHandler(handler)

>>> with stopuhr("Sleeping", printer=logger.info):
>>>     time.sleep(0.1)
2025-03-27 19:11:10,912 - __main__ - INFO - Sleeping took 0.10s

By default, the output is rounded to two decimal places. This can be changed with the res argument.

>>> with stopuhr("Sleeping", res=3):
>>>     time.sleep(0.16189)
Sleeping took 0.162 s

Parameters:

• msg (str) – The message to print.

• printer (callable, optional) – The function to print with. Defaults to print.

• res (int, optional) – The number of decimal places to round to. Defaults to 2.