Tools for injecting arbitrary code into running Python processes.

Requirements

• gdb (version 7.3+ (or RHEL5+))

On OS X you will need to have a codesigned gdb - see https://sourceware.org/gdb/wiki/BuildingOnDarwin if you get errors while running with --verbose which mention codesigning.


Compatiblity
Pyrasite works with Python 2.4 and newer. Injection works between versions as well, so you can run Pyrasite under Python 3 and inject into 2, and vice versa.

Usage

usage: pyrasite [-h] [--gdb-prefix GDB_PREFIX] [--verbose] [--output OUTPUT_TYPE] pid [filepath|payloadname]
        pyrasite --list-payloads
 
 pyrasite - inject code into a running python process
 
 positional arguments:
   pid                   The ID of the process to inject code into
   filepath|payloadname  The second argument must be a path to a
                         file that will be sent as a payload to the
                         target process or it must be the name of
                         an existing payload (see --list-payloads).
 
 optional arguments:
   -h, --help            show this help message and exit
   --gdb-prefix GDB_PREFIX
                         GDB prefix (if specified during installation)
   --verbose             Verbose mode
   --output OUTPUT_TYPE  This option controls where the output from
                         the executed payload will be printed. If
                         the value is 'procstreams' (the default) then
                         the output is sent to the stdout/stderr of the
                         process. If the value is 'localterm' then the
                         output is piped back and printed on the local
                         terminal where pyrasite is being run.
   --list-payloads       List payloads that are delivered by pyrasite
 
 For updates, visit https://github.com/lmacken/pyrasite
 

pyrasite-gui
The graphical interface can be found here: https://github.com/lmacken/pyrasite-gui

Requirements

• Python debuginfo (needed for live object inspection)
• PyGObject3 Introspection bindings
• WebKitGTK3
• meliae (easy_install/pip may not work for this install. If not, use the tarball from the distribution website. You may need to install Cython in order to get meliae to build)
• pycallgraph
• psutil

Screenshots

homepage:	http://pyrasite.com
documentation:	http://pyrasite.rtfd.org
download:	http://pypi.python.org/pypi/pyrasite
source:	http://github.com/lmacken/pyrasite
screenshots:	http://readthedocs.org/docs/pyrasite/en/latest/GUI.html
mailing list:	https://fedorahosted.org/mailman/listinfo/pyrasite
jenkins:	http://ci.csh.rit.edu/view/Pyrasite
irc:	#pyrasite on Freenode