Human readable function time measuring.
Project description
ntropy - Human readable function time measuring
About · Usage · Testing
🗣️ About
A very simple utility to decorate your functions with that shows you how long that function took to run. Zero dependencies, uses only what Python already gives you.
🛠️ Usage
Requirements
- python >= 3.8 (for TypedDict support)
Usage instructions
- Install this package with
pip install ntropy-timer
; - Import the
measure_time
function and decorate the function you wish to measure:
from ntropy import measure_time
###
@measure_time
def measure_this_function(*args, **kwargs):
# do something
- Then just execute the function and you should see the results in the standard output:
measure_this_function()
# > The function 'measure_this_function' took 12 seconds 389 miliseconds to run.
Parameters
Disabling the gargabe collector for more precise measurements: disable_gc
(default: False
)
With the disable_gc
flag, you can temporarily disable Python's garbage collector while the decorated function runs. This can be useful for more accurately measuring time specific to that function, tuning outside noise down to a minimum.
Showing a more straightforward run time message: message_format
(possible values: "human", "complete"
; default: "human"
)
If you'd like to see a more standard message, showing even zero values, you can pass in the message_format="complete"
parameter. It will go from:
The function 'measure_this_function' took 3 minutes 33 seconds 123 miliseconds to run.
to
The function 'measure_this_function' took 0hr 3min 33sec 123ms to run.
📋 Developing
Requirements
ntropy
has no requirements to run, but it has to be developed. Clone this repository and install the dev requirements with
pip install -r dev-requirements.txt
Testing
To run tests (after installing dev dependencies):
pytest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.