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.1.tar.gz (224.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pudb-2025.1.1-py3-none-any.whl (92.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pudb-2025.1.1.tar.gz
  • Upload date:
  • Size: 224.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pudb-2025.1.1.tar.gz
Algorithm Hash digest
SHA256 b7c245c7531c792643612620aa812b95ec80a22fd0e67bde4d84734692dc4b72
MD5 3def10c9ff8d1b58bce4c43f049933d0
BLAKE2b-256 22ff07063d2537502deef92692a314ac0eeacd9926c74bcf462ef75af23a510b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pudb-2025.1.1-py3-none-any.whl
  • Upload date:
  • Size: 92.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pudb-2025.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b37134b3fb6d5f725d701536f2c3938c298575b3702a732211010eb459e4014e
MD5 9e7471e9256edc9c1e144d871d91a0b1
BLAKE2b-256 849d1c9f26106e043dc12e3a7e0a9cadbc005a3669378d0503a1a23b6a1bacc5

See more details on using hashes here.

Supported by

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