lib-cli-exit-tools 2.2.2__py3-none-any.whl → 2.2.3__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.2.2"
+version = "2.2.3"
 #: Repository homepage presented to users.
 homepage = "https://github.com/bitranox/lib_cli_exit_tools"
 #: Author attribution surfaced in CLI output.

{lib_cli_exit_tools-2.2.2.dist-info → lib_cli_exit_tools-2.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lib_cli_exit_tools
-Version: 2.2.2
+Version: 2.2.3
 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
@@ -31,7 +31,7 @@ Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
 Requires-Dist: pytest>=9.0.2; extra == 'dev'
 Requires-Dist: rtoml>=0.13.0; extra == 'dev'
 Requires-Dist: ruff>=0.14.9; extra == 'dev'
-Requires-Dist: textual>=6.8.0; extra == 'dev'
+Requires-Dist: textual>=6.10.0; extra == 'dev'
 Requires-Dist: twine>=6.2.0; extra == 'dev'
 Description-Content-Type: text/markdown
 
@@ -130,7 +130,7 @@ CLI that demonstrates configuration hooks and structured error handling.
 ```python
 from __future__ import annotations
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import run_cli
 
@@ -138,7 +138,6 @@ from lib_cli_exit_tools import run_cli
 @click.command()
 def hello() -> None:
     """Say hello with automatic signal-aware exit handling."""
-
     click.echo("Hello from lib_cli_exit_tools!")
 
 
@@ -157,29 +156,32 @@ python hello.py
 ```python
 from __future__ import annotations
 
-import click
-
-from lib_cli_exit_tools import cli_session, run_cli
-
+import rich_click as click
 
-@click.command()
-@click.option("--traceback", is_flag=True, help="Show full tracebacks on error")
-def cli(traceback: bool) -> int:
-    with cli_session(overrides={"traceback": traceback}) as execute:
-        return execute(failable, argv=[])
+from lib_cli_exit_tools import cli_session
 
 
 @click.command()
 def failable() -> None:
+    """Command that always fails to demonstrate traceback handling."""
     raise RuntimeError("toggle --traceback to see the full traceback")
 
 
+def main(*, traceback: bool = False) -> int:
+    """Run failable with optional traceback display."""
+    with cli_session(overrides={"traceback": traceback}) as run:
+        return run(failable)
+
+
 if __name__ == "__main__":
-    raise SystemExit(run_cli(cli))
+    import sys
+
+    enable_traceback = "--traceback" in sys.argv
+    raise SystemExit(main(traceback=enable_traceback))
 ```
 
-Invoking `python cli.py --traceback` enables coloured tracebacks just for that
-run and resets the configuration afterwards.
+Running `python cli.py --traceback` enables coloured tracebacks for that
+session. The `cli_session` context manager restores configuration afterwards.
 
 #### 3. Full-featured multi-command CLI
 
@@ -187,9 +189,10 @@ run and resets the configuration afterwards.
 from __future__ import annotations
 
 import json
+import sys
 from dataclasses import dataclass
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import SignalSpec, cli_session, default_signal_specs
 
@@ -197,21 +200,19 @@ from lib_cli_exit_tools import SignalSpec, cli_session, default_signal_specs
 @dataclass(slots=True)
 class Settings:
     pretty: bool
-    traceback: bool
 
 
 @click.group()
 @click.option("--pretty/--no-pretty", default=True)
-@click.option("--traceback", is_flag=True, help="Show full tracebacks on error")
 @click.pass_context
-def cli(ctx: click.Context, pretty: bool, traceback: bool) -> None:
-    ctx.obj = Settings(pretty=pretty, traceback=traceback)
+def cli(ctx: click.Context, pretty: bool) -> None:
+    ctx.obj = Settings(pretty=pretty)
 
 
 @cli.command()
 @click.pass_obj
 def info(settings: Settings) -> None:
-    payload = {"traceback": settings.traceback, "pretty": settings.pretty}
+    payload = {"pretty": settings.pretty}
     click.echo(json.dumps(payload, indent=2 if settings.pretty else None))
 
 
@@ -223,20 +224,24 @@ def fail(settings: Settings) -> None:
 
 
 def main() -> int:
-    overrides = {"traceback": True, "traceback_force_color": True}
+    # Parse --traceback early before entering cli_session
+    traceback = "--traceback" in sys.argv
+    argv = [arg for arg in sys.argv[1:] if arg != "--traceback"]
+
+    overrides = {"traceback": traceback, "traceback_force_color": traceback}
     signals: list[SignalSpec] = default_signal_specs()
     with cli_session(overrides=overrides) as execute:
-        return execute(cli, signal_specs=signals)
+        return execute(cli, argv=argv, signal_specs=signals)
 
 
 if __name__ == "__main__":
     raise SystemExit(main())
 ```
 
-This version wires configuration overrides, custom signal specs, and multiple
-commands into a single composition point—mirroring how a production CLI can
-layer policy logic around Click while still delegating exit-code translation to
-`lib_cli_exit_tools`.
+This version parses `--traceback` early (before Click sees it), then wires
+configuration overrides, custom signal specs, and multiple commands into a
+single composition point—mirroring how a production CLI can layer policy logic
+around Click while still delegating exit-code translation to `lib_cli_exit_tools`.
 
 #### 4. Custom signal handlers
 
@@ -251,7 +256,7 @@ import signal
 from contextlib import ExitStack
 from typing import Callable
 
-import click
+import rich_click as click
 
 from lib_cli_exit_tools import SignalSpec, default_signal_specs, run_cli
 
@@ -271,6 +276,8 @@ def custom_signal_specs() -> list[SignalSpec]:
             )
         )
     return specs
+
+
 def install_custom_signals(specs: list[SignalSpec] | None) -> Callable[[], None]:
     stack = ExitStack()
 
@@ -478,11 +485,11 @@ Compute a platform-aware exit status for arbitrary exceptions (errno mappings on
 Parameters:
 - `exc`: Exception instance to classify.
 
-### `print_exception_message(trace_back=config.traceback, length_limit=500, stream=None) -> None`
+### `print_exception_message(trace_back=None, length_limit=500, stream=None) -> None`
 Emit the active exception using Rich formatting. Produces a coloured traceback when `trace_back` is `True`, otherwise prints a truncated summary in red. Respects `config.traceback_force_color` and mirrors the behaviour of `handle_cli_exception` (tracebacks are rendered before the helper returns an exit status).
 
 Parameters:
-- `trace_back`: Toggle between full traceback rendering (`True`) and short summary (`False`).
+- `trace_back`: Toggle between full traceback rendering (`True`) and short summary (`False`). When `None` (default), uses `config.traceback`.
 - `length_limit`: Maximum characters for summary output.
 - `stream`: Target text stream; defaults to `sys.stderr`.
 
@@ -557,7 +564,8 @@ from __future__ import annotations
 
 from typing import Sequence
 
-import click
+import rich_click as click
+
 import lib_cli_exit_tools
 
 from . import __init__conf__
@@ -614,7 +622,7 @@ def main(argv: Sequence[str] | None = None) -> int:
     )
 ```
 
-When installed, the generated console scripts (`lib-cli-exit-tools`, `cli-exit-tools`, `lib_cli_exit_tools`) will import `your_package.cli:main`, and `python -m your_package` will follow the same code path via `__main__.py`.
+When installed, your package's console scripts (defined in `pyproject.toml`) will import `your_package.cli:main`, and `python -m your_package` will follow the same code path via `__main__.py`.
 
 ## Exit Codes
 
@@ -643,5 +651,4 @@ When installed, the generated console scripts (`lib-cli-exit-tools`, `cli-exit-t
 - [CONTRIBUTING](CONTRIBUTING.md)
 - [DEVELOPMENT](DEVELOPMENT.md)
 - [MODULE REFERENCE](docs/system-design/module_reference.md)
-- [AGENTS_README](AGENTS_README.md)
 - [LICENSE](LICENSE)

{lib_cli_exit_tools-2.2.2.dist-info → lib_cli_exit_tools-2.2.3.dist-info}/RECORD

@@ -1,5 +1,5 @@
 lib_cli_exit_tools/__init__.py,sha256=Z-VXcrmjZCgJZ8NW0UCVIc0HBOsjQicCbzgHj7r22eA,1867
-lib_cli_exit_tools/__init__conf__.py,sha256=to8gHcedeLf0Tg2RY3NEnAl6xIpKqPcC7vJCAaHJLZY,2521
+lib_cli_exit_tools/__init__conf__.py,sha256=rMWT8npPBLbRh_TGeLUE5O6jLN3k9eFAUBvT_6Ljt0s,2521
 lib_cli_exit_tools/__main__.py,sha256=wODJaNu_NyO7tknvlpPArq0MaDwDum8zqyb73-qshzo,257
 lib_cli_exit_tools/cli.py,sha256=k7LC08nVfse4i9RbsOGKTc9y-rrVbR1nOSKiwBvNxrE,9322
 lib_cli_exit_tools/lib_cli_exit_tools.py,sha256=-_kjKGiWyMQ715KxOqrS6uA57SXOgJmMeowU7AmtC8A,2525
@@ -11,8 +11,8 @@ lib_cli_exit_tools/application/runner.py,sha256=AlCWX5o4VTRzsCom9EgnEK0iVCIZwyId
 lib_cli_exit_tools/core/__init__.py,sha256=aR7OIBWOQ1PsA33blOTgLrq5ffKDCuaMVBS5mbrDAZ8,531
 lib_cli_exit_tools/core/configuration.py,sha256=Ro6R2cmOIFhdOUogjK1VOxEJInx24Wgme0t-ucYJGEg,5658
 lib_cli_exit_tools/core/exit_codes.py,sha256=nqx-e6h-ji-FiECPnDV8b0yrjcLPJyU-3xf4zhfRCBE,12322
-lib_cli_exit_tools-2.2.2.dist-info/METADATA,sha256=GCpsPdPf2U_RHvVKoIpDQ3ybxI321wYU2UkKxMrT3Dk,25942
-lib_cli_exit_tools-2.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-lib_cli_exit_tools-2.2.2.dist-info/entry_points.txt,sha256=8R-_3UT0KcQ7HQ7idDx6rlG77GhHb0E2N5QnN41dj-M,161
-lib_cli_exit_tools-2.2.2.dist-info/licenses/LICENSE,sha256=6s9SL2InRrwynPjJYiER7ONHBshbGj_yC5EBzfo7l9I,1072
-lib_cli_exit_tools-2.2.2.dist-info/RECORD,,
+lib_cli_exit_tools-2.2.3.dist-info/METADATA,sha256=CuuzfGer9wC2pklBQQcvX5E7-dczTetAJaxkqRUnvZM,26192
+lib_cli_exit_tools-2.2.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+lib_cli_exit_tools-2.2.3.dist-info/entry_points.txt,sha256=8R-_3UT0KcQ7HQ7idDx6rlG77GhHb0E2N5QnN41dj-M,161
+lib_cli_exit_tools-2.2.3.dist-info/licenses/LICENSE,sha256=6s9SL2InRrwynPjJYiER7ONHBshbGj_yC5EBzfo7l9I,1072
+lib_cli_exit_tools-2.2.3.dist-info/RECORD,,