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

Uploaded Source

Built Distribution

pudb-2024.1.1-py3-none-any.whl (87.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pudb-2024.1.1.tar.gz
  • Upload date:
  • Size: 226.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.4

File hashes

Hashes for pudb-2024.1.1.tar.gz
Algorithm Hash digest
SHA256 ff5f5395e36a19a65f22f522fd6027d27a36ab783de4511b41c91484ab614975
MD5 371810fea68b58c58c22958656e3faa0
BLAKE2b-256 f38cea65a7c38240e0885979f6d12590e31a83739b903564fbbefae382961ef6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pudb-2024.1.1-py3-none-any.whl
  • Upload date:
  • Size: 87.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.4

File hashes

Hashes for pudb-2024.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b184af80036ea379a4f79ba7859ecf4fe0681a2b6f46e807f49d1900668f7c66
MD5 2315279ae14bc9393030f8f619fa38f0
BLAKE2b-256 e5f493a24b5e07f0a12bcd2a8a99cbb7a2a59e36515c4cf9e3a56591cb6a6f7d

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