⏱️ tictac

tictac - a simple timer for your code

(─‿‿─)

   __  _      __            
  / /_(_)____/ /_____ ______
 / __/ / ___/ __/ __ `/ ___/
/ /_/ / /__/ /_/ /_/ / /__  
\__/_/\___/\__/\__,_/\___/  
                            

installation

pip install tictac-timer

quick start

from tictac import timer
import time

# context manager
with timer("data loading"):
    time.sleep(1.2)
    # [tictac] data loading: 1.20 sec

# decorator
@timer
def heavy_process():
    time.sleep(0.5)
    # [tictac] heavy_process: 0.50 sec

# decorator with parameters
@timer("processing", unit="ms")
def fast_process():
    time.sleep(0.01)
    # [tictac] processing: 10.00 ms

parameters

timer(name=None, unit="s", output=None)

• name — timer label (defaults to function name)
• unit — time unit: "s", "ms", "min"
• output — callback (msg: str) -> None (defaults to print)

examples

custom output

import logging

log = logging.getLogger(__name__)

with timer("query", output=log.info):
    db.execute("SELECT ...")

multiple timers

with timer("preparation"):
    time.sleep(0.3)

with timer("processing", unit="ms"):
    time.sleep(15)

# [tictac] preparation: 0.30 sec
# [tictac] processing: 15.00 ms

license

AGPL-3.0