NAME

       pprofile - Line-granularity, thread-aware deterministic and statistic pure-python profiler

SYNOPSIS

       pprofile3 [options] some-python-module [arguments]

DESCRIPTION

       This manual page documents briefly the pprofile3 command.

       pprofile  is  a  Line-granularity,  thread-aware  deterministic  and statistic pure-python
       profiler

       Line-granularity, thread-aware deterministic and  statistic  pure-python  profiler.   Line
       granularity  allows  locating  precisely  where  time  is spent in code.  Thread awareness
       automatically propagates profiling to all threads  (all  threads  in  statistic  mode,  or
       threads  spawned  by  profiled code in deterministic mode).  Deterministic profiling gives
       precise measures, but at a  large  speed  cost  (best  used  on  minimal  test  scenario).
       Statistic  profiling  gives rough measure, but has an extremely low overhead (suitable for
       live code profiling).  Does not require marking methods to  profile,  allowing  non-method
       profiling  (module  imports,  class  & function declarations and other module-level code).
       Can produce callgrind output.

OPTIONS

       -h, --help
              Show summary of options.

       -m MODULE
               Searches sys.path for the named module and runs the corresponding .py file as a
               script. When given, positional argumentsbecome sys.argv[1:].

       -o, --out OUT
              Write annotated sources to this file. Defaults to stdout.

       -z, --zipfile ZIPFILE
              Name of a zip file to generate from all involved source files. Useful with
               callgrind output.

       -t, --threads THREADS
              If non-zero, trace threads spawned by program. Default: 1.

       -f, --format callgrind,text
              Format in which output is generated. If not set,  auto-detected  from  filename  if
              provided, falling back to "text".

       -v, --verbose
              Enable profiler internal tracing output. Cryptic and verbose.

       -s, --statistic STATISTIC
              Use this period for statistic profiling, or use deterministic profiling when 0.

AUTHOR

       pprofile was written by Vincent Pelletier <plr.vincent@gmail.com>

       This  manual  page  was  written by Josue Ortega <josue@debian.org> for the Debian project
       (and may be used by others).

                                           Oct 23, 2016                              PPROFILE3(1)