Skip to main content

A timer module. Makes it easy to track elapsed time.

Project description

A timer module. Makes it easy to track elapsed time.


Latest stable version on PyPI:

$ pip install simple_timer

Latest stable version on bitbucket:

$ pip install -e hg+

Usage example

Required imports.

>>> from simple_timer import Timer

Initialise timer.

>>> timer = Timer()

Print elapsed duration.

>>> print timer.duration

Print elapsed timedelta.

>>> print timer.timedelta
datetime.timedelta(0, 0, 7)

Stop the timer. Stopping the timer makes the duration and timedelta properties to freeze.

>>> timer.stop()

Print frozen timedelta value.

>>> print timer.timedelta
datetime.timedelta(0, 2, 943660)

Print frozen duration value.

>>> print timer.duration

Once stoped, when calling the stop method again unfreezes the timer, calculates the new values and freezes the timer again.

Shortcut for stopping and returning the duration value.

>>> timer.stop_and_return_duration()

Shortcut for stopping and returning the timedelta value.

>>> timer.stop_and_return_timedelta()
datetime.timedelta(0, 170, 351115)


GPL 2.0/LGPL 2.1


Artur Barseghyan <>

Project details

Download files

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

Source Distribution

simple_timer-0.2.tar.gz (3.0 kB view hashes)

Uploaded source

Supported by

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