Web interface for Python's built-in PDB debugger
Project description
Web-PDB is a web-interface for Python’s built-in PDB debugger. It allows to debug Python scripts remotely in a web-browser.
Features
Responsive design based on Bootstrap.
Python syntax highlighting with Prism (“Okaida” theme).
Supports all PDB features.
Standard input and output can be redirected to the web-console to interact with Python scripts remotely.
Current file box tracks current position in a file being executed. Red line numbers indicate breakpoints, if any.
Globals and Locals boxes show local and global variables in the current scope. Special variables that start and end with double underscores __ are excluded (you can always view them using PDB commands).
Human-readable Unicode literals for Python 2.
Command history that stores up to 10 last unique PDB commands (accessed by arrow UP/DOWN keys).
Usage
Install Web-PDB into your working Python environment:
pip install web-pdb
Insert the following line into your Python program at the point where you want to start debugging:
import web_pdb; web_pdb.set_trace()
The set_trace() call will suspend your program and open a web-UI at the default port 5555 (port value can be changed). Enter in your browser’s address bar: http://<your Python machine hostname or IP>:5555, for example http://monty-python:5555, and you should see the web-UI like the one on the preceding screenshot. Now you can use all PDB commands and features. Additional Current file, Globals and Locals information boxes help you better track your program runtime state.
Note: it is strongly recommended to work with the Web-PDB web-UI only in one browser session. With more than one browser window accessing the web-UI it can display incorrect data in one or more browser sessions.
Subsequent set_trace() calls can be used as hardcoded breakpoints.
Additionally, Web-PDB provides catch_post_mortem context manager that can catch unhandled exceptions raised within its scope and automatically start PDB post-mortem debugging session. For example:
import web_pdb
with web_pdb.catch_post_mortem():
# Some error-prone code
assert foo == bar, 'Oops!'
For more detailed info about the Web-PDB API read docstrings in the ./web_pdb/__init__.py file.
Compatibility
Python: 2.7, 3+
Browsers: Firefox, Chrome (all modern browsers should work)
License
MIT, see LICENSE.txt.
The debugger icon made by Freepik from www.flaticon.com is licensed by CC 3.0 BY.
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
Built Distribution
Hashes for web_pdb-1.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6cfe7b3f94bf21ba73e0f7b26ce6a7a464aec6cc7614f2341976016b0e480c2b |
|
MD5 | 35d7f52a786dba688a9802578bb9a7a8 |
|
BLAKE2b-256 | 6b3fbec239fbf279a1fa87f9d594e2ea6c4eb3c5ca4648d071fa7917e1743e19 |