debug-dojo 0.4.0__tar.gz → 0.5.0__tar.gz

{debug_dojo-0.4.0 → debug_dojo-0.5.0}/LICENSE

@@ -1,4 +1,4 @@
-The MIT License (MIT)
+# The MIT License (MIT)
 
 Copyright (c) 2025 to bwrob.
 
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

debug_dojo-0.5.0/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: debug-dojo
+Version: 0.5.0
+Summary: 🏣 debug dojo, a place for zen debugging
+Author-email: bwrob <bartosz.marcin.wroblewski@gmail.com>
+License-Expression: MIT
+Project-URL: Changelog, https://bwrob.github.io/debug-dojo/changelog/
+Project-URL: Documentation, https://bwrob.github.io/debug-dojo/
+Project-URL: Homepage, https://bwrob.github.io/debug-dojo/
+Project-URL: Source, https://github.com/bwrob/debug-dojo/
+Keywords: debugging,inspection,tools,development
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: debugpy>=1.8.0
+Requires-Dist: ipdb>=0.13.0
+Requires-Dist: pudb>=2020.1
+Requires-Dist: pydantic>=2.11.7
+Requires-Dist: rich>=12.0.0
+Requires-Dist: tomlkit>=0.13.3
+Requires-Dist: typer>=0.15.0
+Dynamic: license-file
+
+# debug dojo
+
+<p align="center">
+  <img src="https://github.com/bwrob/debug-dojo/blob/main/docs/logo/logo_python.png?raw=true" alt="debug dojo" style="width:50%; max-width:350px;"/>
+</p>
+
+<p align="center">
+<em>🏣 debug dojo, a place for zen debugging</em>
+</p>
+
+[![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/)
+[![downloads](https://static.pepy.tech/badge/debug-dojo/month)](https://pepy.tech/project/debug-dojo)
+[![license](https://img.shields.io/github/license/bwrob/debug-dojo.svg)](https://github.com/bwrob/debug-dojo/blob/main/LICENSE)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/bwrob/debug-dojo/main.svg)](https://results.pre-commit.ci/latest/github/bwrob/debug-dojo/main)
+
+[**debug-dojo**](https://bwrob.github.io/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`.
+
+## CLI usage
+
+Run your Python script with debugging tools enabled using the `debug-dojo` command:
+
+```console
+dojo my_script.py
+```
+
+You can optionally set configuration, verbose mode, and specify the debugger type. Both script files and modules are supported:
+
+```console
+dojo --debugger ipdb --config dojo.toml --verbose --module my_module
+```
+
+## From the code
+
+In the `PuDB` style, you can install all debugging tools and enter the debugging mode with a single command:
+
+```python
+object_1 = {"foo": 1, "bar": 2}
+object_2 = [1, 2, 3]
+
+import debug_dojo.install; b()
+
+p(object_1)             # Pretty print an object with Rich.
+i(object_1)             # Inspect an object using Rich.
+c(object_1, object_2)   # Compare two objects side-by-side.
+
+```
+
+## Documentation
+
+For instructions regarding installation, configuration and usage please visit [documentation](https://bwrob.github.io/debug-dojo/).

debug_dojo-0.5.0/README.md

@@ -0,0 +1,52 @@
+# debug dojo
+
+<p align="center">
+  <img src="https://github.com/bwrob/debug-dojo/blob/main/docs/logo/logo_python.png?raw=true" alt="debug dojo" style="width:50%; max-width:350px;"/>
+</p>
+
+<p align="center">
+<em>🏣 debug dojo, a place for zen debugging</em>
+</p>
+
+[![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/)
+[![downloads](https://static.pepy.tech/badge/debug-dojo/month)](https://pepy.tech/project/debug-dojo)
+[![license](https://img.shields.io/github/license/bwrob/debug-dojo.svg)](https://github.com/bwrob/debug-dojo/blob/main/LICENSE)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/bwrob/debug-dojo/main.svg)](https://results.pre-commit.ci/latest/github/bwrob/debug-dojo/main)
+
+[**debug-dojo**](https://bwrob.github.io/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`.
+
+## CLI usage
+
+Run your Python script with debugging tools enabled using the `debug-dojo` command:
+
+```console
+dojo my_script.py
+```
+
+You can optionally set configuration, verbose mode, and specify the debugger type. Both script files and modules are supported:
+
+```console
+dojo --debugger ipdb --config dojo.toml --verbose --module my_module
+```
+
+## From the code
+
+In the `PuDB` style, you can install all debugging tools and enter the debugging mode with a single command:
+
+```python
+object_1 = {"foo": 1, "bar": 2}
+object_2 = [1, 2, 3]
+
+import debug_dojo.install; b()
+
+p(object_1)             # Pretty print an object with Rich.
+i(object_1)             # Inspect an object using Rich.
+c(object_1, object_2)   # Compare two objects side-by-side.
+
+```
+
+## Documentation
+
+For instructions regarding installation, configuration and usage please visit [documentation](https://bwrob.github.io/debug-dojo/).

debug_dojo-0.5.0/pyproject.toml

@@ -0,0 +1,126 @@
+[project]
+    authors = [ { name = "bwrob", email = "bartosz.marcin.wroblewski@gmail.com" } ]
+    classifiers = [
+        "Intended Audience :: Developers",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Topic :: Software Development :: Debuggers",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ]
+    dependencies = [
+        "debugpy>=1.8.0",
+        "ipdb>=0.13.0",
+        "pudb>=2020.1",
+        "pydantic>=2.11.7",
+        "rich>=12.0.0",
+        "tomlkit>=0.13.3",
+        "typer>=0.15.0",
+    ]
+    description = "🏣 debug dojo, a place for zen debugging"
+    keywords = [ "debugging", "inspection", "tools", "development" ]
+    license = 'MIT'
+    license-files = [ 'LICENSE' ]
+    name = "debug-dojo"
+    readme = "README.md"
+    requires-python = ">=3.10,<3.14"
+version = "0.5.0"
+
+    [project.urls]
+        Changelog     = "https://bwrob.github.io/debug-dojo/changelog/"
+        Documentation = "https://bwrob.github.io/debug-dojo/"
+        Homepage      = "https://bwrob.github.io/debug-dojo/"
+        Source        = "https://github.com/bwrob/debug-dojo/"
+
+    [project.scripts]
+        "dojo" = "debug_dojo._cli:main"
+
+
+[dependency-groups]
+
+    dev = [
+        "basedpyright>=1.31.2",
+        "coverage>=7.10.4",
+        "poethepoet>=0.37.0",
+        "pytest>=8.4.1",
+        "ruff>=0.12.9",
+]
+    docs = [
+        "mkdocs>=1.6.1",
+        "mkdocs-git-authors-plugin>=0.10.0",
+        "mkdocs-git-committers-plugin-2>=2.5.0",
+        "mkdocs-git-revision-date-localized-plugin>=1.4.7",
+        "mkdocs-material>=9.6.17",
+        "mkdocs-typer2>=0.1.5",
+        "mkdocstrings-python>=1.17.0",
+    ]
+
+
+[tool.uv]
+    default-groups   = "all"
+    package          = true
+    required-version = ">=0.8.0"
+
+
+[tool.basedpyright]
+    ignore           = [ "examples", "tests/assets" ]
+    pythonVersion    = "3.10"
+    strict           = [ "src/debug_dojo/*" ]
+    typeCheckingMode = "all"
+
+
+[tool.ruff]
+    line-length    = 88
+    target-version = "py310"
+
+    [tool.ruff.lint]
+        exclude = [ "examples" ]
+        ignore  = [ "COM", "D203", "D211", "D213" ]
+        select  = [ "ALL" ]
+
+        [tool.ruff.lint.per-file-ignores]
+            "examples/*"                    = [ "INP001" ]
+            "examples/test_target.py"       = [ "F821" ]
+            "src/debug_dojo/_installers.py" = [ "PLC0415", "T100" ]
+            "tests/*"                       = [ "S101", "T201" ]
+            "tests/assets/*"                = [ "T201", "INP001", "F821" ]
+
+    [tool.ruff.format]
+        docstring-code-format = true
+
+
+[tool.poe.tasks]
+
+    format     = { cmd = "ruff format --diff --config=pyproject.toml", help = "Check code formatting using ruff." }
+    lint       = { cmd = "uv run ruff check --config=pyproject.toml", help = "Check code rules using ruff." }
+    precommit  = { cmd = "pre-commit run --all-files", help = "Run all code quality checks." }
+    test       = { cmd = "pytest --verbose --doctest-modules", help = "Run tests using pytest." }
+    type-check = { cmd = "basedpyright", help = "Check static typing using basedpyright." }
+
+    [tool.poe.tasks.code-quality]
+        help        = "Run all code quality checks."
+        ignore_fail = "return_non_zero"
+        sequence    = [ "fix", "precommit", "format", "lint", "type-check" ]
+
+    [tool.poe.tasks.fix]
+        default_item_type = "cmd"
+        help = "Code quality fixes using ruff."
+        ignore_fail = "return_non_zero"
+        sequence = [
+            "ruff check --fix --unsafe-fixes --config=pyproject.toml",
+            "ruff format --config=pyproject.toml",
+        ]
+
+    [tool.poe.tasks.publish]
+        sequence = [
+            "code-quality",
+            { cmd = "rm -rf dist" },
+            { cmd = "uv build" },
+            { cmd = "uv publish" },
+        ]
+
+[tool.docformatter]
+    black   = true
+    non-cap = [ "dojo" ]

debug_dojo-0.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

{debug_dojo-0.4.0 → debug_dojo-0.5.0}/src/debug_dojo/_cli.py

@@ -4,16 +4,29 @@ from __future__ import annotations
 
 import runpy
 import sys
+import traceback
 from bdb import BdbQuit
+from enum import Enum
 from pathlib import Path
+from shutil import which
 from typing import Annotated
 
 import typer
 from rich import print as rich_print
 
-from ._config import DebugDojoConfig, DebuggerType, load_config
+from ._config import load_config
+from ._config_models import DebugDojoConfig, DebuggerType  # noqa: TC001
 from ._installers import install_by_config
 
+
+class ExecMode(Enum):
+    """Execution mode for the target."""
+
+    FILE = "file"
+    MODULE = "module"
+    EXECUTABLE = "executable"
+
+
 cli = typer.Typer(
     name="debug_dojo",
     help="Run a Python script or module with debugging tools installed.",
@@ -21,15 +34,15 @@ cli = typer.Typer(
 )
 
 
-def execute_with_debug(  # noqa: C901
+def __execute_with_debug(  # noqa: C901
     target_name: str,
     target_args: list[str],
     *,
-    target_is_module: bool,
+    target_mode: ExecMode,
     verbose: bool,
     config: DebugDojoConfig,
 ) -> None:
-    """Execute a target script or module with installation of debugging tools."""
+    """Execute a target script or module with installed debugging tools."""
     sys.argv = [target_name, *target_args]
 
     if verbose:
@@ -38,35 +51,40 @@ def execute_with_debug(  # noqa: C901
 
     install_by_config(config)
 
-    if target_is_module:
+    if target_mode is ExecMode.MODULE:
         runner = runpy.run_module
     else:
+        if target_mode is ExecMode.EXECUTABLE:
+            target_name = which(target_name) or target_name
+
         if not Path(target_name).exists():
-            sys.exit(1)
+            raise typer.Exit(1)
+
         runner = runpy.run_path
 
     try:
         _ = runner(target_name, run_name="__main__")
     except ImportError as e:
         rich_print(f"[red]Error importing {target_name}:[/red]\n{e}")
-        sys.exit(1)
+        raise typer.Exit(1) from e
     except BdbQuit:
         rich_print("[red]Debugging session terminated by user.[/red]")
-        sys.exit(0)
+        raise typer.Exit(0) from None
     except KeyboardInterrupt:
         rich_print("[red]Execution interrupted by user.[/red]")
-        sys.exit(0)
+        raise typer.Exit(0) from None
     except SystemExit as e:
         if e.code:
             rich_print(f"[red]Script exited with code {e.code}.[/red]")
-    except Exception as e:  # noqa: BLE001
+    except Exception as e:
         rich_print(f"[red]Error while running {target_name}:[/red]\n{e}")
+        rich_print(traceback.format_exc())
         if config.exceptions.post_mortem:
-            import pdb  # noqa: PLC0415, T100
+            import ipdb  # pyright: ignore[reportMissingTypeStubs]  # noqa: PLC0415, T100
 
             rich_print("[blue]Entering post-mortem debugging session...[/blue]")
-            pdb.post_mortem(e.__traceback__)
-        sys.exit(1)
+            ipdb.post_mortem(e.__traceback__)  # pyright: ignore[reportUnknownMemberType]
+        raise typer.Exit(1) from e
 
 
 def display_config(config: DebugDojoConfig) -> None:
@@ -95,23 +113,41 @@ def run_debug(  # noqa: PLR0913
     ] = None,
     verbose: Annotated[
         bool,
-        typer.Option("--verbose", "-v", is_flag=True, help="Enable verbose output"),
+        typer.Option("--verbose", "-v", help="Enable verbose output"),
     ] = False,
     module: Annotated[
         bool,
-        typer.Option("--module", "-m", is_flag=True, help="Run as a module"),
+        typer.Option("--module", "-m", help="Run a module"),
+    ] = False,
+    executable: Annotated[
+        bool,
+        typer.Option("--exec", "-e", help="Run a command"),
     ] = False,
 ) -> None:
     """Run the command-line interface."""
+    if module and executable:
+        rich_print(
+            "[red]Error: --module and --command options are mutually exclusive.[/red]"
+        )
+        raise typer.Exit(1)
+
+    mode = (
+        ExecMode.EXECUTABLE
+        if executable
+        else ExecMode.MODULE
+        if module
+        else ExecMode.FILE
+    )
+
     config = load_config(config_path, verbose=verbose, debugger=debugger)
 
     if verbose:
         display_config(config)
 
     if target_name:
-        execute_with_debug(
+        __execute_with_debug(
             target_name=target_name,
-            target_is_module=module,
+            target_mode=mode,
             target_args=ctx.args,
             verbose=verbose,
             config=config,

debug_dojo-0.4.0/src/debug_dojo/_compareres.py → debug_dojo-0.5.0/src/debug_dojo/_compare.py

@@ -1,7 +1,7 @@
-"""Utilities for side-by-side inspection and comparison of Python objects using Rich.
+"""Utilities for side-by-side inspection and comparison of Python objects.
 
-This module provides functions to display attributes and methods of two objects
-in a visually appealing, side-by-side format in the terminal.
+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
@@ -15,15 +15,7 @@ from rich.text import Text
 
 
 def _get_object_attributes(obj: object) -> list[str]:
-    """Extract and format non-callable attributes of an object.
-
-    Args:
-        obj: The object to inspect.
-
-    Returns:
-        A list of strings, each representing an attribute in 'name=value' format.
-
-    """
+    """Extract and format non-callable attributes of an object."""
     attributes: list[str] = []
     for attr_name in sorted(dir(obj)):
         # Safely get attribute, returning None if it doesn't exist
@@ -37,15 +29,7 @@ def _get_object_attributes(obj: object) -> list[str]:
 
 
 def _get_object_methods(obj: object) -> list[str]:
-    """Extract and format public callable methods of an object.
-
-    Args:
-        obj: The object to inspect.
-
-    Returns:
-        A list of strings, each representing a method name.
-
-    """
+    """Extract and format public callable methods of an object."""
     methods: list[str] = []
     for method_name in sorted(dir(obj)):
         # Safely get attribute, returning None if it doesn't exist
@@ -59,15 +43,8 @@ def _get_object_methods(obj: object) -> list[str]:
 def _get_simplified_object_info(obj: object) -> list[Text]:
     """Generate a simplified, Rich-formatted inspection output for an object.
 
-    Handles basic Python types by displaying their value directly. For other
-    objects, it lists their attributes and public methods.
-
-    Args:
-        obj: The object to generate info for.
-
-    Returns:
-        A list of Rich Text objects, each representing a line of information.
-
+    Handles basic Python types by displaying their value directly. For other objects, it
+    lists their attributes and public methods.
     """
     info_lines: list[Text] = []
     obj_type: str = type(obj).__name__

{debug_dojo-0.4.0 → debug_dojo-0.5.0}/src/debug_dojo/_config.py

@@ -1,19 +1,20 @@
 """Debug Dojo configuration module.
 
-It includes configurations for different debuggers, exception handling,
-and features that can be enabled or disabled.
+It includes configurations for different debuggers, exception handling, and features
+that can be enabled or disabled.
 """
 
 from __future__ import annotations
 
-import sys
+from collections.abc import Mapping, Sequence
 from pathlib import Path
-from typing import Any, cast
+from typing import Any, TypeAlias, cast
 
 from pydantic import ValidationError
 from rich import print as rich_print
 from tomlkit import parse
 from tomlkit.exceptions import TOMLKitError
+from typer import Exit
 
 from ._config_models import (
     DebugDojoConfig,
@@ -22,6 +23,10 @@ from ._config_models import (
     DebuggerType,
 )
 
+JSON_ro: TypeAlias = (
+    Mapping[str, "JSON_ro"] | Sequence["JSON_ro"] | str | int | float | bool | None
+)
+
 
 def __filter_pydantic_error_msg(error: ValidationError) -> str:
     """Filter out specific lines from a Pydantic validation error."""
@@ -32,8 +37,11 @@ def __filter_pydantic_error_msg(error: ValidationError) -> str:
     )
 
 
-def resolve_config_path(config_path: Path | None) -> Path | None:
-    """Resolve the configuration path, returning a default if none is provided."""
+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()}"
@@ -44,16 +52,16 @@ def resolve_config_path(config_path: Path | None) -> Path | None:
     for path in (Path("dojo.toml"), Path("pyproject.toml")):
         if path.exists():
             return path.resolve()
+
+    # None means - use default config values
     return None
 
 
-def load_raw_config(
-    config_path: Path,
-) -> dict[str, Any]:  # pyright: ignore[reportExplicitAny]
+def __load_raw_config(config_path: Path) -> JSON_ro:
     """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.
+    Currently supports 'dojo.toml' or 'pyproject.toml'. If no path is provided, it
+    checks the current directory for these files.
     """
     config_str = config_path.read_text(encoding="utf-8")
 
@@ -66,7 +74,10 @@ def load_raw_config(
     # If config is in [tool.debug_dojo] (pyproject.toml), extract it.
     if config_path.name == "pyproject.toml":
         try:
-            dojo_config = cast("dict[str, Any]", config_data["tool"]["debug_dojo"])
+            dojo_config = cast(
+                "dict[str, Any]",  # pyright: ignore[reportExplicitAny]
+                config_data["tool"]["debug_dojo"],
+            )
         except KeyError:
             return {}
         else:
@@ -75,28 +86,11 @@ def load_raw_config(
     return config_data
 
 
-def load_config(  # noqa: C901
-    config_path: Path | None = None,
-    *,
-    verbose: bool = False,
-    debugger: DebuggerType | None = None,
+def __validated_and_updated_config(
+    raw_config: JSON_ro, *, verbose: bool
 ) -> 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}."
-        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)
-
     config = None
+
     for model in (DebugDojoConfigV2, DebugDojoConfigV1):
         model_name = model.__name__
         try:
@@ -106,7 +100,6 @@ def load_config(  # noqa: C901
                 msg = (
                     f"[yellow]Configuration validation error for {model_name}:\n"
                     f"{__filter_pydantic_error_msg(e)}\n\n"
-                    f"Please check your configuration file {resolved_path}.[/yellow]"
                 )
                 rich_print(msg)
         else:
@@ -119,17 +112,45 @@ def load_config(  # noqa: C901
             break
 
     if not config:
-        msg = (
-            f"[red]Unsupported configuration version in {resolved_path.resolve()}.\n"
-            "Please update your configuration file.[/red]"
-        )
+        msg = "[red]Unsupported configuration version or error.[/red]"
         rich_print(msg)
-        sys.exit(1)
+        raise Exit(code=1)
 
     while not isinstance(config, DebugDojoConfig):
         config = config.update()
 
-    # If a debugger is specified, update the config.
+    return config
+
+
+def load_config(
+    config_path: Path | None = None,
+    *,
+    verbose: bool = False,
+    debugger: DebuggerType | None = None,
+) -> DebugDojoConfig:
+    """Load the Debug Dojo configuration.
+
+    Return a DebugDojoConfig instance with the loaded configuration.
+
+    If no configuration file is found, it returns a default configuration. If a debugger
+    is specified, it overrides the config.
+    """
+    resolved_path = __resolve_config_path(config_path)
+
+    if verbose:
+        if resolved_path:
+            msg = f"Using configuration file: {resolved_path}."
+        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)
+    config = __validated_and_updated_config(raw_config, verbose=verbose)
+
+    # If a debugger is specified, override the config.
     if debugger:
         config.debuggers.default = debugger