Skip to main content

IPython-enabled pdb

Project description

IPython pdb

https://travis-ci.org/gotcha/ipdb.png?branch=master

Use

ipdb exports functions to access the IPython debugger, which features tab completion, syntax highlighting, better tracebacks, better introspection with the same interface as the pdb module.

Example usage:

import ipdb
ipdb.set_trace()
ipdb.pm()
ipdb.run('x[0] = 3')
result = ipdb.runcall(function, arg0, arg1, kwarg='foo')
result = ipdb.runeval('f(1,2) - 3')

The post-mortem function, ipdb.pm(), is equivalent to the magic function %debug.

If you install ipdb with a tool which supports setuptools entry points, an ipdb script is made for you. You can use it to debug your python 2 scripts like

$ bin/ipdb mymodule.py

And for python 3

$ bin/ipdb3 mymodule.py

Alternatively with Python 2.7 only, you can also use

$ python -m ipdb mymodule.py

You can also enclose code with the with statement to launch ipdb if an exception is raised:

from ipdb import launch_ipdb_on_exception

with launch_ipdb_on_exception():
    [...]

Warning

Context managers were introduced in Python 2.5. Adding a context manager implies dropping Python 2.4 support. Use ipdb==0.6 with 2.4.

Warning

Using from future import print_function for Python 3 compat implies dropping Python 2.5 support. Use ipdb<=0.8 with 2.5.

Development

ipdb source code and tracker are at https://github.com/gotcha/ipdb.

Pull requests should take care of updating the changelog HISTORY.txt.

Third-party support

Products.PDBDebugMode

Zope2 Products.PDBDebugMode uses ipdb, if available, in place of pdb.

iw.debug

iw.debug allows you to trigger an ipdb debugger on any published object of a Zope2 application.

ipdbplugin

ipdbplugin is a nose test runner plugin that also uses the IPython debugger instead of pdb. (It does not depend on ipdb anymore).

Changelog

0.8 (2013-09-19)

0.7.1 (2013-09-19)

0.7 (2012-07-06)

  • Add launch_ipdb_on_exception context manager. Implies dropping Python 2.4 support. [Psycojoker]
  • Wrap sys.excepthook only once. [marciomazza]
  • Add GPL file and refer in headers. [stan3]
  • Python 3 support. [Piet Delport]
  • Basic tests. [msabramo]
  • Added the functions runcall, runeval and run. [dimasad]

0.6.1 (2011-10-17)

  • State dependency on IPython later or equal to 0.10. [gotcha]

0.6 (2011-09-01)

0.5 (2011-08-05)

  • IPython 0.11 support. [lebedov]

0.4 (2011-06-13)

0.3 (2011-01-16)

  • Add post_mortem() for Products.PDBDebugMode support. [Jean Jordaan]
  • Moved to github.com.

0.2 (2010-10-20)

  • Added pm(). [Paulo Benedict Ang]

0.1 (2010-04-26)

  • First “non dev” release.

Project details


Release history Release notifications

History Node

0.11

History Node

0.10.3

History Node

0.10.2

History Node

0.10.1

History Node

0.10.0

History Node

0.9.4

History Node

0.9.3

History Node

0.9.2

History Node

0.9.1

History Node

0.9.0

History Node

0.8.3

History Node

0.8.2

History Node

0.8.1

This version
History Node

0.8

History Node

0.7.1

History Node

0.7

History Node

0.6.1

History Node

0.6

History Node

0.5

History Node

0.4

History Node

0.3

History Node

0.2

History Node

0.1

History Node

0.1dev-r1716

History Node

0.1dev-r1714

History Node

0.1dev-r1713

History Node

0.1dev-r1556

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
ipdb-0.8.zip (20.2 kB) Copy SHA256 hash SHA256 Source None Sep 19, 2013

Supported by

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