Skip to main content

measure/limit the function execution time, cross-platform

Project description

timework

PyPI Build Status Coverage Status CodeFactor PyPI - Python Version platform

measure / limit the function execution time, cross-platform

Install

pip install timework

Usage

import timework as tw

timework.timer

A decorator measuring the execution time.

timework.TimeError contains three parts:

  • TimeError.message string, <decorated function name>: <time used> seconds used
  • TimeError.result return values of the function being decorated
  • TimeError.detail float, time used

Notice: In @timer decorator, timeout is used to raise a Error after the decorated function finishes, but fails to finish within timeout seconds. If you want to terminate the function with a timeout limit, please use @limit.

import logging

@tw.timer(logging.warning)
def timer_demo_a():
    i = 0
    while i < 2 ** 23:
        i += 1
    return i

@tw.timer(print, detail=True)
def timer_demo_b():
    i = 0
    while i < 2 ** 24:
        i += 1
    return i

@tw.timer(timeout=1)
def timer_demo_c():
    i = 0
    while i < 2 ** 25:
        i += 1
    return i
a = timer_demo_a()
b = timer_demo_b()

try:
    c = timer_demo_c()
except tw.TimeError as e:
    print('error:', e.message)
    c = e.result

print(a, b, c)
WARNING:root:timer_demo_a: 0.496672 seconds used
START:  Tue Feb 18 15:06:45 2020
FINISH: Tue Feb 18 15:06:46 2020
timer_demo_b: 0.989352 seconds used
error: timer_demo_c: 1.9817 seconds used
8388608 16777216 33554432

timework.limit

A decorator limiting the execution time.

timework.TimeError only contains:

  • TimeError.message string, <decorated function name>: <timeout> seconds exceeded
  • TimeError.result None, unused
  • TimeError.detail None, unused
@tw.limit(3)
def limit_demo(m):
    i = 0
    while i < 2 ** m:
        i += 1
    return i
try:
    s = limit_demo(4)
except tw.TimeError as e:
    print(e)
else:
    print('result:', s)

try:
    s = limit_demo(30)
except tw.TimeError as e:
    print(e)
else:
    print('result:', s)
result: 16
limit_demo: 3 seconds exceeded

You can read docstrings for more details.

License

MIT License © bugstop

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for timework, version 0.2.10
Filename, size File type Python version Upload date Hashes
Filename, size timework-0.2.10-py3-none-any.whl (5.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size timework-0.2.10.tar.gz (5.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page