debug-dojo 0.6.0

🏣 debug dojo, a place for zen debugging

debug dojo

🏣 debug dojo, a place for zen debugging

debug-dojo is a powerful Python package designed to streamline your debugging workflow directly from the terminal. It integrates seamlessly with popular debuggers and enhances your inspection capabilities with beautiful, readable output.

✨ Features

• Unified Debugging Interface: Easily launch your scripts or modules with your preferred debugger (debugpy, pudb, pdb, ipdb).
• Enhanced Output with Rich: Leverages rich for stunning, syntax-highlighted code, pretty-printed objects, and improved tracebacks.
• Side-by-Side Object Comparison: Quickly identify differences between two Python objects.
• Interactive Object Inspection: Dive deep into object structures with a powerful inspect utility.
• Simplified Breakpoints: Set breakpoints effortlessly with a concise helper function.

🚀 Installation

Install debug-dojo using pip:

pip install debug-dojo

For full debugger support, you might want to install optional dependencies:

pip install "debug-dojo[all]"

💻 CLI Usage

Run your Python script or module with debug-dojo:

dojo my_script.py

Specify a debugger, configuration file, or enable verbose output:

dojo --debugger ipdb --config dojo.toml --verbose --module my_module

Run an executable command with debugging tools:

dojo --exec pytest

🐍 Usage in Code

Integrate debug-dojo directly into your Python code for on-demand debugging and inspection utilities:

import debug_dojo.install

# Set a breakpoint and enter the debugger
# debug_dojo.install.b() # Equivalent to breakpoint()

object_1 = {"foo": 1, "bar": 2}
object_2 = [1, 2, 3]

# Pretty print an object with Rich
debug_dojo.install.p(object_1)

# Inspect an object using Rich
debug_dojo.install.i(object_1)

# Compare two objects side-by-side
debug_dojo.install.c(object_1, object_2)

# Enter the debugger (e.g., ipdb, pudb, pdb, debugpy based on config)
# debug_dojo.install.b()

📚 Documentation

For comprehensive instructions on installation, configuration, advanced usage, and API reference, please visit the official documentation.

🤝 Contributing

Contributions are welcome! Please refer to the development guidelines for details on how to set up your development environment and submit changes.