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

debug_dojo-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright (c) 2025 to bwrob.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+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.

{debug_dojo-0.4.1 → debug_dojo-0.5.0}/PKG-INFO

@@ -1,17 +1,15 @@
 Metadata-Version: 2.4
 Name: debug-dojo
-Version: 0.4.1
-Summary: 🏣 Debugging dojo for Python developers
-Project-URL: Homepage, https://bwrob.github.io/debug-dojo/
-Project-URL: Documentation, https://bwrob.github.io/debug-dojo/
-Project-URL: Source, https://github.com/bwrob/debug-dojo/
-Project-URL: Changelog, https://github.com/bwrob/debug-dojo/blob/main/HISTORY.md
+Version: 0.5.0
+Summary: 🏣 debug dojo, a place for zen debugging
 Author-email: bwrob <bartosz.marcin.wroblewski@gmail.com>
 License-Expression: MIT
-Keywords: debugging,inspection,pudb,rich,tools,traceback
-Classifier: Development Status :: 3 - Alpha
+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: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -20,6 +18,8 @@ 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
@@ -27,20 +27,23 @@ 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
+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:300px;"/>
+  <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>
+<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`.
@@ -78,48 +81,3 @@ 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/).
-# Changelog
-
-## v0.4.1 (2025-08-10)
-
-*release tag*: [v0.4.1](https://github.com/bwrob/debug-dojo/releases/tag/v0.4.1)
-
-- Mkdocs documentation at [debug dojo](https://bwrob.github.io/debug-dojo).
-
-## v0.4.0 (2025-08-10)
-
-*release tag*: [v0.4.0](https://github.com/bwrob/debug-dojo/releases/tag/v0.4.0)
-
-- New configuration model `DebugDojoConfig` for better structure.
-- Added support for `debugger` configuration in `dojo.toml`.
-- Updated `dojo` command to include debugger type in command call.
-- Configuration versioning allows for in-flight migration of old configurations.
-- Improved error handling in configuration loading.
-- Improved catching errors from target execution.
-
-## v0.3.2 (2025-07-28)
-
-*release tag*: [v0.3.2](https://github.com/bwrob/debug-dojo/releases/tag/v0.3.2)
-
-- 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.
-- Fixed documentation and history.
-
-## v0.2.0 (2025-07-20)
-
-*release tag*: [v0.2.0](https://github.com/bwrob/debug-dojo/releases/tag/v0.2.0)
-
-- Added `dojo` command for easy debugging setup.
-- Added `p()` function for rich printing.
-- Added history file for tracking changes.
-- Moved to `hatch` for building and packaging.
-- Fixed `pyproject.toml` to point to GitHub repository as the homepage.
-
-## v0.1.0 (2025-07-19)
-
-*release tag*: [v0.1.0](https://github.com/bwrob/debug-dojo/releases/tag/v0.1.0)
-
-- Initial module to install debugging tools.
-- Debug mode utilities for PuDB, rich tracebacks, and object inspection.

{debug_dojo-0.4.1 → debug_dojo-0.5.0}/README.md

@@ -1,15 +1,18 @@
 # 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:300px;"/>
+  <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>
+<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`.

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.1 → 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.1/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.1 → 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