usecli 0.1.29__tar.gz → 0.1.30__tar.gz

{usecli-0.1.29 → usecli-0.1.30}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usecli
-Version: 0.1.29
+Version: 0.1.30
 Summary: A powerful Python CLI framework for building beautiful, developer-friendly command-line tools.
 Author: Edward Boswell
 Author-email: Edward Boswell <thememium@gmail.com>
@@ -77,12 +77,18 @@ useCli A powerful Python CLI framework for building beautiful, developer-friendl
 
 ## Quick Start
 
-### Install usecli:
+### Install usecli with uv (recommended)
 
 ```sh
 uv add usecli
 ```
 
+### Install with pip (alternative)
+
+```sh
+pip install usecli
+```
+
 ### Initialize
 
 ```sh

{usecli-0.1.29 → usecli-0.1.30}/README.md

@@ -48,12 +48,18 @@ useCli A powerful Python CLI framework for building beautiful, developer-friendl
 
 ## Quick Start
 
-### Install usecli:
+### Install usecli with uv (recommended)
 
 ```sh
 uv add usecli
 ```
 
+### Install with pip (alternative)
+
+```sh
+pip install usecli
+```
+
 ### Initialize
 
 ```sh

{usecli-0.1.29 → usecli-0.1.30}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usecli"
-version = "0.1.29"
+version = "0.1.30"
 description = "A powerful Python CLI framework for building beautiful, developer-friendly command-line tools."
 readme = "README.md"
 authors = [{ name = "Edward Boswell", email = "thememium@gmail.com" }]

{usecli-0.1.29 → usecli-0.1.30}/src/usecli/cli/core/base_command.py

@@ -12,6 +12,7 @@ from rich.console import Console
 from typer.core import TyperCommand
 
 from usecli.cli.config.colors import COLOR
+from usecli.cli.core.ui.title import get_script_command_name
 
 if TYPE_CHECKING:
     from click.core import Context as ClickContext
@@ -223,7 +224,8 @@ class CustomHelpCommand(TyperCommand):
         ]
 
         arg_usage = " ".join(rf"\[{name.upper()}]" for name in argument_names)
-        usage = f"  [bold {COLOR.WARNING}]usecli {self.name}[/bold {COLOR.WARNING}] [bold {COLOR.PRIMARY}][OPTIONS]{f' {arg_usage}' if arg_usage else ''}[/bold {COLOR.PRIMARY}]"
+        command_name = get_script_command_name(default="usecli") or "usecli"
+        usage = f"  [bold {COLOR.WARNING}]{command_name} {self.name}[/bold {COLOR.WARNING}] [bold {COLOR.PRIMARY}][OPTIONS]{f' {arg_usage}' if arg_usage else ''}[/bold {COLOR.PRIMARY}]"
 
         console.print()
         console.print(f"[bold {COLOR.SECONDARY}]Usage:[/bold {COLOR.SECONDARY}]")

{usecli-0.1.29 → usecli-0.1.30}/src/usecli/cli/core/exceptions/usage.py

@@ -5,14 +5,29 @@ from __future__ import annotations
 import sys
 from typing import IO
 
+from click.core import Context as ClickContext
 from click.exceptions import BadParameter, UsageError
 from rich.console import Console
 
 from usecli.cli.config.colors import COLOR
+from usecli.cli.core.ui.title import get_script_command_name
 
 console = Console(stderr=True)
 
 
+def _get_help_text_with_command_name(ctx: ClickContext) -> str:
+    command_name = get_script_command_name(default=getattr(ctx, "info_name", None))
+    if not command_name:
+        return ctx.get_help()
+
+    original_info_name = getattr(ctx, "info_name", None)
+    try:
+        ctx.info_name = command_name
+        return ctx.get_help()
+    finally:
+        ctx.info_name = original_info_name
+
+
 class UsecliUsageError(UsageError):
     """Usage error with styled output and full command help.
 
@@ -35,7 +50,7 @@ class UsecliUsageError(UsageError):
 
         if self.ctx:
             console.print()
-            help_text = self.ctx.get_help()
+            help_text = _get_help_text_with_command_name(self.ctx)
             console.print(help_text)
 
 
@@ -64,5 +79,5 @@ class UsecliBadParameter(BadParameter):
         console.print(f"{error_prefix} {error_msg}")
 
         if self.ctx:
-            help_text = self.ctx.get_help()
+            help_text = _get_help_text_with_command_name(self.ctx)
             console.print(help_text)