configaroo 0.4.2__tar.gz → 0.5.1__tar.gz

{configaroo-0.4.2/src/configaroo.egg-info → configaroo-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: configaroo
-Version: 0.4.2
+Version: 0.5.1
 Summary: Bouncy handling of configuration files
 Author-email: Geir Arne Hjelle <geirarne@gmail.com>
 Maintainer-email: Geir Arne Hjelle <geirarne@gmail.com>
@@ -33,9 +33,9 @@ Dynamic: license-file
 [![Python versions](https://img.shields.io/pypi/pyversions/configaroo.svg)](https://pypi.org/project/configaroo/)
 [![License](https://img.shields.io/pypi/l/configaroo.svg)](https://github.com/gahjelle/configaroo/blob/main/LICENSE)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![Linted](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml)
+[![Linted with Ruff](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml)
 [![Tested with Pytest](https://github.com/gahjelle/configaroo/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/test.yml)
-[![Type checked with mypy](https://img.shields.io/badge/type%20checked-mypy-green)](http://mypy-lang.org/)
+[![Type checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
 
 Configaroo is a light configuration package for Python that offers the following features:
 

{configaroo-0.4.2 → configaroo-0.5.1}/README.md

@@ -4,9 +4,9 @@
 [![Python versions](https://img.shields.io/pypi/pyversions/configaroo.svg)](https://pypi.org/project/configaroo/)
 [![License](https://img.shields.io/pypi/l/configaroo.svg)](https://github.com/gahjelle/configaroo/blob/main/LICENSE)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![Linted](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml)
+[![Linted with Ruff](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml)
 [![Tested with Pytest](https://github.com/gahjelle/configaroo/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/test.yml)
-[![Type checked with mypy](https://img.shields.io/badge/type%20checked-mypy-green)](http://mypy-lang.org/)
+[![Type checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
 
 Configaroo is a light configuration package for Python that offers the following features:
 

{configaroo-0.4.2 → configaroo-0.5.1}/pyproject.toml

@@ -36,13 +36,14 @@ changelog = "https://github.com/gahjelle/configaroo/releases"
 
 [dependency-groups]
 build = ["build>=1.2.2.post1", "twine>=6.1.0"]
-ci = ["mypy>=1.17.1", "pytest>=8.4.1", "rich>=14.1.0", "ruff>=0.12.7", "tomli-w>=1.2.0"]
+ci = ["pytest>=8.4.1", "rich>=14.1.0", "ruff>=0.12.7", "tomli-w>=1.2.0"]
 dev = [
     { include-group = "ci" },
     { include-group = "test" },
     "bumpver>=2024.1130",
     "ipython>=8.36.0",
     "pre-commit>=4.2.0",
+    "pyright>=1.1.404",
 ]
 test = ["pytest>=8.4.1", "pytest-cov>=6.2.1", "tomli-w>=1.2.0"]
 
@@ -74,12 +75,18 @@ ignore = [
 "tests/test_*.py" = ["PLR2004", "S101", "SLF001", "UP018"]
 "tests/*/test_*.py" = ["S101"]
 
-[tool.mypy]
-python_version = "3.11"
-strict = true
+[tool.pyright]
+pythonVersion = "3.11"
+typeCheckingMode = "strict"
+verboseOutput = false
+include = ["src/", "tests/", "examples/"]
+venv = ".venv"
+
+reportUnknownArgumentType = "none"
+reportUnknownMemberType = "none"
 
 [tool.bumpver]
-current_version = "v0.4.2"
+current_version = "v0.5.1"
 version_pattern = "vMAJOR.MINOR.PATCH"
 commit_message = "bump version {old_version} -> {new_version}"
 tag_message = "{new_version}"

{configaroo-0.4.2 → configaroo-0.5.1}/src/configaroo/__init__.py

@@ -20,4 +20,4 @@ __all__ = [
     "print_configuration",
 ]
 
-__version__ = "0.4.2"
+__version__ = "0.5.1"

{configaroo-0.4.2 → configaroo-0.5.1}/src/configaroo/configuration.py

@@ -155,7 +155,7 @@ class Configuration(UserDict[str, Any]):
         self,
         model: type[BaseModel],
         prefix: str = "",
-        types: type | UnionType = str | bool | int | float,
+        types: type | UnionType = str | bool | int | float,  # pyright: ignore[reportArgumentType]
     ) -> Self:
         """Add environment variables to configuration based on the given model.
 
@@ -220,26 +220,46 @@ class Configuration(UserDict[str, Any]):
         }
 
 
-def print_configuration(config: Configuration | BaseModel, indent: int = 4) -> None:
+def print_configuration(
+    config: Configuration | BaseModel, section: str | None = None, indent: int = 4
+) -> None:
     """Pretty print a configuration.
 
     If rich is installed, then a rich console is used for the printing.
     """
-    return _print_dict_as_tree(
-        config.model_dump() if isinstance(config, BaseModel) else config,
-        indent=indent,
-        _print=_get_rich_print(),
+    cfg = (
+        Configuration(config.model_dump()) if isinstance(config, BaseModel) else config
     )
+    if section is None:
+        _print, _escape = _get_rich_print()
+        return _print_dict_as_tree(cfg, indent=indent, _print=_print, _escape=_escape)
+
+    cfg_section = cfg.get(section)
+    if cfg_section is None:
+        message = f"'{type(cfg).__name__}' has no section '{section}'"
+        raise KeyError(message) from None
+
+    if isinstance(cfg_section, Configuration):
+        return print_configuration(cfg_section, indent=indent)
 
+    *_, key = section.split(".")
+    return print_configuration(Configuration({key: cfg_section}), indent=indent)
 
-def _get_rich_print() -> Callable[[str], None]:  # pragma: no cover
-    """Initialize a Rich console if Rich is installed, otherwise use built-in print."""
+
+def _get_rich_print() -> tuple[
+    Callable[[str], None], Callable[[str], str]
+]:  # pragma: no cover
+    """Initialize a Rich console if Rich is installed, otherwise use built-in print.
+
+    Include a function that can be used to escape markup.
+    """
     try:
         from rich.console import Console  # noqa: PLC0415
+        from rich.markup import escape  # noqa: PLC0415
 
-        return Console().print
+        return Console().print, escape
     except ImportError:
-        return print
+        return print, str
 
 
 def _print_dict_as_tree(
@@ -247,6 +267,7 @@ def _print_dict_as_tree(
     indent: int = 4,
     current_indent: int = 0,
     _print: Callable[[str], None] = print,
+    _escape: Callable[[str], str] = str,
 ) -> None:
     """Print a nested dictionary as a tree."""
     for key, value in data.items():
@@ -257,9 +278,11 @@ def _print_dict_as_tree(
                 indent=indent,
                 current_indent=current_indent + indent,
                 _print=_print,
+                _escape=_escape,
             )
         else:
-            _print(" " * current_indent + f"- {key}: {value!r}")
+            escaped_repr = _escape(repr(value))
+            _print(" " * current_indent + f"- {key}: {escaped_repr}")
 
 
 def find_pyproject_toml(

{configaroo-0.4.2 → configaroo-0.5.1/src/configaroo.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: configaroo
-Version: 0.4.2
+Version: 0.5.1
 Summary: Bouncy handling of configuration files
 Author-email: Geir Arne Hjelle <geirarne@gmail.com>
 Maintainer-email: Geir Arne Hjelle <geirarne@gmail.com>
@@ -33,9 +33,9 @@ Dynamic: license-file
 [![Python versions](https://img.shields.io/pypi/pyversions/configaroo.svg)](https://pypi.org/project/configaroo/)
 [![License](https://img.shields.io/pypi/l/configaroo.svg)](https://github.com/gahjelle/configaroo/blob/main/LICENSE)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
-[![Linted](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml)
+[![Linted with Ruff](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/lint.yml)
 [![Tested with Pytest](https://github.com/gahjelle/configaroo/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/gahjelle/configaroo/actions/workflows/test.yml)
-[![Type checked with mypy](https://img.shields.io/badge/type%20checked-mypy-green)](http://mypy-lang.org/)
+[![Type checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
 
 Configaroo is a light configuration package for Python that offers the following features:
 

{configaroo-0.4.2 → configaroo-0.5.1}/tests/test_configuration.py

@@ -127,12 +127,12 @@ def test_find_pyproject_toml() -> None:
 
 def test_find_foreign_caller() -> None:
     """Test that a foreign caller (outside of configaroo) can be identified."""
-    assert configuration._get_foreign_path() == Path(__file__)
+    assert configuration._get_foreign_path() == Path(__file__)  # pyright: ignore[reportPrivateUsage]
 
 
 def test_incomplete_formatter() -> None:
     """Test that the incomplete formatter can handle fields that aren't replaced."""
-    formatted = configuration._incomplete_format(
+    formatted = configuration._incomplete_format(  # pyright: ignore[reportPrivateUsage]
         "{number:5.1f} {non_existent} {string!r} {name}",
         {"number": 3.14, "string": "platypus", "name": "Geir Arne"},
     )

{configaroo-0.4.2 → configaroo-0.5.1}/tests/test_print.py

@@ -54,3 +54,49 @@ def test_printing_of_dynamic_values(
     assert "- number: 42" in lines
     assert "- phrase: 'The meaning of life is 42'" in lines
     assert "    - format: '<level>{level:<8} testing configaroo</level>'" in lines
+
+
+def test_printing_of_existing_section(
+    capsys: pytest.CaptureFixture[str], config: Configuration
+) -> None:
+    """Test that sections can be printed."""
+    print_configuration(config, section="paths")
+    stdout = capsys.readouterr().out
+    lines = stdout.splitlines()
+
+    assert "- absolute: '/home/configaroo'" in lines
+    assert "- number: 42" not in lines
+
+
+def test_printing_of_nonexisting_section(config: Configuration) -> None:
+    """Test that non-existing sections raise an error."""
+    with pytest.raises(KeyError):
+        print_configuration(config, section="nonexisting")
+
+
+def test_printing_of_values(
+    capsys: pytest.CaptureFixture[str], config: Configuration
+) -> None:
+    """Test that individual values can be printed."""
+    print_configuration(config, section="number")
+    stdout = capsys.readouterr().out
+    lines = stdout.splitlines()
+
+    assert lines == ["- number: 42"]
+
+
+def test_printing_of_nested_sections(
+    capsys: pytest.CaptureFixture[str], config: Configuration
+) -> None:
+    """Test that nested sections can be printed."""
+    print_configuration(config, section="nested.deep")
+    stdout = capsys.readouterr().out
+    lines = stdout.splitlines()
+
+    assert lines == ["- sea: 'Marianer'"]
+
+
+def test_printing_of_rich_markup() -> None:
+    """Test that a config value containing malformed Rich markup can be printed."""
+    config = Configuration({"markup": "[/]"})
+    print_configuration(config)