linetimer 0.1.2

A small Python class to quickly measure the time taken while executing a block of indented lines

linetimer: A small Python class to measure the time taken by indented lines.

linetimer is a small Python class to quickly measure the time taken by a block of indented lines

Installation

To install the library, simply type in pip install linetimer in your terminal.

Usage

The basic usage is:

from linetimer import CodeTimer

with CodeTimer():
   line_to_measure()
   another_line()
   # etc...

Which will show the following after the indented line(s) finishes executing:

Code block took: x.xxx ms

You can also name the code blocks you want to measure:

with CodeTimer('loop 1'):
   for i in range(100000):
      pass

with CodeTimer('loop 2'):
   for i in range(100000):
      pass

Code block 'loop 1' took: 4.991 ms
Code block 'loop 2' took: 3.666 ms

And nest them:

with CodeTimer('Outer'):
   for i in range(100000):
      pass

   with CodeTimer('Inner'):
      for i in range(100000):
         pass

   for i in range(100000):
      pass

Code block 'Inner' took: 2.382 ms
Code block 'Outer' took: 10.466 ms

To get time in a different unit, you can do this:

with CodeTimer('Block', unit='h'):
   slow_function()

Code block 'Block' took: 2.382 h

Supported units are ms, s , m, h corresponding to milliseconds, seconds, minutes, hours.

If you need to retain the time taken, you can do it with:

ct = CodeTimer()

with ct:
   slow_function()

ct.took # This contains the time taken as per the unit provided (milliseconds by default)

Finally, if you need to turn off the printed statements, use the silent=True argument

with CodeTimer(silent=True):
   slow_function()

# There will be no printed output

If you like this package, upvote it on StackOverflow.

Issues

If you encounter a problem, create an issue on Github.

Contributing

To contribute, please open an issue first and discuss your plan for contributing. Then fork this repository and commit a pull-request with your changes.