Registry / testing / mozdebug

mozdebug

JSON →
library0.4.0pypypiunverified

Mozdebug provides utilities for running applications under native code debuggers, primarily intended for use within Mozilla testing workflows. It offers a Python client to interact with Mozilla's custom debug protocol. The current version is 0.4.0. Its release cadence appears infrequent, typically tied to specific Mozilla project requirements.

pip install mozdebug
INSTALL
IMPORT
SIG · MOZDEBUG
M
mozdebug
testingpythonv0.4.0
Install
1.9s avg
Import
Disk
16MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.4.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.103.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 18.3MB
glibc
py 3.103.910 runs
installs and imports cleanly · install 1.9s · import 0.000s · 19MB
16MB installed
● package 16MB
Code
Verified usage

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

MozDebugClient
from mozdebug.client import MozDebugClient
SymbolFetcher
from mozdebug.symbols import SymbolFetcher

This quickstart demonstrates how to instantiate and attempt to connect a `MozDebugClient` to a running debug server. It includes basic error handling for a `ConnectionRefusedError`, which is common if no server is active. Ensure a debug server compatible with Mozilla's protocol is running at the specified host and port for a successful connection.

import os from mozdebug.client import MozDebugClient # In a real scenario, you would launch a debug server (e.g., rr, gdbserver) # and configure it to listen on a host/port, then connect to it. # This example just demonstrates the client instantiation and connection attempt. # A ConnectionRefusedError is expected if no server is running at the specified address. try: # Attempt to connect to a debug server. # Replace 'localhost' and 9000 with your server's actual host and port. client = MozDebugClient(host=os.environ.get('DEBUG_SERVER_HOST', 'localhost'), port=int(os.environ.get('DEBUG_SERVER_PORT', 9000))) print(f"Attempting to connect to {client.host}:{client.port}...") client.connect() print("Successfully connected to debug server.") # In a real application, you would now interact with the debug client, e.g., # client.attach_to_process(pid), client.continue_execution(), client.get_stack(). # Example: Disconnect client.disconnect() print("Disconnected.") except ConnectionRefusedError: print("Could not connect to the debug server. Ensure a debug server (e.g., rr, gdbserver) is running and listening on the specified host/port.") except Exception as e: print(f"An unexpected error occurred: {e}")
Debug
Known issues
gotchaThe `mozdebug` library is a client-side tool; it does not launch or manage the debuggee process or the debugger itself. You must ensure a compatible debug server (e.g., `rr`, `gdbserver` with specific configurations) is already running and listening on the target host/port before the `MozDebugClient` can connect.
fix
Launch your debug server process manually before attempting to connect with `MozDebugClient`.
affects: All versions
gotchaMozdebug implements Mozilla's custom debugging protocol, which is distinct from standard GDB or LLDB remote protocols. It may not be compatible with generic debug servers without specific bridging or shim layers designed for this protocol.
fix
Verify that your debug server or target application is configured to expose the Mozilla debugging protocol, or use a tool specifically designed to interoperate with `mozdebug`.
affects: All versions
Upgrade
Version history
0.4.0latest on PyPI · released Jan 19, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
7 hits · last 30 days
node
4
Resources
mozdebug — pip install mozdebug · libregistry