pycallgraph

Langue: en

Version: 2008-07-08 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

pycallgraph - command-line interface to pycallgraph

SYNOPSIS

pycallgraph [OPTION]... pythonfile  

DESCRIPTION

This manual page documents pycallgraph. This manual page was originally written for the Debian distribution.

pycallgraph is a program that creates call graphs for Python programs. pycallgraph is the command line interface to pycallgraph's make_dot_graph method, which generates a call graph and stores it as an image in the specified image file.

-o, --output-file
the file name of the output image. Default: pycallgraph.png
-f, --image-format
the image format of imagefile. Default: png
-q, --quiet
Suppress status output to the console.
-t, --tool
the tool from GraphViz to use. Default: dot
-s, --stdlib
include standard library functions in the trace. Default: False
-i, --include
wildcard pattern of modules to include in the output. You can have multiple include arguments
-e, --exclude
wildcard pattern of modules to exclude in the output. You can have multiple exclude arguments
-d, --max-depth
maximum stack depth to trace
--exclude-timing
wildcard pattern of modules to exclude in time measurement. You can have multiple exclude arguments
--include-timing
wildcard pattern of modules to include in time measurement. You can have multiple include arguments
 

EXAMPLES

Create a call graph called pycallgraph.png on myprogram.py:

pycallgraph ./myprogram.py

Create a call graph of a standard Python installation script with command line parameters:

pycallgraph --output-file=setup.png -- setup.py --dry-run install

Only see the module "distutils" within the execution of easy_install:

pycallgraph --include=distutils.* /usr/bin/easy_install

AUTHORS

pycallgraph and pycallgraph were written by Gerald Kaszuba <pycallgraph@slowchop.com>.

This manual page was originally written by Jan Alonzo <jmalonzo@unpluggable.com>, for the Debian GNU/Linux system.