Go to file
2021-05-14 17:43:51 -05:00
.github/workflows Drop codecov 2021-04-29 18:03:18 -05:00
doc Fix README screenshot situation 2021-04-17 14:40:37 -05:00
manual-tests Convert tests to pytest 2016-03-31 09:15:31 -05:00
pudb Fix flag name 2021-05-14 19:17:02 +02:00
test Add a "default" stringifier 2021-04-02 12:21:53 -06:00
.coveragerc Added TravisCI and codecove.io support 2017-04-06 18:52:23 +03:00
.editorconfig Add .editorconfig 2020-06-23 00:09:02 -05:00
.gitignore Add tags to .gitignore 2020-08-15 10:50:18 -06:00
.gitlab-ci.yml Add pylint CI config 2021-03-24 17:47:26 -05:00
.mailmap Add .mailmap 2013-03-11 19:14:57 -06:00
.pylintrc-local.yml Fix pytest pylint ignores 2021-03-24 17:56:34 -05:00
debug_me.py BE->AE spelling in debug_me 2021-03-15 16:50:54 -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 Address @mvanderkamp's comments in the pylint/drop-py2 PR 2021-03-26 17:05:59 -05: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 FIX manifest, drop unused screenshot 2021-05-08 15:10:58 -05:00
README.rst Fix README screenshot situation 2021-04-17 14:40:37 -05:00
requirements.dev.txt Drop rigid versions in requirements.dev.txt 2021-05-14 17:43:51 -05:00
setup.cfg Add more project links 2021-03-04 07:57:14 +00:00
setup.py Bump pygments dep for CVE-2021-27291 2021-04-08 12:11:47 -05:00
try-the-debugger.sh Enable, fix quotes linting 2020-09-28 13:53:53 -05:00

PuDB: a console-based visual debugger for Python
================================================

.. image:: https://gitlab.tiker.net/inducer/pudb/badges/main/pipeline.svg
    :alt: Gitlab Build Status
    :target: https://gitlab.tiker.net/inducer/pudb/commits/main
.. image:: https://github.com/inducer/pudb/workflows/CI/badge.svg?branch=main&event=push
    :alt: Github Build Status
    :target: https://github.com/inducer/pudb/actions?query=branch%3Amain+workflow%3ACI+event%3Apush
.. image:: https://badge.fury.io/py/pudb.png
    :alt: Python Package Index Release Page
    :target: https://pypi.org/project/pudb/

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.

Here are some screenshots:

* Light theme

  .. image:: doc/images/pudb-screenshot-light.png

* Dark theme

  .. image:: doc/images/pudb-screenshot-dark.png

You may watch screencasts too:

* `Meet Pudb, a debugger for Python code (2020) <https://www.youtube.com/watch?v=bJYkCWPs_UU>`_

* `PuDB Intro Screencast (2009) <http://vimeo.com/5255125>`_

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.

* Pre-bundled themes, including dark themes via "Ctrl-P". Could set a custom theme also.

* 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 "!".
  Or open a command prompt alongside the source-code via "Ctrl-X".

* 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 3.6 and newer. (Versions 2019.2 and older continue
  to support Python 2.7.)

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 https://github.com/inducer/pudb.git

You may also `browse the code <https://github.com/inducer/pudb>`_ online.