Go to file
2018-10-05 10:44:25 -04:00
doc Mention shells in separate terminal docs 2018-10-02 01:39:51 +03:00
manual-tests Convert tests to pytest 2016-03-31 09:15:31 -05:00
pudb Flake8 fixes 2018-10-01 23:50:57 -05:00
test Fix encoding tests on py2 2018-08-20 18:15:28 -05:00
.coveragerc Added TravisCI and codecove.io support 2017-04-06 18:52:23 +03:00
.gitignore Added TravisCI and codecove.io support 2017-04-06 18:52:23 +03:00
.gitlab-ci.yml Add Pytest/JUnit/Gitlab integration, Py37 CI 2018-09-23 14:12:54 -04:00
.mailmap Add .mailmap 2013-03-11 19:14:57 -06:00
.travis.yml Try to fix coverage uploading 2017-04-08 17:36:00 -05:00
debug_me.py Add rudimentary remote debugging support 2015-09-15 04:16:15 -05:00
example-shell.py Note in example-shell.py that returning returns control to the debugger 2017-04-17 14:09:12 -04:00
example-stringifier.py Update run_with_timeout docstring 2011-08-09 05:22:50 -06:00
example-theme.py Add note to example-theme.py about curses and raw modes 2013-12-05 20:48:07 -07:00
LICENSE Create docs, trim README (Fixes #239 on Github) 2017-04-05 17:01:16 -05:00
MANIFEST.in Add separate license file (requested by Dhiru Kolia) 2013-09-06 13:33:24 -05:00
README.rst Describe controlling debugger from a separate terminal in docs 2018-09-23 17:00:20 +03:00
requirements.dev.txt Upgrade pytest-mock in requirements.dev.txt 2018-10-05 10:44:25 -04:00
setup.cfg wheel: disable universal flag 2015-11-12 22:00:19 +09:00
setup.py Update PyPI info 2016-06-27 10:29:29 -05:00
try-the-debugger.sh Minor fix to bfroehle's Python 3 changes. 2012-07-14 16:29:32 -04:00
upload_coverage.sh Try to fix coverage uploading 2017-04-08 17:36:00 -05:00

.. image:: https://travis-ci.org/inducer/pudb.svg?branch=master
  :target: https://travis-ci.org/inducer/pudb

.. image:: https://codecov.io/gh/inducer/pudb/branch/master/graph/badge.svg
  :target: https://codecov.io/gh/inducer/pudb

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:: https://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 commands.

* 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.

* Ability to control the debugger from a separate terminal.

* IPython integration (see `wiki <http://wiki.tiker.net/PuDB>`_)

* Should work with Python 2.6 and newer, including Python 3.

Links
-----

`PuDB documentation <https://documen.tician.de/pudb>`_

PuDB also has a `mailing list <http://lists.tiker.net/listinfo/pudb>`_ that
you may use to submit patches and requests for help.  You can also send a pull
request to the `GitHub repository <https://github.com/inducer/pudb>`_

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.

The repository is also mirrored at `GitHub <https://github.com/inducer/pudb>`_.