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

Uploaded Source

Built Distribution

pudb-2024.1.3-py3-none-any.whl (88.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pudb-2024.1.3.tar.gz
  • Upload date:
  • Size: 219.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for pudb-2024.1.3.tar.gz
Algorithm Hash digest
SHA256 264f239e0538e52e83d3d020143100b3171cae17227674bb1b9f8b075f34849c
MD5 dc73886506e57c8ba2116e5cbe112fb8
BLAKE2b-256 3627fb087bdf2cd9c8e56d0347b863ce5995967c15a3e2a0b9245c7a8f6f1598

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pudb-2024.1.3-py3-none-any.whl
  • Upload date:
  • Size: 88.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for pudb-2024.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b1c64447fcee5848d0376231672b97ca8580ca6d3297c82cba6b0ba5bd5ee640
MD5 fa317e87d868aefe6cebbb92f66d8831
BLAKE2b-256 e400592eeb47eb30d9a4e34512eb1208537546c1073d43cabe7def26d89a7134

See more details on using hashes here.

Supported by

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