lib-cli-exit-tools 2.3.0__py3-none-any.whl → 2.3.2__py3-none-any.whl

lib_cli_exit_tools/__init__conf__.py

@@ -24,7 +24,7 @@ name = "lib_cli_exit_tools"
 #: Human-readable summary shown in CLI help output.
 title = "CLI exit handling helpers: clean signals, exit codes, and error printing"
 #: Current release version pulled from ``pyproject.toml`` by automation.
-version = "2.3.0"
+version = "2.3.2"
 #: Repository homepage presented to users.
 homepage = "https://github.com/bitranox/lib_cli_exit_tools"
 #: Author attribution surfaced in CLI output.

lib_cli_exit_tools/application/runner.py

@@ -20,7 +20,7 @@ from __future__ import annotations
 
 import sys
 from contextlib import contextmanager, nullcontext, suppress
-from typing import Callable, ContextManager, Iterable, Iterator, Literal, Protocol, Sequence, TextIO, TypedDict, cast
+from typing import Callable, ContextManager, Generator, Iterable, Literal, Protocol, Sequence, TextIO, TypedDict, cast
 
 import rich_click as click
 from rich_click import rich_click as rich_config
@@ -461,7 +461,7 @@ def cli_session(
     verbose_limit: int = 10_000,
     overrides: SessionOverrides | None = None,
     restore: bool = True,
-) -> Iterator[
+) -> Generator[
     Callable[
         [
             ClickCommand,
@@ -571,7 +571,7 @@ def _session_config_manager(applied: SessionOverrides, restore: bool) -> Context
 
 
 @contextmanager
-def _apply_overrides_without_restore(applied: SessionOverrides) -> Iterator[None]:
+def _apply_overrides_without_restore(applied: SessionOverrides) -> Generator[None]:
     """Apply overrides without restoring prior state on exit.
 
     Parameters:

lib_cli_exit_tools/cli/group.py

@@ -23,6 +23,7 @@ from .. import __init__conf__
 from .. import lib_cli_exit_tools
 from .commands import CLICK_CONTEXT_SETTINGS
 from .styling import _temporary_rich_click_configuration  # pyright: ignore[reportPrivateUsage]
+from .typed_click import option, version_option
 
 
 @dataclass
@@ -41,12 +42,12 @@ class CliContextState:
 
 
 @click.group(help=__init__conf__.title, context_settings=CLICK_CONTEXT_SETTINGS)
-@click.version_option(
+@version_option(
     version=__init__conf__.version,
     prog_name=__init__conf__.shell_command,
     message=f"{__init__conf__.shell_command} version {__init__conf__.version}",
 )
-@click.option(
+@option(
     "--traceback/--no-traceback",
     is_flag=True,
     default=False,

lib_cli_exit_tools/cli/styling.py

@@ -16,7 +16,7 @@ System Integration:
 from __future__ import annotations
 
 from contextlib import contextmanager
-from typing import Any, Iterator, TypedDict
+from typing import Any, Generator, TypedDict
 
 import rich_click as click
 from rich_click import rich_click as rich_config
@@ -97,7 +97,7 @@ def _restore_rich_click_options(snapshot: RichClickSnapshot) -> None:
 
 
 @contextmanager
-def _temporary_rich_click_configuration() -> Iterator[None]:  # pyright: ignore[reportUnusedFunction]
+def _temporary_rich_click_configuration() -> Generator[None]:  # pyright: ignore[reportUnusedFunction]
     """Apply plain-output safeguards and restore rich-click globals afterwards."""
 
     snapshot = _snapshot_rich_click_options()

lib_cli_exit_tools/cli/typed_click.py

@@ -0,0 +1,29 @@
+"""Strictly-typed wrappers for rich_click decorators with partially-unknown types.
+
+rich_click ships ``py.typed`` but re-exports click's decorators, whose
+``ParamType[Unknown]`` parameters make pyright (strict mode) report
+``reportUnknownMemberType`` at every call site. Wrapping the affected decorators
+here behind explicit, fully-known signatures keeps the rest of the code
+strict-clean without disabling the rule. This module is the single boundary that
+touches the untyped surface, so the only ``# pyright: ignore`` for this gap lives here.
+"""
+
+from collections.abc import Callable
+from typing import Any
+
+import rich_click as click
+
+_CommandDecorator = Callable[[Callable[..., Any]], Callable[..., Any]]
+
+
+def option(*param_decls: str, **attrs: Any) -> _CommandDecorator:
+    """Typed wrapper over :func:`rich_click.option`. See module docstring."""
+    return click.option(*param_decls, **attrs)  # pyright: ignore[reportUnknownMemberType]
+
+
+def version_option(*param_decls: str, **attrs: Any) -> _CommandDecorator:
+    """Typed wrapper over :func:`rich_click.version_option`. See module docstring."""
+    return click.version_option(*param_decls, **attrs)  # pyright: ignore[reportUnknownMemberType]
+
+
+__all__ = ["option", "version_option"]

lib_cli_exit_tools/core/configuration.py

@@ -20,7 +20,7 @@ System Integration:
 
 from __future__ import annotations
 
-from collections.abc import Iterator, Mapping
+from collections.abc import Generator, Mapping
 from contextlib import contextmanager
 from dataclasses import dataclass, fields
 from enum import Enum
@@ -156,7 +156,7 @@ def reset_config() -> None:
 
 
 @contextmanager
-def config_overrides(**overrides: object) -> Iterator[_Config]:
+def config_overrides(**overrides: object) -> Generator[_Config]:
     """Snapshot configuration state and optionally apply temporary overrides."""
 
     _reject_unknown_fields(overrides)

{lib_cli_exit_tools-2.3.0.dist-info → lib_cli_exit_tools-2.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_cli_exit_tools
-Version: 2.3.0
+Version: 2.3.2
 Summary: CLI exit handling helpers: clean signals, exit codes, and error printing
 Project-URL: Homepage, https://github.com/bitranox/lib_cli_exit_tools
 Project-URL: Repository, https://github.com/bitranox/lib_cli_exit_tools.git
@@ -14,24 +14,29 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+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: Programming Language :: Python :: 3.14
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: rich-click>=1.9.7
+Requires-Dist: rich-click>=1.9.8
 Provides-Extra: dev
-Requires-Dist: bandit>=1.9.3; extra == 'dev'
-Requires-Dist: build>=1.4.0; extra == 'dev'
-Requires-Dist: codecov-cli>=11.2.6; extra == 'dev'
-Requires-Dist: coverage[toml]>=7.13.4; extra == 'dev'
-Requires-Dist: hypothesis>=6.151.6; extra == 'dev'
-Requires-Dist: import-linter>=2.10; extra == 'dev'
-Requires-Dist: pip-audit>=2.10.0; extra == 'dev'
-Requires-Dist: pyright[nodejs]>=1.1.408; extra == 'dev'
-Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
-Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
-Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Requires-Dist: bandit>=1.9.4; extra == 'dev'
+Requires-Dist: build>=1.5.0; extra == 'dev'
+Requires-Dist: codecov-cli>=11.2.8; extra == 'dev'
+Requires-Dist: coverage[toml]>=7.14.1; extra == 'dev'
+Requires-Dist: hypothesis>=6.155.2; extra == 'dev'
+Requires-Dist: import-linter>=2.11; extra == 'dev'
+Requires-Dist: pip-audit>=2.10.1; extra == 'dev'
+Requires-Dist: pyright[nodejs]>=1.1.410; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
+Requires-Dist: pytest>=9.1.0; extra == 'dev'
 Requires-Dist: rtoml>=0.13.0; extra == 'dev'
-Requires-Dist: ruff>=0.15.1; extra == 'dev'
-Requires-Dist: textual>=7.5.0; extra == 'dev'
+Requires-Dist: ruff>=0.15.17; extra == 'dev'
+Requires-Dist: textual>=8.2.7; extra == 'dev'
 Requires-Dist: twine>=6.2.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -47,7 +52,6 @@ Description-Content-Type: text/markdown
 [![Code Style: Ruff](https://img.shields.io/badge/Code%20Style-Ruff-46A3FF?logo=ruff&labelColor=000)](https://docs.astral.sh/ruff/)
 [![codecov](https://codecov.io/gh/bitranox/lib_cli_exit_tools/graph/badge.svg?token=z1D8JSjWEH)](https://codecov.io/gh/bitranox/lib_cli_exit_tools)
 [![Maintainability](https://qlty.sh/gh/bitranox/projects/lib_cli_exit_tools/maintainability.svg)](https://qlty.sh/gh/bitranox/projects/lib_cli_exit_tools)
-[![Known Vulnerabilities](https://snyk.io/test/github/bitranox/lib_cli_exit_tools/badge.svg)](https://snyk.io/test/github/bitranox/lib_cli_exit_tools)
 [![security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)
 
 Small helpers for robust CLI exit handling:

{lib_cli_exit_tools-2.3.0.dist-info → lib_cli_exit_tools-2.3.2.dist-info}/RECORD

@@ -1,21 +1,22 @@
 lib_cli_exit_tools/__init__.py,sha256=KzpZAMrc328V_nYm2GuTR0Sxyqh0XuKtlHP6dVCs2pc,1905
-lib_cli_exit_tools/__init__conf__.py,sha256=tYrmAVN5mo_12V1_m_un7FtroeeZY0M9zHrPFXvnOdU,2521
+lib_cli_exit_tools/__init__conf__.py,sha256=PgIe-Fn7sU48afeTt7UWbyqPvIyHaU4YwECgRQ5fnbw,2521
 lib_cli_exit_tools/__main__.py,sha256=wODJaNu_NyO7tknvlpPArq0MaDwDum8zqyb73-qshzo,257
 lib_cli_exit_tools/lib_cli_exit_tools.py,sha256=fCLgJypLi6VHjmnh0McUn3CbhBhdzGYdDGcwcLokL4o,2561
 lib_cli_exit_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lib_cli_exit_tools/adapters/__init__.py,sha256=Jj8FCGY1lAPAduYSW3wTDh8ojpr9BZms7wKEMPq8pWE,504
 lib_cli_exit_tools/adapters/signals.py,sha256=Q2D9Htv64nsT5n66cJFDDHRWVXJokaG77I-V8gTDMKg,5772
 lib_cli_exit_tools/application/__init__.py,sha256=Yikej3OOOaAjWOvFimg1jUYrCUGu5d3-RBiiai4tHDM,566
-lib_cli_exit_tools/application/runner.py,sha256=oTzARoieuN0JK7KRSzrMhKTFWF6GA8cxt1pK6YVjgVM,24413
+lib_cli_exit_tools/application/runner.py,sha256=Dz58vHqgKiGNNILRsQSlySCOiYdcpbf6gs67WEgbG_g,24416
 lib_cli_exit_tools/cli/__init__.py,sha256=IVyU1DEgn2xBYfp1BBpund9nucUEPyOu7yt8DShu470,1094
 lib_cli_exit_tools/cli/commands.py,sha256=WDF6hDsyczAb6cQp4fA6KMF1iqJQ1lzjv-RvIxq1itI,2418
-lib_cli_exit_tools/cli/group.py,sha256=UFKb8VCkkQEB4CwIDckItrPHTRxSCddyLXKKr-2xU-w,4224
-lib_cli_exit_tools/cli/styling.py,sha256=2W9-0Ig4X3RO8wVPukZEg2V_kBJfZKJANlawUOJAlhg,4236
+lib_cli_exit_tools/cli/group.py,sha256=nhMICASyfbAB1qDI9bwIHJ5IHxrGBf6uZOZSF3N97cg,4260
+lib_cli_exit_tools/cli/styling.py,sha256=Q23pmmzq7GpPWWbqAXXrJrZoqt_xlJi4Q0gtSJiknBI,4238
+lib_cli_exit_tools/cli/typed_click.py,sha256=xQJtl1EN2HC937N48i_z6P_6CdEpJXXDh_BUbzhNI9g,1249
 lib_cli_exit_tools/core/__init__.py,sha256=aR7OIBWOQ1PsA33blOTgLrq5ffKDCuaMVBS5mbrDAZ8,531
-lib_cli_exit_tools/core/configuration.py,sha256=ND0BBRBY7BkRbQWliWj-pp7pY1g8QULxgkeXfu2wfI8,6121
+lib_cli_exit_tools/core/configuration.py,sha256=rv911nWmFPQmJczP_CDNXhJ_5eAJPSBmwYCPr5DN40U,6123
 lib_cli_exit_tools/core/exit_codes.py,sha256=ukinlUROFKb6KmF_-8luxE1C2VJc6UwxIMMr0eB9xFg,12349
-lib_cli_exit_tools-2.3.0.dist-info/METADATA,sha256=PQkASspOF7lCn8k3UG2y4lGdLJo_w-nHQWpoOirduC4,26234
-lib_cli_exit_tools-2.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-lib_cli_exit_tools-2.3.0.dist-info/entry_points.txt,sha256=8R-_3UT0KcQ7HQ7idDx6rlG77GhHb0E2N5QnN41dj-M,161
-lib_cli_exit_tools-2.3.0.dist-info/licenses/LICENSE,sha256=6s9SL2InRrwynPjJYiER7ONHBshbGj_yC5EBzfo7l9I,1072
-lib_cli_exit_tools-2.3.0.dist-info/RECORD,,
+lib_cli_exit_tools-2.3.2.dist-info/METADATA,sha256=VvvVEpr8HKXNcksi81PKNCzpkIJzkjJm8fYf69bKgbU,26339
+lib_cli_exit_tools-2.3.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lib_cli_exit_tools-2.3.2.dist-info/entry_points.txt,sha256=8R-_3UT0KcQ7HQ7idDx6rlG77GhHb0E2N5QnN41dj-M,161
+lib_cli_exit_tools-2.3.2.dist-info/licenses/LICENSE,sha256=6s9SL2InRrwynPjJYiER7ONHBshbGj_yC5EBzfo7l9I,1072
+lib_cli_exit_tools-2.3.2.dist-info/RECORD,,

{lib_cli_exit_tools-2.3.0.dist-info → lib_cli_exit_tools-2.3.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.28.0
+Generator: hatchling 1.30.1
 Root-Is-Purelib: true
 Tag: py3-none-any