PuDB is a full-screen, console-based visual debugger for Python.
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. If you've worked with the
excellent (but nowadays ancient) DOS-based Turbo Pascal or C tools, PuDB's UI
might look familiar.
Here's a screenshot:
.. image:: http://tiker.net/pub/pudb-screenshot.png
You may watch a `screencast <http://vimeo.com/5255125>`_, 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.
* 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 coomands.
* 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 "!".
* PuDB places special emphasis on exception handling. A post-mortem mode makes
it easy to retrace a crashing program's last steps.
* IPython integration (see `wiki <http://wiki.tiker.net/PuDB>`_)
Installing
----------
Install PuDB using the command::
easy_install pudb
Getting Started
---------------
To start debugging, simply insert::
from pudb import set_trace; set_trace()
into the piece of code you want to debug, or run the entire script with::
python -m pudb.run my-script.py
Documentation and Support
-------------------------
PuDB has a `wiki <http://wiki.tiker.net/PuDB>`_, where documentation and
debugging wisdom are collected.
PuDB also has a `mailing list <http://lists.tiker.net/listinfo/pudb>`_ that
you may use to submit patches and requests for help.
Programming PuDB
----------------
At the programming language level, PuDB displays the same interface
as Python's built-in `pdb module <http://docs.python.org/library/pdb.html>`_.
Just replace `pdb` with `pudb`.
(One exception: `run` is called `runstatement`.)
License and Dependencies
------------------------
PuDB is distributed under the MIT license. It relies on the following
excellent pieces of software:
* Ian Ward's `urwid <http://excess.org/urwid>`_ console UI library
* Georg Brandl's `pygments <http://pygments.org>`_ syntax highlighter
Development Version
-------------------
You may obtain the development version using the `Git <http://git-scm.org/>`_
version control tool.::
git clone http://git.tiker.net/trees/pudb.git
You may also `browse the code <http://git.tiker.net/pudb.git>`_ online.
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. If you've worked with the
excellent (but nowadays ancient) DOS-based Turbo Pascal or C tools, PuDB's UI
might look familiar.
Here's a screenshot:
.. image:: http://tiker.net/pub/pudb-screenshot.png
You may watch a `screencast <http://vimeo.com/5255125>`_, 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.
* 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 coomands.
* 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 "!".
* PuDB places special emphasis on exception handling. A post-mortem mode makes
it easy to retrace a crashing program's last steps.
* IPython integration (see `wiki <http://wiki.tiker.net/PuDB>`_)
Installing
----------
Install PuDB using the command::
easy_install pudb
Getting Started
---------------
To start debugging, simply insert::
from pudb import set_trace; set_trace()
into the piece of code you want to debug, or run the entire script with::
python -m pudb.run my-script.py
Documentation and Support
-------------------------
PuDB has a `wiki <http://wiki.tiker.net/PuDB>`_, where documentation and
debugging wisdom are collected.
PuDB also has a `mailing list <http://lists.tiker.net/listinfo/pudb>`_ that
you may use to submit patches and requests for help.
Programming PuDB
----------------
At the programming language level, PuDB displays the same interface
as Python's built-in `pdb module <http://docs.python.org/library/pdb.html>`_.
Just replace `pdb` with `pudb`.
(One exception: `run` is called `runstatement`.)
License and Dependencies
------------------------
PuDB is distributed under the MIT license. It relies on the following
excellent pieces of software:
* Ian Ward's `urwid <http://excess.org/urwid>`_ console UI library
* Georg Brandl's `pygments <http://pygments.org>`_ syntax highlighter
Development Version
-------------------
You may obtain the development version using the `Git <http://git-scm.org/>`_
version control tool.::
git clone http://git.tiker.net/trees/pudb.git
You may also `browse the code <http://git.tiker.net/pudb.git>`_ online.
1 maintainer
Metadata
1 maintainer
Release files for pudb 2011.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| pudb-2011.1.tar.gz | 31.8 kB | Without provenance | Details |
Release files / pudb-2011.1.tar.gz
| Download URL | pudb-2011.1.tar.gz |
|---|---|
| Size | 31.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d45fd6cd908fa59989a1447d6cbddc68eacee78c5786911e86a09111661bc8a7
|
|
BLAKE2b-256 checksum How to use checksums |
04468a6c6abf42efea9bb31128359edd9cb14eb8590225d0d4ce4c3028e5a56c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for pudb 2011.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
