vprof is a Python package providing rich and interactive visualizations for various Python program characteristics such as running time and memory usage. It supports Python 2.7, Python 3.4, Python 3.5 and distributed under BSD license.
The project is in active development and some of it's features might not work as expected.
All contributions are highly encouraged! You can add new features, report and fix existing bugs and write docs and tutorials. Feel free to open issue or send pull request!
The required dependencies to build vprof
from source code:
- Python 2.7, Python 3.4 or Python 3.5
pip
npm
>= 3.3.12
All Python and npm
module dependencies are listed in package.json and requirements.txt.
vprof
can be installed from PyPI
pip install vprof
To install current dev version, clone this repository and execute
python setup.py deps_install && python setup.py build_ui && python setup.py install
To install just vprof
dependencies, run
python setup.py deps_install
vprof -c <modes> -s <test_program>
Supported modes:
c
- flame chart. Renders running time visualization for<test_program>
.m
- memory graph. Shows memory usage during execution of each line of<test_program>
.h
- code heatmap. Shows number of executions of each line of code.
<test_program>
can be Python source file (e.g. testscript.py
), installed Python package (e.g. runpy
) or path to package (e.g. myproject/test_package
).
Use double quotes to run scripts with arguments:
vprof -c cmh -s "testscript.py --foo --bar"
Modes can be combined:
vprof -c cm -s testscript.py
vprof
can also profile single functions. In order to do this,
launch vprof
in remote mode:
vprof -r
and then to profile a function you can do:
from vprof import profiler
def foo(arg1, arg2):
...
profiler.run(foo, 'cmh', args=(arg1, arg2), host='localhost', port=8000)
where cmh
is profiling mode, host
and port
are hostname and
port of vprof
server launched in remote mode.
You can check vprof -h
for full list of supported parameters.
Just run
python setup.py test && python setup.py e2e_test
BSD