Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Quick application debugging and analysis for Python
Branch: master

Merge pull request #3 from jonashaag/patch-1

Fixed a typo in README.rst
latest commit d53af1e68b
@kennethreitz authored
Failed to load latest commit information.
AUTHORS Merge branch 'release/1.0.0'
HISTORY.rst Merge branch 'release/1.0.0'
LISENCE MIT Merge branch 'release/1.0.0'
NOTICE Merge branch 'release/1.0.0'
README.rst Fixed a typo in README.rst
reqs.txt publication.


ShowMe -- Quick and easy debugging for Python

ShowMe is a simple set of extremely useful function decorators for Python. It allows you to view trace information, execution time, cputime, and function documentation.


To use showme, simply:

pip install showme

or, if you must:

easy_install showme


Print passed-in arguments and function calls.

def complex_function(a, b, c, **kwargs):

>>> complex_function('alpha', 'beta', False, debug=True)
calling haystack.submodule.complex_function with
   args: ({'a': 'alpha', 'b': 'beta', 'c': False},)
   kwargs: {'debug': True}

Print function execution time.

def some_function(a):

>>> some_function()
Execution speed of __main__.some_function:
0.000688076019287 seconds

Print function cpu-execution time.

 def complex_function(a, b, c):

 >>> complex_function()
 CPU time for __main__.complex_function:
      3 function calls in 0.013 CPU seconds

ncalls  tottime  percall  cumtime  percall filename:lineno(function)
     1    0.013    0.013    0.013    0.013
     1    0.000    0.000    0.000    0.000 {method 'disable' of '_lsprof.Profiler' objects}
     1    0.000    0.000    0.000    0.000 {range}

Pretty print function documentation.
def complex_function():
    """Example Documentation for complex_function."""

>>> complex_function()
Documentation for __main__.complex_function:
Example Documentation for complex_function.
Something went wrong with that request. Please try again.