rpdb

library0.2.0pypypi✓ verified 88d ago

A remote debugger wrapper around pdb that exposes the debugger on a TCP socket (default port 4444), allowing you to connect with telnet or netcat. Current version: 0.2.0. Infrequently maintained; last release 2021.

testing devops

pip install rpdb

package ↗homepage ↗

INSTALL

IMPORT

SIG · RPDB

rpdb

testingpythonv0.2.0

Install

1.6s avg

Import

113ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.2.0 · 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

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.128s · 17.8MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.098s · 18MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

rpdb

✓ import rpdb

rpdb is a module, not a class; it replaces pdb.set_trace() with rpdb.set_trace().

Place rpdb.set_trace() in your code where you want to break. When the breakpoint is hit, rpdb listens on TCP port 4444. Connect using netcat or telnet to interact with the debugger.

import rpdb rpdb.set_trace() # Your code here, then connect via: nc localhost 4444

Debug

Known issues

gotcharpdb opens a TCP socket on port 4444. If the breakpoint is hit in a subprocess or forked process without proper setup, you may get multiple listeners or port conflicts.

fix

Ensure only one process hits the breakpoint, or set RPDB_PORT environment variable to different ports per process.

affects: all

breakingrpdb 0.2.0 dropped support for Python <3.8. If you are on an older Python, you must use an earlier version (e.g., 0.1.5).

fix

Upgrade to Python 3.8+ or pin rpdb to <0.2.0.

affects: >=0.2.0

gotcharpdb does not work with pdb++ or other pdb replacements. It directly wraps the standard library pdb.

fix

Use rpdb only with the standard pdb, or consider alternatives like remote-pdb.

affects: all

Errors

Common errors & fixes

ImportError: No module named 'rpdb'

rpdb is not installed, or the environment does not have it.

fix

Run 'pip install rpdb'.

Connection refused when connecting to localhost:4444

The process with rpdb.set_trace() is not running, or the breakpoint hasn't been hit yet, or a firewall is blocking the port.

fix

Ensure the script is running and hits the breakpoint. Check that no firewall blocks port 4444. Verify the port with 'ss -tlnp | grep 4444' or 'netstat -an | grep 4444'.

Upgrade

Version history

0.2.0latest on PyPI · released Dec 26, 2024

Audit

Dependencies

No dependency data recorded yet.

Agent activity

9 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/rpdb/ ↗

homepagehttp://tamentis.com/projects/rpdb ↗