profilehooks

It’s a collection of decorators for profiling functions. E.g. to profile a single function:

from profilehooks import profile

@profile
def my_function(args, etc):
    pass

The results will be printed when the program exits (or you can use @profile(immediate=True)).

If you’re interested in coarse timings and don’t want to pay for the overhead of profiling, use

from profilehooks import timecall

@timecall       # or @timecall(immediate=True)
def my_function(args, etc):
    pass

Finally, you may be interested in seeing line coverage for a single function

from profilehooks import coverage

@coverage
def my_function(args, etc):
    pass

Also functions can be available in Python console or module if run it with -m arg

$ python -m profilehooks
>>> profile
<function profile at 0x1005c6488>

$ python -m profilehooks yourmodule

Full documentation is available through pydoc profilehooks after installation.

The home page for this module is http://mg.pov.lt/profilehooks. It has screensho, uh, that is, more examples.

Changelog

Make @profile(profiler='hotshot') work again. This was probably broken in 1.0 or 1.1, but nobody complained.
Fix missing space in the output of @profile(skip=N).
Make @coverage_with_hotshot output match @coverage output precisely.
100% test coverage.
Claim Python 3.4 and PyPy compatibility.

Explicitly claim Python 3.3 compatibility.
Fix Python 3.x bug with @coverage (stop using sys.maxint): https://github.com/mgedmin/profilehooks/issues/2.

New argument to @timecall: timer (defaults to time.time). Example: @timecall(timer=time.clock)
Better documentation.

Added support for cProfile, make it the default profiler when available. Previously profilehooks supported profile and hotshot only.

Store profile results (when you pass filename to @profile) in pstats format instead of pickles. Contributed by Florian Schulze.

First release to PyPI, with a setup.py and everything.
New arguments to @profile: dirs, sort, entries. Contributed by Hanno Schlichting.
Preserve function attributes such as __doc__ and __module__ when decorating them.
Pydoc-friendly docstring wrapping and other docstring improvements.

Changed licence from GPL to MIT.
New decorator: @timecall
New arguments to @profile: skip, filename, immediate.
Added support for profile, after becoming convinced hotshot was unreliable. Made it the default profiler.

First public release (it didn’t actually have a version number), announced on my blog: http://mg.pov.lt/blog/profiling.html
@profile and @coverage decorators that didn’t accept any arguments.
hotshot was the only profiler supported for @profile, while @coverage used trace.py

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for profilehooks 1.8.0
File	Size	Uploaded
profilehooks-1.8.0.tar.gz	14.2 kB	Mar 25, 2015	Details

Download URL	profilehooks-1.8.0.tar.gz
Size	14.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`52277ed965938d8b6293aa41cb35278c72c9a6dd3f6e9f89c45da74767dbd6ea`
BLAKE2b-256 checksum How to use checksums	`127fb5f0a938f5e6ec2e62cff840d381752d1cacee7d1371d834e9ec8e221517`
Upload date	Mar 25, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No