cipdb - Conditional iPDB

Simple conditional debugging for Python with ID-based breakpoint control.

Installation

pip install cipdb

Quick Start

Control by Global State Call in Python

# Disable all debugging programmatically
cipdb.disable()

Disable all debugging by Environmental Variable

CIPDB_ID=false python your_script.py

Control by Boolean

import cipdb

cipdb.set_trace()       # Identical with ipdb.set_trace()
cipdb.set_trace(False)  # Identical with pass
cipdb.set_trace(os.getenv("DEBUG")) # Development vs Production
cipdb.set_trace(os.getenv("AGENT_ID")=="DebuggingAgent_01") # Runner Specific for debugging by multiple agent

Control by Breakpoint IDs

# your_script.py
def process_user(user):
    cipdb.set_trace(id="validate")
    validate(user)
    
    cipdb.set_trace(id="save")
    save_user(user)
    
    cipdb.set_trace(id="notify")
    send_notification(user)

# Development mode: All ID breakpoints work (no env vars needed)
python your_script.py                            # All ID breakpoints trigger

# Production mode: Control with environment variables
CIPDB_IDS=validate,save python your_script.py   # Only stops at validate and save
CIPDB_IDS=save python your_script.py            # Only stops at save
CIPDB_ID=save python your_script.py             # Only stops at save (Equivalent to CIPDB_IDS=save)

Priority Logic

Global Control > CIPDB=false Environmental Variable > ID Matching > Boolean Conditioning

License

MIT