Install & Compatibility
Where this runs
tested against v1.8.2 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.162s · 26.6MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 2.2s · import 0.138s · 27MB
25MB installed
● package 25MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
set_trace
✓ from pdbp import set_trace
✗ import pdbp; pdbp.set_trace()
This quickstart demonstrates how to invoke the pdbp debugger within your Python code. When `pdbp.set_trace()` is called, execution will pause, and you'll enter the interactive debugger prompt. You can then use standard pdb commands (like `n` for next line, `s` for step, `c` for continue, `p <variable>` to print a variable) to inspect the program's state.
import pdbp
def my_function(x, y):
print(f"Before addition: x={x}, y={y}")
pdbp.set_trace() # The debugger will pause execution here
result = x + y
print(f"After addition: result={result}")
return result
if __name__ == '__main__':
print("Starting program...")
my_function(5, 3)
print("Program finished.")
pdbp --version
Debug
Known issues
breakingSupport for Python 3.7 was dropped in `pdbp` v1.6.0. Users on Python 3.7 or older will need to use an earlier version of `pdbp` or upgrade their Python interpreter.fixUpgrade to Python 3.8+ or pin `pdbp` version to `<1.6.0`.
affects: <1.6.0
gotchaOlder versions of `pdbp` (prior to v1.5.4) had compatibility issues when used with `PyInstaller` due to non-zip-safe loading of the standard library `pdb`. This could lead to errors when bundling applications.fixUpgrade to `pdbp` v1.5.4 or newer to ensure `PyInstaller` compatibility.
affects: <1.5.4
gotcha`pdbp` v1.7.1 included updates to support changes made in `pytest` v8.4.0+ for Python 3.13+. If you are using these newer versions of `pytest` and Python, older `pdbp` versions might exhibit compatibility problems with the debugger integration.fixUpgrade `pdbp` to v1.7.1 or newer to ensure proper integration with recent `pytest` and Python versions.
affects: <1.7.1 (with pytest >=8.4.0 and Python >=3.13)
gotcha`pdbp` v1.8.2 repaired an issue with stack-trace frame indexing. Prior versions might have displayed incorrect or confusing frame indices, potentially leading to misinterpretations of the call stack during debugging.fixUpgrade to `pdbp` v1.8.2 or newer for accurate stack-trace frame indexing.
affects: <1.8.2
Upgrade
Version history
1.8.2latest on PyPI · released Jan 14, 2026
Audit
Dependencies
No dependency data recorded yet.