Scroll to navigation

PYCALLGRAPH(1) User Commands PYCALLGRAPH(1)

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.
2008-07-08 pycallgraph version 0.5.1