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`.
with Stopwatch() as s:
print s.duration() # time it took to execute do_a() and do_b()
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'
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!'
TODO: Brief introduction on what you do with files - including link to relevant help section.