timely 0.1

Python Timely
=============

Stopwatch interface for Python. Currently supports two modes: timing execution (:class:`Stopwatch`), and pausing the completion of a block of code until a specified time has elapsed :class:`Blocker`.

Stopwatch usage
---------------

::

with Stopwatch() as s:
do_a()
do_b()
print s.duration() # time it took to execute do_a() and do_b()
do_c()

print s.duration() # time it took to execute do_a(), do_b(), and do_c()

if s > 3: # comparators implicitly evaluate duration
print 'took longer than 3 seconds'

Blocker usage
-------------

::

with Blocker(3) as w:
print 'Happens immediately!'
time.sleep(1.5) # executes immediately
# ... we wait here until 3 seconds have passed

print '3 seconds have passed!'