Skip to main content
PuDB is a full-screen, console-based visual debugger for Python.

Its goal is to provide all the niceties of modern GUI-based debuggers in a
more lightweight and keyboard-friendly package. PuDB allows you to debug code
right where you write and test it--in a terminal. If you've worked with the
excellent (but nowadays ancient) DOS-based Turbo Pascal or C tools, PuDB's UI
might look familiar.



Here's a screenshot:

.. image:: http://tiker.net/pub/pudb-screenshot.png

You may watch a `screencast <http://vimeo.com/5255125>`_, too.

Features
--------

* Syntax-highlighted source, the stack, breakpoints and variables are all
visible at once and continuously updated. This helps you be more aware of
what's going on in your program. Variable displays can be expanded, collapsed
and have various customization options.

* Simple, keyboard-based navigation using single keystrokes makes debugging
quick and easy. PuDB understands cursor-keys and Vi shortcuts for navigation.
Other keys are inspired by the corresponding pdb coomands.

* Use search to find relevant source code, or use "m" to invoke the module
browser that shows loaded modules, lets you load new ones and reload existing
ones.

* Breakpoints can be set just by pointing at a source line and hitting "b" and
then edited visually in the breakpoints window. Or hit "t" to run to the line
under the cursor.

* Drop to a Python shell in the current environment by pressing "!".

* PuDB places special emphasis on exception handling. A post-mortem mode makes
it easy to retrace a crashing program's last steps.

Installing
----------

Install PuDB using the command::

easy_install pudb

Getting Started
---------------

To start debugging, simply insert::

from pudb import set_trace; set_trace()

into the piece of code you want to debug, or run the entire script with::

python -m pudb.run my-script.py

License and Dependencies
------------------------

PuDB is distributed under the MIT license. It relies on the following
excellent pieces of software:

* Ian Ward's `urwid <http://excess.org/urwid>`_ console UI library
* Georg Brandl's `pygments <http://pygments.org>`_ syntax highlighter

Development Version
-------------------

You may obtain the development version using the `Git <http://git-scm.org/>`_
version control tool.::

git clone http://git.tiker.net/trees/pudb.git

You may also `browse the code <http://git.tiker.net/pudb.git>`_ online.

Metadata

Release files for pudb 0.92.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pudb 0.92.6
File Size Uploaded
pudb-0.92.6.tar.gz 25.0 kB Details

Release files / pudb-0.92.6.tar.gz

Download URL pudb-0.92.6.tar.gz
Size 25.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e38a347dab8442b8f224c202760e1bc4d39707babd31cc63e3a66df53cf0d49c
BLAKE2b-256 checksum
How to use checksums
a83082e0a0941cd1d548df43a13de953af583d7882d04946b671f0c0e4d9762e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

2026.1

2 release files

2024.1

1 release file

2023.1

1 release file

2022.1

1 release file

2021.2

1 release file

2021.1

1 release file

2020.1

1 release file

2019.2

1 release file

2019.1

1 release file

2018.1

1 release file

2017.1

1 release file

2016.2

1 release file

2016.1

1 release file

2015.4

1 release file

2015.3

1 release file

2015.2

1 release file

2015.1

1 release file

2014.1

2 release files

2013.5

2 release files

2013.4

1 release file

2013.3

1 release file

2013.2

1 release file

2013.1

1 release file

2012.3

1 release file

2012.2

1 release file

2012.1

1 release file

2011.3

1 release file

2011.2

1 release file

2011.1

1 release file

0.93.1

1 release file

0.93

1 release file

0.92.15

1 release file

0.92.14

1 release file

0.92.13

1 release file

0.92.12

1 release file

0.92.11

1 release file

0.92.10

1 release file

0.92.9

1 release file

0.92.8

1 release file

0.92.7

1 release file

This release

0.92.6 This release

1 release file

0.92.5

1 release file

0.92.4

1 release file

0.92.3

1 release file

0.92.2

1 release file

0.92.1

1 release file

0.92

1 release file

0.91.5

1 release file

0.91.4

1 release file

0.91.3

1 release file

0.91.2

1 release file

0.91.1

1 release file

0.91

1 release file

0.90.6

1 release file

0.90.5

1 release file

0.90.4

1 release file

0.90.3

1 release file

0.90.2

1 release file

0.90.1

1 release file

0.90

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page