pudb 2025.1.5


pip install pudb

  Latest version

Released: Dec 06, 2025

Project Links

Meta
Author: Andreas Kloeckner
Requires Python: ~=3.8

Classifiers

Development Status
  • 4 - Beta

Environment
  • Console
  • Console :: Curses

Intended Audience
  • Developers

Natural Language
  • English

Operating System
  • POSIX
  • Unix

Programming Language
  • Python
  • Python :: 3

Topic
  • Software Development
  • Software Development :: Debuggers
  • Software Development :: Quality Assurance
  • System :: Recovery Tools
  • System :: Software Distribution
  • Terminals
  • Utilities
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.

2025.1.5 Dec 06, 2025
2025.1.4 Dec 05, 2025
2025.1.3 Oct 21, 2025
2025.1.2 Oct 16, 2025
2025.1.1 Sep 23, 2025
2025.1 May 06, 2025
2024.1.3 Oct 18, 2024
2024.1.2 Jul 22, 2024
2024.1.1 Jul 11, 2024
2024.1 Jan 16, 2024
2023.1 Oct 06, 2023
2022.1.3 Nov 03, 2022
2022.1.2 Jul 19, 2022
2022.1.1 Mar 12, 2022
2022.1 Jan 07, 2022
2021.2.2 Nov 01, 2021
2021.2.1 Nov 01, 2021
2021.2 Oct 29, 2021
2021.1 May 08, 2021
2020.1 Dec 21, 2020
2019.2 Nov 21, 2019
2019.1 Apr 25, 2019
2018.1 May 24, 2018
2017.1.4 Sep 02, 2017
2017.1.3 Aug 13, 2017
2017.1.2 Apr 05, 2017
2017.1.1 Feb 18, 2017
2017.1 Feb 03, 2017
2016.2 Jun 07, 2016
2016.1 Feb 26, 2016
2015.4.1 Oct 20, 2015
2015.4 Oct 20, 2015
2015.3 May 25, 2015
2015.2 Feb 13, 2015
2015.1 Jan 26, 2015
2014.1 Mar 13, 2014
2013.5.1 Nov 28, 2013
2013.5 Nov 14, 2013
2013.4 Nov 06, 2013
2013.3.6 Sep 06, 2013
2013.3.5 Aug 17, 2013
2013.3.4 Jul 09, 2013
2013.3.3 Jul 08, 2013
2013.3.2 Jun 11, 2013
2013.3.1 Jun 10, 2013
2013.3 Jun 10, 2013
2013.2 May 28, 2013
2013.1 Mar 14, 2013
2012.3 Aug 06, 2012
2012.2.1 Jun 06, 2012
2012.2 May 27, 2012
2012.1 Feb 01, 2012
2011.3.1 Dec 05, 2011
2011.3 Aug 29, 2011
2011.2 Jun 16, 2011
2011.1 Mar 18, 2011
0.93.1 Feb 14, 2011
0.93 Feb 14, 2011
0.92.15 Jan 17, 2010
0.92.14 Dec 21, 2009
0.92.13 Oct 29, 2009
0.92.12 Sep 11, 2009
0.92.11 Jul 26, 2009
0.92.10 Jul 25, 2009
0.92.9 Jul 13, 2009
0.92.8 Jul 12, 2009
0.92.7 Jul 10, 2009
0.92.6 Jul 10, 2009
0.92.5 Jul 09, 2009
0.92.4 Jul 09, 2009
0.92.3 Jun 30, 2009
0.92.2 Jun 24, 2009
0.92.1 Jun 21, 2009
0.92 Jun 21, 2009
0.91.5 Jun 14, 2009
0.91.4 Jun 14, 2009
0.91.3 Jun 14, 2009
0.91.2 Jun 12, 2009
0.91.1 Jun 12, 2009
0.91 Jun 10, 2009
0.90.6 Jun 09, 2009
0.90.5 Jun 09, 2009
0.90.4 Jun 09, 2009
0.90.3 Jun 09, 2009
0.90.2 Jun 09, 2009
0.90.1 Jun 09, 2009
0.90 Jun 09, 2009

Wheel compatibility matrix

Platform Python 3
any

Files in release

Extras:
Dependencies:
jedi (<1,>=0.18)
packaging (>=20.0)
pygments (>=2.19)
typing-extensions (>=4.13)
urwid-readline
urwid (>=2.4)
urwid (>=2.5.1)