Skip to main content

Open, extensible Python injector/profiler/analyzer

Project description

ppTOP

ppTOP is open, extensible Python injector/profiler/analyzer.

The main idea is to inject a custom code inside Python process (already running or going to be launched) and analyze its behavior with no any code modifications.

Say no to "prints" and garbage in debug logs - now you have ppTOP. A modern MRI scanner for Python.

Installation

  pip3 install pptop
  • Python: 3.5+ is required, as ppTOP uses asyncore
  • Install gdb
  • Only Linux systems are currently supported

Features

ppTOP can be injected into any running Python process

asciicast

or you can load Python program manually and profile its launch

asciicast

Data from connected process is collected in real-time and displayed in table-based console UI, which can be easily extended with custom plugins.

Standard plugins

  • env view process OS environment variables
  • log inject into all Python loggers and collect log messages
  • open_files view process open files
  • script_runner launch a custom scripts inside process
  • threads view process threads
  • vars variable/function watcher
  • yappi yappi profiler/plugin

Most of plugins contain 2 parts of code: one collects data inside profiling process, other display it in ppTOP UI. For the profiling process all plug-ins are invisible, safe and unloadable (at least they try their best :)

Console mode

With "`" button, remote Python console can be opened. It has no full functionality like a standard Python console, but it supports all frequently used features, like importing modules, defining functions and variables, executing functions and loops.

asciicast

Plugin docs

Plugins for ppTOP are very easily to write, it takes only about 100-150 lines of code, as Core API provides all basic functionality: loading data, processing data, sorting data etc.

Plugin development guide is coming very soon.

TODO

  • [ ] More plugins
  • [ ] Advanced filtering
  • [ ] Data snapshots
  • [ ] Step-by-step debugger
  • [ ] JSON API, web interface
  • [ ] Charts

Enjoy! :)

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pptop, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pptop-0.1.0.tar.gz (25.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page