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.3.tar.gz (225.6 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.3-py3-none-any.whl (92.6 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pudb-2025.1.3.tar.gz
Algorithm Hash digest
SHA256 69fd72d4ef266f84b31d8f4ab32c432335aadf87ea28b6249ac7dece0d0541f4
MD5 eaa3731b3cb0f61eb8790601834bb0a7
BLAKE2b-256 343024de984dcfb743305d86680bbcbaf2d62cccf262c1a49bf4ab4033203e0f

See more details on using hashes here.

Provenance

The following attestation bundles were made for pudb-2025.1.3.tar.gz:

Publisher: release.yml on inducer/pudb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

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

File metadata

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

File hashes

Hashes for pudb-2025.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 15991e10d14f410afc91c9c676703cc47fe9c890edfe51dddb3d1fc36ea7eab9
MD5 f34cad50ca5410c71db80758cc8b6731
BLAKE2b-256 4edc7e196a92d65f45b23c839508ee140865db8366b9a946e5907280237213e2

See more details on using hashes here.

Provenance

The following attestation bundles were made for pudb-2025.1.3-py3-none-any.whl:

Publisher: release.yml on inducer/pudb

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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