Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Importing this module enables automatic post mortem debugging upon any exception. It uses module specified in envvar

Project Description


This is a simple module which enables you to have automatic post-mortem debugging as simply as possible


Install it using pip install autodebug.

Then in your Python script, before the possible exception write

import autodebug

Then if any uncaught exception happens, you’ll be immediately transferred to debugger. Exactly the moment before the exception occured. So you’ll have access to all variables and everything.


You can specify which Python debugger you want to use.

To do that simply set the environmental variable AUTO_DEBUG. Possible debuggers currently are:

  • pdb for built-in Python debugger
  • ipdb for ipdb Python debugger
  • pudb for full-screen console Python debugger.

If you do not set the variable, pdb will be used, as it is built-in.

Post notes

  • Please note that this module uses custom sys.excepthook, so if you are using your own, this module will not work, or will overwrite your excepthook (This depends on order of import and setting your own excepthook)
  • In order to make it work with uwsgi you have to pass --honour-stdin to uwsgi configuration. This will make it possible to debug uwsgi applications!. But keep in mind, that if you’ve got more than 1 worker, and multiple people are using your application, the terminal output will be ugly.
  • The debugger won’t start if it is imported inside interactive console, so it may not work in some IDEs. Experiment yourself, however it is adviced to start your programs using command line.

Release History

This version
History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(2.2 kB) Copy SHA256 Hash SHA256
Source None Aug 31, 2014

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers