Skip to main content

A full-screen, console-based Python debugger

Project description

Gitlab Build Status Github Build Status Python Package Index Release Page

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

    doc/images/pudb-screenshot-light.png
  • Dark theme

    doc/images/pudb-screenshot-dark.png

You may watch screencasts 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.

  • 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)

  • Should work with Python 3.6 and newer. (Versions 2019.2 and older continue to support Python 2.7.)

Development Version

You may obtain the development version using the Git version control tool.:

git clone https://github.com/inducer/pudb.git

You may also browse the code online.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

pudb-2025.1.tar.gz (220.6 kB view details)

Uploaded Source

Built Distribution

pudb-2025.1-py3-none-any.whl (89.2 kB view details)

Uploaded Python 3

File details

Details for the file pudb-2025.1.tar.gz.

File metadata

  • Download URL: pudb-2025.1.tar.gz
  • Upload date:
  • Size: 220.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.3

File hashes

Hashes for pudb-2025.1.tar.gz
Algorithm Hash digest
SHA256 a528b29c69ce8b182a337872c5f046071f6d68d3415c6d7bf53bd27c264f58d0
MD5 0dac4f02e2b4b6b1a2fc10622a1dcca2
BLAKE2b-256 93408d17b16a1c2a36d8cc1befb5eda13310ad20fcb347e58bef5e104696e14a

See more details on using hashes here.

File details

Details for the file pudb-2025.1-py3-none-any.whl.

File metadata

  • Download URL: pudb-2025.1-py3-none-any.whl
  • Upload date:
  • Size: 89.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.13.3

File hashes

Hashes for pudb-2025.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f642d42e6054c992b43c463742650aa879fe290d7d7ffdeb21f7d00dc4587a21
MD5 900b483c5338cadfc6445a3d9fea67e3
BLAKE2b-256 b101069766294390d3e10c77dfb553171466d67ffb51bf72a437650c0a5db86a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page