25.10.1 Command Line Usage
The trace module can be invoked from the command line. It can be
as simple as
python -m trace --count somefile.py ...
The above will generate annotated listings of all Python modules imported
during the execution of somefile.py.
The following command-line arguments are supported:
- --trace, -t
- Display lines as they are executed.
- --count, -c
- Produce a set of annotated listing files upon program
completion that shows how many times each statement was executed.
- --report, -r
- Produce an annotated list from an earlier program run that
used the --count and --file arguments.
- --no-report, -R
- Do not generate annotated listings. This is useful if you intend to make
several runs with --count then produce a single set
of annotated listings at the end.
- --listfuncs, -l
- List the functions executed by running the program.
- --trackcalls, -T
- Generate calling relationships exposed by running the program.
- --file, -f
- Name a file containing (or to contain) counts.
- --coverdir, -C
- Name a directory in which to save annotated listing files.
- --missing, -m
- When generating annotated listings, mark lines which
were not executed with `
- --summary, -s
- When using --count or --report, write a
brief summary to stdout for each file processed.
- Ignore the named module and its submodules (if it is
a package). May be given multiple times.
- Ignore all modules and packages in the named directory
and subdirectories. May be given multiple times.
See About this document... for information on suggesting changes.