debug-dojo 0.3.0__tar.gz → 0.3.2__tar.gz

{debug_dojo-0.3.0 → debug_dojo-0.3.2}/HISTORY.md

@@ -1,3 +1,18 @@
+## v0.3.0 (2025-07-28)
+
+*release tag*: [v0.3.2]
+
+### What's Changed
+
+- New logo for the project.
+- Typer used for CLI implementation.
+- Dojo is configured via `dojo.toml` or `pyproject.toml`.
+- Support for `debugpy` and `ipdb` for debugging.
+
+#### Fixes
+
+- Fixed documentation and history.
+
 ## v0.2.0 (2025-07-20)
 
 *release tag*: [v0.2.0]
@@ -21,5 +36,3 @@
 
 - Initial module to install debugging tools.
 - Debug mode utilities for PuDB, rich tracebacks, and object inspection.
-
-#### Fixes

{debug_dojo-0.3.0 → debug_dojo-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: debug-dojo
-Version: 0.3.0
+Version: 0.3.2
 Summary: Debbugging dojo for Python developers
 Project-URL: Homepage, https://github.com/bwrob/debug-dojo
 Project-URL: Documentation, https://github.com/bwrob/debug-dojo/blob/main/README.md
@@ -8,6 +8,7 @@ Project-URL: Source, https://github.com/bwrob/debug-dojo/tree/main/src/debug_doj
 Project-URL: Changelog, https://github.com/bwrob/debug-dojo/blob/main/HISTORY.md
 Author-email: bwrob <bartosz.marcin.wroblewski@gmail.com>
 License-Expression: MIT
+License-File: LICENSE
 Keywords: debugging,inspection,pudb,rich,tools,traceback
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
@@ -20,13 +21,17 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Debuggers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
+Requires-Dist: debugpy>=1.8.0
+Requires-Dist: ipdb>=0.13.0
 Requires-Dist: pudb>=2020.1
-Requires-Dist: rich>=11.0.0
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: rich>=12.0.0
+Requires-Dist: tomlkit>=0.13.3
 Requires-Dist: typer>=0.15.0
 Description-Content-Type: text/markdown
 
 <p align="center">
-  <img src="https://github.com/bwrob/debug-dojo/blob/main/logo/logo_white.png?raw=true" alt="debug dojo" style="width:50%; max-width:400px;"/>
+  <img src="https://github.com/bwrob/debug-dojo/blob/main/logo/logo_python.png?raw=true" alt="debug dojo" style="width:50%; max-width:300px;"/>
 </p>
 
 <p align="center">
@@ -36,15 +41,17 @@ Description-Content-Type: text/markdown
 [![PyPi Version](https://img.shields.io/pypi/v/debug-dojo.svg?style=flat-square)](https://pypi.org/project/debug-dojo)
 [![PyPI pyversions](https://img.shields.io/pypi/pyversions/debug-dojo.svg?style=flat-square)](https://pypi.org/pypi/debug-dojo/)
 
-**debug-dojo** is a Python package providing utilities for enhanced debugging and inspection in the terminal. It leverages [`rich`](https://github.com/Textualize/rich) for beautiful output and offers helpers for side-by-side object comparison, improved tracebacks from `rich`, and easy integration with PuDB. All tools can be installed at once or individually, allowing for flexible debugging setups.
+**debug-dojo** is a Python package providing utilities for enhanced debugging and inspection in the terminal. 
+It leverages [`rich`](https://github.com/Textualize/rich) for beautiful output and offers helpers for side-by-side object comparison, improved tracebacks from `rich`, and easy integration with different debuggers -- `debugpy`, `pudb`, `pdb`, and `ipdb`.
 
 ## Features
 
 - **Convenient CLI** Quickly run your code with debugging tools enabled.
 - **Simple API:** Install all tools or only what you need.
-- **PuDB integration:** Quickly enable the PuDB TUI debugger.
+- **Debugger integration:** Quickly enable Debugpy, PuDB, PDB, or IPDB as your default debugger.
 - **Rich tracebacks:** Get readable, colorized tracebacks for easier debugging.
 - **Side-by-side object inspection:** Visually compare Python objects, their attributes, and methods in the terminal.
+- **Configuration:** Easily configure the debugging tools using `dojo.toml` or `pyproject.toml`.
 
 ## Usage
 
@@ -56,12 +63,21 @@ Run your Python script with debugging tools enabled using the `debug-dojo` comma
 dojo my_script.py
 ```
 
-### Install all debugging tools
+You can optionally set configuration file and verbose mode:
+
+```console
+dojo --config dojo.toml --verbose my_script.py
+```
+
+### From the code
 
 In the `PuDB` style, you can install all debugging tools and enter the debugging mode with a single command:
 
 ```python
-import debug_dojo.all; b()
+import debug_dojo.install; b()
+
+object_1 = {"foo": 1, "bar": 2}
+object_2 = [1, 2, 3]
 
 p(object_1)  # Pretty print an object with Rich
 i(object_1)  # Inspect an object
@@ -75,27 +91,21 @@ Where:
 - `i(object_1)` to inspect an object using Rich.
 - `c(object_1, object_2)` to compare two objects side-by-side.
 
-### Use individual tools
+## Configuration
 
-```python
-from debug_dojo import install_inspect, use_pudb, use_rich_traceback
+You can configure the debugging tools using a `dojo.toml` or `pyproject.toml` file. The configuration allows you to specify which debugger to use, enable or disable features, and set other options.
 
-install_inspect()         # Enable object inspection helpers
-use_pudb()                # Set up PuDB as the debugger
-use_rich_traceback()      # Enable Rich tracebacks
-```
+**Example `dojo.toml`:**
 
-### Compare objects side-by-side
+```toml
+debugger = "ipdb"
 
-```python
-from debug_dojo.compareres import inspect_objects_side_by_side
-
-a = {"foo": 1, "bar": 2}
-b = [1, 2, 3]
-inspect_objects_side_by_side(a, b)
+[features]
+  rich_inspect = true
+  rich_print = true
+  comparer = false
 ```
 
-
 ## Installation
 
 The package is available on PyPI and can be installed using standard Python package management tools.
@@ -128,6 +138,21 @@ basedpyright src/debug_dojo
 
 ## Changelog
 
+## v0.3.0 (2025-07-28)
+
+*release tag*: [v0.3.2]
+
+### What's Changed
+
+- New logo for the project.
+- Typer used for CLI implementation.
+- Dojo is configured via `dojo.toml` or `pyproject.toml`.
+- Support for `debugpy` and `ipdb` for debugging.
+
+#### Fixes
+
+- Fixed documentation and history.
+
 ## v0.2.0 (2025-07-20)
 
 *release tag*: [v0.2.0]
@@ -151,5 +176,3 @@ basedpyright src/debug_dojo
 
 - Initial module to install debugging tools.
 - Debug mode utilities for PuDB, rich tracebacks, and object inspection.
-
-#### Fixes

{debug_dojo-0.3.0 → debug_dojo-0.3.2}/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://github.com/bwrob/debug-dojo/blob/main/logo/logo_white.png?raw=true" alt="debug dojo" style="width:50%; max-width:400px;"/>
+  <img src="https://github.com/bwrob/debug-dojo/blob/main/logo/logo_python.png?raw=true" alt="debug dojo" style="width:50%; max-width:300px;"/>
 </p>
 
 <p align="center">
@@ -9,15 +9,17 @@
 [![PyPi Version](https://img.shields.io/pypi/v/debug-dojo.svg?style=flat-square)](https://pypi.org/project/debug-dojo)
 [![PyPI pyversions](https://img.shields.io/pypi/pyversions/debug-dojo.svg?style=flat-square)](https://pypi.org/pypi/debug-dojo/)
 
-**debug-dojo** is a Python package providing utilities for enhanced debugging and inspection in the terminal. It leverages [`rich`](https://github.com/Textualize/rich) for beautiful output and offers helpers for side-by-side object comparison, improved tracebacks from `rich`, and easy integration with PuDB. All tools can be installed at once or individually, allowing for flexible debugging setups.
+**debug-dojo** is a Python package providing utilities for enhanced debugging and inspection in the terminal. 
+It leverages [`rich`](https://github.com/Textualize/rich) for beautiful output and offers helpers for side-by-side object comparison, improved tracebacks from `rich`, and easy integration with different debuggers -- `debugpy`, `pudb`, `pdb`, and `ipdb`.
 
 ## Features
 
 - **Convenient CLI** Quickly run your code with debugging tools enabled.
 - **Simple API:** Install all tools or only what you need.
-- **PuDB integration:** Quickly enable the PuDB TUI debugger.
+- **Debugger integration:** Quickly enable Debugpy, PuDB, PDB, or IPDB as your default debugger.
 - **Rich tracebacks:** Get readable, colorized tracebacks for easier debugging.
 - **Side-by-side object inspection:** Visually compare Python objects, their attributes, and methods in the terminal.
+- **Configuration:** Easily configure the debugging tools using `dojo.toml` or `pyproject.toml`.
 
 ## Usage
 
@@ -29,12 +31,21 @@ Run your Python script with debugging tools enabled using the `debug-dojo` comma
 dojo my_script.py
 ```
 
-### Install all debugging tools
+You can optionally set configuration file and verbose mode:
+
+```console
+dojo --config dojo.toml --verbose my_script.py
+```
+
+### From the code
 
 In the `PuDB` style, you can install all debugging tools and enter the debugging mode with a single command:
 
 ```python
-import debug_dojo.all; b()
+import debug_dojo.install; b()
+
+object_1 = {"foo": 1, "bar": 2}
+object_2 = [1, 2, 3]
 
 p(object_1)  # Pretty print an object with Rich
 i(object_1)  # Inspect an object
@@ -48,27 +59,21 @@ Where:
 - `i(object_1)` to inspect an object using Rich.
 - `c(object_1, object_2)` to compare two objects side-by-side.
 
-### Use individual tools
+## Configuration
 
-```python
-from debug_dojo import install_inspect, use_pudb, use_rich_traceback
+You can configure the debugging tools using a `dojo.toml` or `pyproject.toml` file. The configuration allows you to specify which debugger to use, enable or disable features, and set other options.
 
-install_inspect()         # Enable object inspection helpers
-use_pudb()                # Set up PuDB as the debugger
-use_rich_traceback()      # Enable Rich tracebacks
-```
+**Example `dojo.toml`:**
 
-### Compare objects side-by-side
+```toml
+debugger = "ipdb"
 
-```python
-from debug_dojo.compareres import inspect_objects_side_by_side
-
-a = {"foo": 1, "bar": 2}
-b = [1, 2, 3]
-inspect_objects_side_by_side(a, b)
+[features]
+  rich_inspect = true
+  rich_print = true
+  comparer = false
 ```
 
-
 ## Installation
 
 The package is available on PyPI and can be installed using standard Python package management tools.

{debug_dojo-0.3.0 → debug_dojo-0.3.2}/pyproject.toml

@@ -6,10 +6,14 @@
     ]
     requires-python = ">=3.10"
     dependencies = [
+        "debugpy>=1.8.0",
+        "ipdb>=0.13.0",
         "pudb>=2020.1",
-        "rich>=11.0.0",
+        "pydantic>=2.11.7",
+        "rich>=12.0.0",
+        "tomlkit>=0.13.3",
         "typer>=0.15.0",
-    ]
+]
     license = 'MIT'
     license-files = ['LICENSE']
     keywords = [
@@ -32,7 +36,7 @@
         "Topic :: Software Development :: Debuggers",
         "Topic :: Software Development :: Libraries :: Python Modules",
     ]
-    version = "0.3.0"
+version = "0.3.2"
     dynamic = ['readme']
 
     [project.urls]
@@ -47,7 +51,12 @@
         "dojo" = "debug_dojo._cli:main"
 
 [dependency-groups]
-    dev = ["basedpyright>=1.31.0", "ruff>=0.12.4"]
+    dev = [
+        "basedpyright>=1.31.0",
+        "jupyter>=1.1.1",
+        "poethepoet>=0.36.0",
+        "ruff>=0.12.4",
+]
 
 [build-system]
     requires = [
@@ -56,10 +65,6 @@
     ]
     build-backend = "hatchling.build"
 
-
-[tool.hatch.version]
-    path = "src/debug_dojo/version.py"
-
 [tool.hatch.metadata]
     allow-direct-references = true
 
@@ -72,8 +77,31 @@
             { path = 'HISTORY.md' },
         ]
 
+
+[tool.hatch.build.targets.sdist]
+    include = [
+        "/README.md",
+        "/HISTORY.md",
+        "/src/debug_dojo",
+    ]
+
 [tool.basedpyright]
     typeCheckingMode = "all"
     pythonVersion    = "3.10"
     strict           = ["src/debug_dojo/*"]
     ignore           = ["examples"]
+
+[tool.poe.tasks]
+    # Define your tasks here
+    lint = "ruff check --fix src"
+    format = "ruff format src"
+    type-check = "basedpyright"
+    code-quality = ["format", "lint", "type-check"]
+    publish = [
+        "format",
+        "lint",
+        "type-check",
+        {cmd="rm -rf dist"},
+        {cmd="uv build"},
+        {cmd="uv publish"},
+    ]

debug_dojo-0.3.2/src/debug_dojo/__init__.py

@@ -0,0 +1,23 @@
+"""Debugging tools for Python.
+
+This module provides functions to set up debugging tools like PuDB and Rich Traceback.
+It checks for the availability of these tools and configures them accordingly.
+
+Importing this module will install the debugging tools based on the configuration.
+Example usage:
+
+```python
+import debug_dojo.install
+
+b()
+```
+
+This will install the debugging tools and put debug breakpoint at this line.
+
+Another way to use this module is to run the desired script or module with the
+`dojo` command-line interface.
+
+```console
+$ dojo --verbose --config dojo.toml target_script.py --arg_1_for_script value1
+```
+"""

{debug_dojo-0.3.0 → debug_dojo-0.3.2}/src/debug_dojo/__main__.py

@@ -1,6 +1,6 @@
 """Entry point for the debug_dojo package."""
 
-from .cli import main
-
 if __name__ == "__main__":
+    from ._cli import main
+
     main()

debug_dojo-0.3.2/src/debug_dojo/_cli.py

@@ -0,0 +1,101 @@
+"""Command-line interface for running Python scripts or modules with debugging tools."""
+
+from __future__ import annotations
+
+import os
+import runpy
+import sys
+from bdb import BdbQuit
+from pathlib import Path
+from typing import Annotated
+
+import typer
+from pydantic import ValidationError
+from rich import print as rich_print
+
+from ._config import DebugDojoConfig, load_config
+from ._installers import install_by_config
+
+cli = typer.Typer(
+    name="debug_dojo",
+    help="Run a Python script or module with debugging tools installed.",
+    no_args_is_help=True,
+)
+
+
+def execute_with_debug(
+    target_name: str,
+    target_args: list[str],
+    *,
+    verbose: bool,
+) -> None:
+    """Execute a target script or module with installation of debugging tools."""
+    sys.argv = [target_name, *target_args]
+
+    if verbose:
+        rich_print(f"[blue]Installing debugging tools for {target_name}.[/blue]")
+        rich_print(f"[blue]Arguments for target: {target_args}[/blue]")
+
+    config = load_config()
+    install_by_config(config)
+
+    if (
+        Path(target_name).exists()
+        or target_name.endswith(".py")
+        or os.sep in target_name
+    ):
+        if not Path(target_name).exists():
+            sys.exit(1)
+        runner = runpy.run_path
+    else:
+        runner = runpy.run_module
+
+    _ = runner(target_name, run_name="__main__")
+
+
+def display_config(config: DebugDojoConfig) -> None:
+    """Display the configuration for the debug dojo."""
+    rich_print("[blue]Using debug-dojo configuration:[/blue]")
+    rich_print(config.model_dump_json(indent=4))
+
+
+@cli.command(
+    help="Run a Python script or module with debugging tools installed.",
+    no_args_is_help=True,
+    context_settings={"allow_extra_args": True, "ignore_unknown_options": True},
+)
+def run_debug(
+    ctx: typer.Context,
+    target_name: Annotated[
+        str | None, typer.Argument(help="The target script or module to debug.")
+    ] = None,
+    config_path: Annotated[
+        Path | None, typer.Option("--config", "-c", help="Show configuration")
+    ] = None,
+    *,
+    verbose: Annotated[
+        bool,
+        typer.Option("--verbose", "-v", is_flag=True, help="Enable verbose output"),
+    ] = False,
+) -> None:
+    """Run the command-line interface."""
+    try:
+        config = load_config(config_path, verbose=verbose)
+    except ValidationError as e:
+        rich_print(f"[red]Configuration error:\n{e}[/red]")
+        sys.exit(1)
+
+    if verbose:
+        display_config(config)
+
+    if target_name:
+        try:
+            execute_with_debug(target_name, ctx.args, verbose=verbose)
+        except BdbQuit:
+            rich_print("[red]Debugging session terminated by user.[/red]")
+            sys.exit(0)
+
+
+def main() -> None:
+    """Run the command-line interface."""
+    cli()

debug_dojo-0.3.0/src/debug_dojo/compareres.py → debug_dojo-0.3.2/src/debug_dojo/_compareres.py

@@ -4,6 +4,8 @@ This module provides functions to display attributes and methods of two objects
 in a visually appealing, side-by-side format in the terminal.
 """
 
+from __future__ import annotations
+
 import contextlib
 
 from rich.columns import Columns
@@ -48,7 +50,7 @@ def _get_object_methods(obj: object) -> list[str]:
     for method_name in sorted(dir(obj)):
         # Safely get attribute, returning None if it doesn't exist
         attr = getattr(obj, method_name, None)
-        # Exclude private/protected methods (starting with '_') and non-callable attributes
+        # Exclude private/protected methods (starting with '_') and non-callables.
         if not method_name.startswith("_") and callable(attr):
             methods.append(method_name)
     return methods

debug_dojo-0.3.2/src/debug_dojo/_config.py

@@ -0,0 +1,117 @@
+from __future__ import annotations
+
+from enum import Enum
+from pathlib import Path
+from typing import Any, cast
+
+import tomlkit
+from pydantic import BaseModel, ConfigDict
+from rich import print as rich_print
+
+
+class DebuggerType(Enum):
+    """Enum for different types of debuggers."""
+
+    PDB = "pdb"
+    PUDB = "pudb"
+    IPDB = "ipdb"
+    DEBUGPY = "debugpy"
+
+
+class Features(BaseModel):
+    """Configuration for installing debug features."""
+
+    model_config = ConfigDict(extra="forbid")  # pyright: ignore[reportUnannotatedClassAttribute]
+
+    rich_inspect: bool = True
+    """Install rich inspect as 'i' for enhanced object inspection."""
+    rich_print: bool = True
+    """Install rich print as 'p' for enhanced printing."""
+    rich_traceback: bool = True
+    """Install rich traceback for better error reporting."""
+    comparer: bool = True
+    """Install comparer as 'c' for side-by-side object comparison."""
+    breakpoint: bool = True
+    """Install breakpoint as 'b' for setting breakpoints in code."""
+
+
+class DebugDojoConfig(BaseModel):
+    """Configuration for Debug Dojo."""
+
+    model_config = ConfigDict(extra="forbid")  # pyright: ignore[reportUnannotatedClassAttribute]
+
+    debugger: DebuggerType = DebuggerType.PUDB
+    """The type of debugger to use."""
+    features: Features = Features()
+    """Features to install for debugging."""
+
+
+def resolve_config_path(config_path: Path | None) -> Path | None:
+    """Resolve the configuration path, returning a default if none is provided."""
+    if config_path:
+        if not config_path.exists():
+            msg = f"Configuration file not found:\n{config_path.resolve()}"
+            raise FileNotFoundError(msg)
+        return config_path
+
+    # Default configuration path
+    for path in (Path("dojo.toml"), Path("pyproject.toml")):
+        if path.exists():
+            return path
+    return None
+
+
+def load_raw_config(
+    config_path: Path,
+) -> dict[str, Any]:  # pyright: ignore[reportExplicitAny]
+    """Load the Debug Dojo configuration from a file.
+
+    Currently supports 'dojo.toml' or 'pyproject.toml'.
+    If no path is provided, it checks the current directory for these files.
+    """
+    with config_path.open("rb") as f:
+        config_data = tomlkit.load(f).unwrap()
+
+    # If config is in [tool.debug_dojo] (pyproject.toml), extract it.
+    if config_path.name == "dojo.toml":
+        return config_data
+
+    if config_path.name == "pyproject.toml":
+        try:
+            dojo_config = cast(
+                "dict[str, Any]",  # pyright: ignore[reportExplicitAny]
+                config_data["tool"]["debug_dojo"],
+            )
+        except KeyError:
+            return {}
+        else:
+            return dojo_config
+
+    # If the file is not recognized, raise an error.
+    msg = (
+        f"Unsupported configuration file: \n{config_path.resolve()}\n"
+        "Expected 'dojo.toml' or 'pyproject.toml'."
+    )
+    raise ValueError(msg)
+
+
+def load_config(
+    config_path: Path | None = None,
+    *,
+    verbose: bool = False,
+) -> DebugDojoConfig:
+    """Load the Debug Dojo configuration and return a DebugDojoConfig instance."""
+    resolved_path = resolve_config_path(config_path)
+
+    if verbose:
+        if resolved_path:
+            msg = f"Using configuration file: {resolved_path.resolve()}."
+        else:
+            msg = "No configuration file found, using default settings."
+        rich_print(f"[blue]{msg}[/blue]")
+
+    if not resolved_path:
+        return DebugDojoConfig()
+
+    raw_config = load_raw_config(resolved_path)
+    return DebugDojoConfig.model_validate(raw_config)

debug_dojo-0.3.2/src/debug_dojo/_installers.py

@@ -0,0 +1,138 @@
+"""Debugging tools for Python.
+
+This module provides functions to set up debugging tools like PuDB and Rich Traceback.
+It checks for the availability of these tools and configures them accordingly.
+"""
+
+from __future__ import annotations
+
+import builtins
+import json
+import os
+import sys
+
+from rich import print as rich_print
+
+from ._compareres import inspect_objects_side_by_side
+from ._config import DebugDojoConfig, DebuggerType, Features
+
+BREAKPOINT_ENV_VAR = "PYTHONBREAKPOINT"
+
+
+def _use_pdb() -> None:
+    """Set PDB as the default debugger."""
+    import pdb
+
+    os.environ[BREAKPOINT_ENV_VAR] = "pdb.set_trace"
+    sys.breakpointhook = pdb.set_trace
+
+
+def _use_pudb() -> None:
+    """Check if PuDB is available and set it as the default debugger."""
+    import pudb  # pyright: ignore[reportMissingTypeStubs]
+
+    os.environ[BREAKPOINT_ENV_VAR] = "pudb.set_trace"
+    sys.breakpointhook = pudb.set_trace
+
+
+def _use_ipdb() -> None:
+    """Set IPDB as the default debugger."""
+    import ipdb  # pyright: ignore[reportMissingTypeStubs]
+
+    os.environ[BREAKPOINT_ENV_VAR] = "ipdb.set_trace"
+    os.environ["IPDB_CONTEXT_SIZE"] = "20"
+    sys.breakpointhook = ipdb.set_trace  # pyright: ignore[reportUnknownMemberType]
+
+
+def _use_debugpy() -> None:
+    """Check if IPDB is available and set it as the default debugger."""
+    import debugpy  # pyright: ignore[reportMissingTypeStubs]
+
+    os.environ[BREAKPOINT_ENV_VAR] = "debugpy.breakpoint"
+    sys.breakpointhook = debugpy.breakpoint
+
+    port = 6969
+    _ = debugpy.listen(("localhost", port))
+
+    config = {
+        "name": "debug-dojo",
+        "type": "debugpy",
+        "request": "attach",
+        "connect": {"port": port},
+    }
+    rich_print(
+        f"[blue]Debugging via Debugpy. Connect your VSC debugger to port {port}.[/blue]"
+    )
+    rich_print("[blue]Configuration:[/blue]")
+    rich_print(json.dumps(config, indent=4))
+
+    debugpy.wait_for_client()
+
+
+def _rich_traceback() -> None:
+    """Check if Rich Traceback is available and set it as the default."""
+    from rich import traceback
+
+    _ = traceback.install(show_locals=True)
+
+
+def _inspect() -> None:
+    """Print the object using a custom inspect function."""
+    from rich import inspect
+
+    def inspect_with_defaults(obj: object, **kwargs: object) -> None:
+        """Inspect an object using Rich's inspect function."""
+        if not kwargs:
+            kwargs = {"methods": True, "private": True}
+        return inspect(obj, **kwargs)  # pyright: ignore[reportArgumentType]
+
+    builtins.i = inspect_with_defaults  # pyright: ignore[reportAttributeAccessIssue]
+
+
+def _compare() -> None:
+    """Print the object using a custom inspect function."""
+    builtins.c = inspect_objects_side_by_side  # pyright: ignore[reportAttributeAccessIssue]
+
+
+def _breakpoint() -> None:
+    """Install the breakpoint function."""
+    builtins.b = breakpoint  # pyright: ignore[reportAttributeAccessIssue]
+
+
+def _rich_print() -> None:
+    """Install the print from rich."""
+    from rich import print as rich_print
+
+    builtins.p = rich_print  # pyright: ignore[reportAttributeAccessIssue]
+
+
+def _install_features(features: Features) -> None:
+    """Install the specified debugging features."""
+    if features.rich_inspect:
+        _inspect()
+    if features.rich_print:
+        _rich_print()
+    if features.rich_traceback:
+        _rich_traceback()
+    if features.comparer:
+        _compare()
+    if features.breakpoint:
+        _breakpoint()
+
+
+def _set_debugger(debugger: DebuggerType) -> None:  # noqa: RET503
+    """Set the debugger based on the configuration."""
+    if debugger == DebuggerType.PDB:
+        return _use_pdb()
+    if debugger == DebuggerType.PUDB:
+        return _use_pudb()
+    if debugger == DebuggerType.IPDB:
+        return _use_ipdb()
+    if debugger == DebuggerType.DEBUGPY:
+        return _use_debugpy()
+
+
+def install_by_config(config: DebugDojoConfig) -> None:
+    """Install debugging tools."""
+    _set_debugger(config.debugger)
+    _install_features(config.features)

debug_dojo-0.3.2/src/debug_dojo/install.py

@@ -0,0 +1,7 @@
+"""Install debugging tools based on the project configuration."""
+
+from ._config import load_config
+from ._installers import install_by_config
+
+config = load_config()
+install_by_config(config)

debug_dojo-0.3.0/.python-version

@@ -1 +0,0 @@
-3.13

debug_dojo-0.3.0/examples/test_target.py

@@ -1,24 +0,0 @@
-"""Example script demonstrating cl argument printing and dictionary inspection."""
-
-import sys
-
-from rich import print as rich_print
-
-
-def main() -> None:
-    """Run the command-line interface."""
-    if len(sys.argv) > 1:
-        rich_print(sys.argv[1::])
-
-    example_dict = {
-        "key1": "value1",
-        "key2": "value2",
-        "key3": "value3",
-    }
-    b()
-
-    i(example_dict)
-
-
-if __name__ == "__main__":
-    main()

debug_dojo-0.3.0/ruff.toml

@@ -1,20 +0,0 @@
-line-length    = 88
-target-version = "py310"
-
-
-[lint]
-    select = ["ALL"]
-    ignore = [
-        "COM",
-        "D203",
-        "D211",
-        "D213",
-        "FA",
-        "ISC",
-        "T",
-        "TC",
-    ]
-    exclude = ["examples"]
-
-[format]
-    docstring-code-format = true

debug_dojo-0.3.0/src/debug_dojo/__init__.py

@@ -1,21 +0,0 @@
-"""Debugging tools for Python.
-
-This module provides functions to set up debugging tools like PuDB and Rich Traceback.
-It checks for the availability of these tools and configures them accordingly.
-"""
-
-from .installers import install_all, install_inspect, use_pudb, use_rich_traceback
-
-ii = install_inspect
-pudb = use_pudb
-rt = use_rich_traceback
-
-__all__ = [
-    "ii",
-    "install_all",
-    "install_inspect",
-    "pudb",
-    "rt",
-    "use_pudb",
-    "use_rich_traceback",
-]

debug_dojo-0.3.0/src/debug_dojo/_cli.py

@@ -1,76 +0,0 @@
-"""Command-line interface for running Python scripts or modules with debugging tools."""
-
-import os
-import runpy
-import sys
-from bdb import BdbQuit
-from pathlib import Path
-from typing import Annotated
-
-import typer
-from rich import print as rich_print
-
-from .installers import install_all
-
-cli = typer.Typer(
-    name="debug_dojo",
-    help="Run a Python script or module with debugging tools installed.",
-    no_args_is_help=True,
-)
-
-
-def execute_with_debug(target_name: str, args_for_target: list[str]) -> None:
-    """Execute a target script or module with installation of debugging tools."""
-    sys.argv = [target_name, *args_for_target]
-
-    install_all()
-
-    if (
-        Path(target_name).exists()
-        or target_name.endswith(".py")
-        or os.sep in target_name
-    ):
-        if not Path(target_name).exists():
-            sys.exit(1)
-        runner = runpy.run_path
-    else:
-        runner = runpy.run_module
-
-    _ = runner(target_name, run_name="__main__")
-
-
-@cli.command(
-    name="",
-    context_settings={
-        "allow_extra_args": True,
-        "ignore_unknown_options": True,
-    },
-)
-def main(
-    ctx: typer.Context,
-    target_name: Annotated[
-        str,
-        typer.Argument(
-            ...,
-            help="The target script or module to debug. Provide the path or module name.",
-        ),
-    ],
-) -> None:
-    """Run the command-line interface."""
-    args_for_target = ctx.args
-    try:
-        execute_with_debug(target_name, args_for_target)
-    except BdbQuit:
-        rich_print("[red]Debugging session terminated by user.[/red]")
-        sys.exit(0)
-
-
-@cli.command("config")
-def config() -> None:
-    """Display the configuration for the debug dojo."""
-    rich_print("[green]Debug Dojo Configuration:[/green]")
-    rich_print("This tool installs debugging tools and runs Python scripts or modules.")
-    rich_print(
-        "You can specify a target script or module to debug, along with any arguments."
-    )
-    rich_print("Example usage: `debug_dojo target_to_debug.py --some-input-to-target`")

debug_dojo-0.3.0/src/debug_dojo/all.py

@@ -1,5 +0,0 @@
-"""Install all debugging tools for the debug_dojo package by import."""
-
-from .installers import install_all
-
-install_all()

debug_dojo-0.3.0/src/debug_dojo/installers.py

@@ -1,81 +0,0 @@
-"""Debugging tools for Python.
-
-This module provides functions to set up debugging tools like PuDB and Rich Traceback.
-It checks for the availability of these tools and configures them accordingly.
-"""
-
-import builtins
-import os
-import sys
-
-import pudb  # pyright: ignore[reportMissingTypeStubs]
-from rich import (
-    inspect,
-    traceback,
-)
-from rich import (
-    print as rich_print,
-)
-
-from .compareres import inspect_objects_side_by_side
-
-BREAKPOINT_ENV_VAR = "PYTHONBREAKPOINT"
-PUDB_SET_TRACE = "pudb.set_trace"
-
-
-def use_pudb() -> None:
-    """Check if PuDB is available and set it as the default debugger."""
-    # Set the environment variable. This will primarily affect child processes or later
-    # Python startup if the script is re-run.
-    os.environ[BREAKPOINT_ENV_VAR] = PUDB_SET_TRACE
-
-    # Crucially, to make `breakpoint()` work *immediately* in the current process,
-    # we need to explicitly set `sys.breakpointhook`.
-    sys.breakpointhook = pudb.set_trace
-
-
-def use_rich_traceback() -> None:
-    """Check if Rich Traceback is available and set it as the default."""
-    # Install rich traceback to enhance the debugging experience
-    _ = traceback.install(show_locals=True)
-
-
-def install_inspect() -> None:
-    """Print the object using a custom inspect function."""
-
-    def inspect_with_defaults(obj: object, **kwargs: object) -> None:
-        """Inspect an object using Rich's inspect function."""
-        if not kwargs:
-            kwargs = {"methods": True, "private": True}
-        return inspect(obj, **kwargs)  # pyright: ignore[reportArgumentType]
-
-    # Inject the custom inspect function into builtins
-    builtins.i = inspect_with_defaults  # pyright: ignore[reportAttributeAccessIssue]
-
-
-def install_compare() -> None:
-    """Print the object using a custom inspect function."""
-    # Inject the custom side-by-side comparison function into builtins
-    builtins.c = inspect_objects_side_by_side  # pyright: ignore[reportAttributeAccessIssue]
-
-
-def install_breakpoint() -> None:
-    """Install the breakpoint function."""
-    # Set the breakpoint function to use PuDB's set_trace
-    builtins.b = pudb.set_trace  # pyright: ignore[reportAttributeAccessIssue]
-
-
-def install_rich_print() -> None:
-    """Install the print from rich."""
-    builtins.p = rich_print  # pyright: ignore[reportAttributeAccessIssue]
-
-
-def install_all() -> None:
-    """Install debugging tools."""
-    use_pudb()
-    use_rich_traceback()
-
-    install_inspect()
-    install_compare()
-    install_breakpoint()
-    install_rich_print()

debug_dojo-0.3.0/uv.lock

@@ -1,247 +0,0 @@
-version = 1
-revision = 2
-requires-python = ">=3.10"
-
-[[package]]
-name = "basedpyright"
-version = "1.31.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "nodejs-wheel-binaries" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/20/23/6dc0df43c62fdec401b1ec3aea698ba50c5abfca25259e9f0208b34d7abe/basedpyright-1.31.0.tar.gz", hash = "sha256:900a573a525a0f66f884075c2a98711bb9478e44dc60ffdf182ef681bf8e2c76", size = 22062384, upload-time = "2025-07-16T11:37:29.189Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/5a/85/cb46707458c514ae959fe139135d8f7231d95faf1c383a56979a3436b965/basedpyright-1.31.0-py3-none-any.whl", hash = "sha256:d7460ddcd3a2332b1c3fd738735d18bf2966d49aed67237efa1f19635199d414", size = 11538999, upload-time = "2025-07-16T11:37:26.446Z" },
-]
-
-[[package]]
-name = "click"
-version = "8.2.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "colorama", marker = "sys_platform == 'win32'" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/60/6c/8ca2efa64cf75a977a0d7fac081354553ebe483345c734fb6b6515d96bbc/click-8.2.1.tar.gz", hash = "sha256:27c491cc05d968d271d5a1db13e3b5a184636d9d930f148c50b038f0d0646202", size = 286342, upload-time = "2025-05-20T23:19:49.832Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/85/32/10bb5764d90a8eee674e9dc6f4db6a0ab47c8c4d0d83c27f7c39ac415a4d/click-8.2.1-py3-none-any.whl", hash = "sha256:61a3265b914e850b85317d0b3109c7f8cd35a670f963866005d6ef1d5175a12b", size = 102215, upload-time = "2025-05-20T23:19:47.796Z" },
-]
-
-[[package]]
-name = "colorama"
-version = "0.4.6"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
-]
-
-[[package]]
-name = "commonmark"
-version = "0.9.1"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/60/48/a60f593447e8f0894ebb7f6e6c1f25dafc5e89c5879fdc9360ae93ff83f0/commonmark-0.9.1.tar.gz", hash = "sha256:452f9dc859be7f06631ddcb328b6919c67984aca654e5fefb3914d54691aed60", size = 95764, upload-time = "2019-10-04T15:37:39.817Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/b1/92/dfd892312d822f36c55366118b95d914e5f16de11044a27cf10a7d71bbbf/commonmark-0.9.1-py2.py3-none-any.whl", hash = "sha256:da2f38c92590f83de410ba1a3cbceafbc74fee9def35f9251ba9a971d6d66fd9", size = 51068, upload-time = "2019-10-04T15:37:37.674Z" },
-]
-
-[[package]]
-name = "debug-dojo"
-version = "0.3.0"
-source = { editable = "." }
-dependencies = [
-    { name = "pudb" },
-    { name = "rich" },
-    { name = "typer" },
-]
-
-[package.dev-dependencies]
-dev = [
-    { name = "basedpyright" },
-    { name = "ruff" },
-]
-
-[package.metadata]
-requires-dist = [
-    { name = "pudb", specifier = ">=2020.1" },
-    { name = "rich", specifier = ">=11.0.0" },
-    { name = "typer", specifier = ">=0.15.0" },
-]
-
-[package.metadata.requires-dev]
-dev = [
-    { name = "basedpyright", specifier = ">=1.31.0" },
-    { name = "ruff", specifier = ">=0.12.4" },
-]
-
-[[package]]
-name = "jedi"
-version = "0.19.2"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "parso" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/72/3a/79a912fbd4d8dd6fbb02bf69afd3bb72cf0c729bb3063c6f4498603db17a/jedi-0.19.2.tar.gz", hash = "sha256:4770dc3de41bde3966b02eb84fbcf557fb33cce26ad23da12c742fb50ecb11f0", size = 1231287, upload-time = "2024-11-11T01:41:42.873Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/c0/5a/9cac0c82afec3d09ccd97c8b6502d48f165f9124db81b4bcb90b4af974ee/jedi-0.19.2-py2.py3-none-any.whl", hash = "sha256:a8ef22bde8490f57fe5c7681a3c83cb58874daf72b4784de3cce5b6ef6edb5b9", size = 1572278, upload-time = "2024-11-11T01:41:40.175Z" },
-]
-
-[[package]]
-name = "nodejs-wheel-binaries"
-version = "22.17.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/d3/86/8962d1d24ff480f4dd31871f42c8e0d8e2c851cd558a07ee689261d310ab/nodejs_wheel_binaries-22.17.0.tar.gz", hash = "sha256:529142012fb8fd20817ef70e2ef456274df4f49933292e312c8bbc7285af6408", size = 8068, upload-time = "2025-06-29T20:24:25.002Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/5d/53/b942c6da4ff6f87a315033f6ff6fed8fd3c22047d7ff5802badaa5dfc2c2/nodejs_wheel_binaries-22.17.0-py2.py3-none-macosx_11_0_arm64.whl", hash = "sha256:6545a6f6d2f736d9c9e2eaad7e599b6b5b2d8fd4cbd2a1df0807cbcf51b9d39b", size = 51003554, upload-time = "2025-06-29T20:23:47.042Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/b7/7184a9ad2364912da22f2fe021dc4a3301721131ef7759aeb4a1f19db0b4/nodejs_wheel_binaries-22.17.0-py2.py3-none-macosx_11_0_x86_64.whl", hash = "sha256:4bea5b994dd87c20f8260031ea69a97c3d282e2d4472cc8908636a313a830d00", size = 51936848, upload-time = "2025-06-29T20:23:52.064Z" },
-    { url = "https://files.pythonhosted.org/packages/e9/7a/0ea425147b8110b8fd65a6c21cfd3bd130cdec7766604361429ef870d799/nodejs_wheel_binaries-22.17.0-py2.py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:885508615274a22499dd5314759c1cf96ba72de03e6485d73b3e5475e7f12662", size = 57925230, upload-time = "2025-06-29T20:23:56.81Z" },
-    { url = "https://files.pythonhosted.org/packages/23/5f/10a3f2ac08a839d065d9ccfd6d9df66bc46e100eaf87a8a5cf149eb3fb8e/nodejs_wheel_binaries-22.17.0-py2.py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90f38ce034a602bcab534d55cbe0390521e73e5dcffdd1c4b34354b932172af2", size = 58457829, upload-time = "2025-06-29T20:24:01.945Z" },
-    { url = "https://files.pythonhosted.org/packages/ed/a4/d2ca331e16eef0974eb53702df603c54f77b2a7e2007523ecdbf6cf61162/nodejs_wheel_binaries-22.17.0-py2.py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:5eed087855b644c87001fe04036213193963ccd65e7f89949e9dbe28e7743d9b", size = 59778054, upload-time = "2025-06-29T20:24:07.14Z" },
-    { url = "https://files.pythonhosted.org/packages/be/2b/04e0e7f7305fe2ba30fd4610bfb432516e0f65379fe6c2902f4b7b1ad436/nodejs_wheel_binaries-22.17.0-py2.py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:715f413c81500f0770ea8936ef1fc2529b900da8054cbf6da67cec3ee308dc76", size = 60830079, upload-time = "2025-06-29T20:24:12.21Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/67/12070b24b88040c2d694883f3dcb067052f748798f4c63f7c865769a5747/nodejs_wheel_binaries-22.17.0-py2.py3-none-win_amd64.whl", hash = "sha256:51165630493c8dd4acfe1cae1684b76940c9b03f7f355597d55e2d056a572ddd", size = 40117877, upload-time = "2025-06-29T20:24:17.51Z" },
-    { url = "https://files.pythonhosted.org/packages/2e/ec/53ac46af423527c23e40c7343189f2bce08a8337efedef4d8a33392cee23/nodejs_wheel_binaries-22.17.0-py2.py3-none-win_arm64.whl", hash = "sha256:fae56d172227671fccb04461d3cd2b26a945c6c7c7fc29edb8618876a39d8b4a", size = 38865278, upload-time = "2025-06-29T20:24:21.065Z" },
-]
-
-[[package]]
-name = "packaging"
-version = "25.0"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" },
-]
-
-[[package]]
-name = "parso"
-version = "0.8.4"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/66/94/68e2e17afaa9169cf6412ab0f28623903be73d1b32e208d9e8e541bb086d/parso-0.8.4.tar.gz", hash = "sha256:eb3a7b58240fb99099a345571deecc0f9540ea5f4dd2fe14c2a99d6b281ab92d", size = 400609, upload-time = "2024-04-05T09:43:55.897Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/c6/ac/dac4a63f978e4dcb3c6d3a78c4d8e0192a113d288502a1216950c41b1027/parso-0.8.4-py2.py3-none-any.whl", hash = "sha256:a418670a20291dacd2dddc80c377c5c3791378ee1e8d12bffc35420643d43f18", size = 103650, upload-time = "2024-04-05T09:43:53.299Z" },
-]
-
-[[package]]
-name = "pudb"
-version = "2025.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "jedi" },
-    { name = "packaging" },
-    { name = "pygments" },
-    { name = "urwid" },
-    { name = "urwid-readline" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/93/40/8d17b16a1c2a36d8cc1befb5eda13310ad20fcb347e58bef5e104696e14a/pudb-2025.1.tar.gz", hash = "sha256:a528b29c69ce8b182a337872c5f046071f6d68d3415c6d7bf53bd27c264f58d0", size = 220623, upload-time = "2025-05-06T20:43:18.306Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/b1/01/069766294390d3e10c77dfb553171466d67ffb51bf72a437650c0a5db86a/pudb-2025.1-py3-none-any.whl", hash = "sha256:f642d42e6054c992b43c463742650aa879fe290d7d7ffdeb21f7d00dc4587a21", size = 89208, upload-time = "2025-05-06T20:43:17.101Z" },
-]
-
-[[package]]
-name = "pygments"
-version = "2.19.2"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
-]
-
-[[package]]
-name = "rich"
-version = "11.0.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "colorama" },
-    { name = "commonmark" },
-    { name = "pygments" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/eb/be/bd5d6c37f5de55f31cb9432e0d926ceeab1b2ee774bd696557b53bc15012/rich-11.0.0.tar.gz", hash = "sha256:c32a8340b21c75931f157466fefe81ae10b92c36a5ea34524dff3767238774a4", size = 199133, upload-time = "2022-01-09T10:34:56.219Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/a0/46/05afc812a59890e92dc7bea6bda777e3c06f57be71a8bde2c2568bf682dc/rich-11.0.0-py3-none-any.whl", hash = "sha256:d7a8086aa1fa7e817e3bba544eee4fd82047ef59036313147759c11475f0dafd", size = 215821, upload-time = "2022-01-09T10:34:53.82Z" },
-]
-
-[[package]]
-name = "ruff"
-version = "0.12.4"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/9b/ce/8d7dbedede481245b489b769d27e2934730791a9a82765cb94566c6e6abd/ruff-0.12.4.tar.gz", hash = "sha256:13efa16df6c6eeb7d0f091abae50f58e9522f3843edb40d56ad52a5a4a4b6873", size = 5131435, upload-time = "2025-07-17T17:27:19.138Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/ae/9f/517bc5f61bad205b7f36684ffa5415c013862dee02f55f38a217bdbe7aa4/ruff-0.12.4-py3-none-linux_armv6l.whl", hash = "sha256:cb0d261dac457ab939aeb247e804125a5d521b21adf27e721895b0d3f83a0d0a", size = 10188824, upload-time = "2025-07-17T17:26:31.412Z" },
-    { url = "https://files.pythonhosted.org/packages/28/83/691baae5a11fbbde91df01c565c650fd17b0eabed259e8b7563de17c6529/ruff-0.12.4-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:55c0f4ca9769408d9b9bac530c30d3e66490bd2beb2d3dae3e4128a1f05c7442", size = 10884521, upload-time = "2025-07-17T17:26:35.084Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/8d/756d780ff4076e6dd035d058fa220345f8c458391f7edfb1c10731eedc75/ruff-0.12.4-py3-none-macosx_11_0_arm64.whl", hash = "sha256:a8224cc3722c9ad9044da7f89c4c1ec452aef2cfe3904365025dd2f51daeae0e", size = 10277653, upload-time = "2025-07-17T17:26:37.897Z" },
-    { url = "https://files.pythonhosted.org/packages/8d/97/8eeee0f48ece153206dce730fc9e0e0ca54fd7f261bb3d99c0a4343a1892/ruff-0.12.4-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e9949d01d64fa3672449a51ddb5d7548b33e130240ad418884ee6efa7a229586", size = 10485993, upload-time = "2025-07-17T17:26:40.68Z" },
-    { url = "https://files.pythonhosted.org/packages/49/b8/22a43d23a1f68df9b88f952616c8508ea6ce4ed4f15353b8168c48b2d7e7/ruff-0.12.4-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:be0593c69df9ad1465e8a2d10e3defd111fdb62dcd5be23ae2c06da77e8fcffb", size = 10022824, upload-time = "2025-07-17T17:26:43.564Z" },
-    { url = "https://files.pythonhosted.org/packages/cd/70/37c234c220366993e8cffcbd6cadbf332bfc848cbd6f45b02bade17e0149/ruff-0.12.4-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:a7dea966bcb55d4ecc4cc3270bccb6f87a337326c9dcd3c07d5b97000dbff41c", size = 11524414, upload-time = "2025-07-17T17:26:46.219Z" },
-    { url = "https://files.pythonhosted.org/packages/14/77/c30f9964f481b5e0e29dd6a1fae1f769ac3fd468eb76fdd5661936edd262/ruff-0.12.4-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:afcfa3ab5ab5dd0e1c39bf286d829e042a15e966b3726eea79528e2e24d8371a", size = 12419216, upload-time = "2025-07-17T17:26:48.883Z" },
-    { url = "https://files.pythonhosted.org/packages/6e/79/af7fe0a4202dce4ef62c5e33fecbed07f0178f5b4dd9c0d2fcff5ab4a47c/ruff-0.12.4-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c057ce464b1413c926cdb203a0f858cd52f3e73dcb3270a3318d1630f6395bb3", size = 11976756, upload-time = "2025-07-17T17:26:51.754Z" },
-    { url = "https://files.pythonhosted.org/packages/09/d1/33fb1fc00e20a939c305dbe2f80df7c28ba9193f7a85470b982815a2dc6a/ruff-0.12.4-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e64b90d1122dc2713330350626b10d60818930819623abbb56535c6466cce045", size = 11020019, upload-time = "2025-07-17T17:26:54.265Z" },
-    { url = "https://files.pythonhosted.org/packages/64/f4/e3cd7f7bda646526f09693e2e02bd83d85fff8a8222c52cf9681c0d30843/ruff-0.12.4-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2abc48f3d9667fdc74022380b5c745873499ff827393a636f7a59da1515e7c57", size = 11277890, upload-time = "2025-07-17T17:26:56.914Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/d0/69a85fb8b94501ff1a4f95b7591505e8983f38823da6941eb5b6badb1e3a/ruff-0.12.4-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:2b2449dc0c138d877d629bea151bee8c0ae3b8e9c43f5fcaafcd0c0d0726b184", size = 10348539, upload-time = "2025-07-17T17:26:59.381Z" },
-    { url = "https://files.pythonhosted.org/packages/16/a0/91372d1cb1678f7d42d4893b88c252b01ff1dffcad09ae0c51aa2542275f/ruff-0.12.4-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:56e45bb11f625db55f9b70477062e6a1a04d53628eda7784dce6e0f55fd549eb", size = 10009579, upload-time = "2025-07-17T17:27:02.462Z" },
-    { url = "https://files.pythonhosted.org/packages/23/1b/c4a833e3114d2cc0f677e58f1df6c3b20f62328dbfa710b87a1636a5e8eb/ruff-0.12.4-py3-none-musllinux_1_2_i686.whl", hash = "sha256:478fccdb82ca148a98a9ff43658944f7ab5ec41c3c49d77cd99d44da019371a1", size = 10942982, upload-time = "2025-07-17T17:27:05.343Z" },
-    { url = "https://files.pythonhosted.org/packages/ff/ce/ce85e445cf0a5dd8842f2f0c6f0018eedb164a92bdf3eda51984ffd4d989/ruff-0.12.4-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:0fc426bec2e4e5f4c4f182b9d2ce6a75c85ba9bcdbe5c6f2a74fcb8df437df4b", size = 11343331, upload-time = "2025-07-17T17:27:08.652Z" },
-    { url = "https://files.pythonhosted.org/packages/35/cf/441b7fc58368455233cfb5b77206c849b6dfb48b23de532adcc2e50ccc06/ruff-0.12.4-py3-none-win32.whl", hash = "sha256:4de27977827893cdfb1211d42d84bc180fceb7b72471104671c59be37041cf93", size = 10267904, upload-time = "2025-07-17T17:27:11.814Z" },
-    { url = "https://files.pythonhosted.org/packages/ce/7e/20af4a0df5e1299e7368d5ea4350412226afb03d95507faae94c80f00afd/ruff-0.12.4-py3-none-win_amd64.whl", hash = "sha256:fe0b9e9eb23736b453143d72d2ceca5db323963330d5b7859d60d101147d461a", size = 11209038, upload-time = "2025-07-17T17:27:14.417Z" },
-    { url = "https://files.pythonhosted.org/packages/11/02/8857d0dfb8f44ef299a5dfd898f673edefb71e3b533b3b9d2db4c832dd13/ruff-0.12.4-py3-none-win_arm64.whl", hash = "sha256:0618ec4442a83ab545e5b71202a5c0ed7791e8471435b94e655b570a5031a98e", size = 10469336, upload-time = "2025-07-17T17:27:16.913Z" },
-]
-
-[[package]]
-name = "shellingham"
-version = "1.5.4"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/58/15/8b3609fd3830ef7b27b655beb4b4e9c62313a4e8da8c676e142cc210d58e/shellingham-1.5.4.tar.gz", hash = "sha256:8dbca0739d487e5bd35ab3ca4b36e11c4078f3a234bfce294b0a0291363404de", size = 10310, upload-time = "2023-10-24T04:13:40.426Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/e0/f9/0595336914c5619e5f28a1fb793285925a8cd4b432c9da0a987836c7f822/shellingham-1.5.4-py2.py3-none-any.whl", hash = "sha256:7ecfff8f2fd72616f7481040475a65b2bf8af90a56c89140852d1120324e8686", size = 9755, upload-time = "2023-10-24T04:13:38.866Z" },
-]
-
-[[package]]
-name = "typer"
-version = "0.16.0"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "click" },
-    { name = "rich" },
-    { name = "shellingham" },
-    { name = "typing-extensions" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/c5/8c/7d682431efca5fd290017663ea4588bf6f2c6aad085c7f108c5dbc316e70/typer-0.16.0.tar.gz", hash = "sha256:af377ffaee1dbe37ae9440cb4e8f11686ea5ce4e9bae01b84ae7c63b87f1dd3b", size = 102625, upload-time = "2025-05-26T14:30:31.824Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/76/42/3efaf858001d2c2913de7f354563e3a3a2f0decae3efe98427125a8f441e/typer-0.16.0-py3-none-any.whl", hash = "sha256:1f79bed11d4d02d4310e3c1b7ba594183bcedb0ac73b27a9e5f28f6fb5b98855", size = 46317, upload-time = "2025-05-26T14:30:30.523Z" },
-]
-
-[[package]]
-name = "typing-extensions"
-version = "4.14.1"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/98/5a/da40306b885cc8c09109dc2e1abd358d5684b1425678151cdaed4731c822/typing_extensions-4.14.1.tar.gz", hash = "sha256:38b39f4aeeab64884ce9f74c94263ef78f3c22467c8724005483154c26648d36", size = 107673, upload-time = "2025-07-04T13:28:34.16Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/b5/00/d631e67a838026495268c2f6884f3711a15a9a2a96cd244fdaea53b823fb/typing_extensions-4.14.1-py3-none-any.whl", hash = "sha256:d1e1e3b58374dc93031d6eda2420a48ea44a36c2b4766a4fdeb3710755731d76", size = 43906, upload-time = "2025-07-04T13:28:32.743Z" },
-]
-
-[[package]]
-name = "urwid"
-version = "3.0.2"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "wcwidth" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/46/2d/71550379ed6b34968e14f73b0cf8574dee160acb6b820a066ab238ef2d4f/urwid-3.0.2.tar.gz", hash = "sha256:e7cb70ba1e7ff45779a5a57e43c57581ee7de6ceefb56c432491a4a6ce81eb78", size = 855353, upload-time = "2025-05-07T10:48:51.381Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/b5/ee/2956918f14fd6e4310f7200108b53917f4da713d74c7ccd0d91a2e3a4f18/urwid-3.0.2-py3-none-any.whl", hash = "sha256:94ec1448d0178c881c01845c2b478cdc89f7b71bb65349466dbc99da1965eaac", size = 295994, upload-time = "2025-05-07T10:48:49.173Z" },
-]
-
-[[package]]
-name = "urwid-readline"
-version = "0.15.1"
-source = { registry = "https://pypi.org/simple" }
-dependencies = [
-    { name = "urwid" },
-]
-sdist = { url = "https://files.pythonhosted.org/packages/ad/70/be318554495555eba7d8ff6e489f6f74ddb225b24086ba4af62a82e723fd/urwid_readline-0.15.1.tar.gz", hash = "sha256:9301444b86d58f7d26388506b704f142cefd193888488b4070d3a0fdfcfc0f84", size = 9007, upload-time = "2024-09-22T17:51:55.144Z" }
-
-[[package]]
-name = "wcwidth"
-version = "0.2.13"
-source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/6c/63/53559446a878410fc5a5974feb13d31d78d752eb18aeba59c7fef1af7598/wcwidth-0.2.13.tar.gz", hash = "sha256:72ea0c06399eb286d978fdedb6923a9eb47e1c486ce63e9b4e64fc18303972b5", size = 101301, upload-time = "2024-01-06T02:10:57.829Z" }
-wheels = [
-    { url = "https://files.pythonhosted.org/packages/fd/84/fd2ba7aafacbad3c4201d395674fc6348826569da3c0937e75505ead3528/wcwidth-0.2.13-py2.py3-none-any.whl", hash = "sha256:3da69048e4540d84af32131829ff948f1e022c1c6bdb8d6102117aac784f6859", size = 34166, upload-time = "2024-01-06T02:10:55.763Z" },
-]