Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A port of Andy Wingo's statprof.py to newer python by Alex Fraser

tree: 3d9ca95cfb

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 .gitignore Add some ignore files April 06, 2012
Octocat-spinner-32 .hgignore Merge June 13, 2012
Octocat-spinner-32 .hgtags Added tag 0.1.2 for changeset 99b06813755f April 10, 2012
Octocat-spinner-32 AUTHORS add AUTHORS June 13, 2012
Octocat-spinner-32 LICENSE rename COPYING to LICENSE June 13, 2012
Octocat-spinner-32 MANIFEST.in fix MANIFEST.in declaration June 13, 2012
Octocat-spinner-32 README.rst add profile contextmanager June 10, 2012
Octocat-spinner-32 setup.py
Octocat-spinner-32 statprof.py Add a format option to group results by function. November 01, 2012
README.rst

statprof - statistical profiling for Python

This package provides a simple statistical profiler for Python.

Python's default profiler has been lsprof for several years. This is an instrumenting profiler, which means that it saves data on every action of interest. In the case of lsprof, it runs at function entry and exit. This has problems: it can be expensive due to frequent sampling, and it is blind to hot spots within a function.

In contrast, statprof samples the call stack periodically (by default, 1000 times per second), and it correctly tracks line numbers inside a function. This means that if you have a 50-line function that contains two hot loops, statprof is likely to report them both accurately.

Note

This package does not yet work on Windows! See the implementation and portability notes below for details.

Basic usage

It's easy to get started with statprof:

import statprof

statprof.start()
    try:
        my_questionable_function()
finally:
        statprof.stop()
            statprof.display()

Or with a contextmanager :

import statprof

with statprof.profile():
    my_questionable_function()

For more comprehensive help, run pydoc statprof.

Portability

Because statprof uses the Unix itimer signal facility, it does not currently work on Windows. (Patches to improve portability would be most welcome.)

Implementation notes

The statprof profiler works by setting the Unix profiling signal ITIMER_PROF to go off after the interval you define in the call to reset(). When the signal fires, a sampling routine is run which looks at the current procedure that's executing, and then crawls up the stack, and for each frame encountered, increments that frame's code object's sample count. Note that if a procedure is encountered multiple times on a given stack, it is only counted once. After the sampling is complete, the profiler resets profiling timer to fire again after the appropriate interval.

Meanwhile, the profiler keeps track, via os.times(), how much CPU time (system and user -- which is also what ITIMER_PROF tracks), has elapsed while code has been executing within a start()/stop() block.

The profiler also tries (as much as possible) to avoid counting or timing its own code.

History

This package was originally written and released by Andy Wingo. It was ported to modern Python by Alex Frazer, and posted to github by Jeff Muizelaar. The current maintainer is Bryan O'Sullivan.

Reporting bugs, contributing patches

The current maintainer of this package is Bryan O'Sullivan.

Please report bugs using the github issue tracker.

If you'd like to contribute patches, please do - the source is on github, so please just issue a pull request.

$ git clone git://github.com/bos/statprof.py
Something went wrong with that request. Please try again.