usecli 0.1.28__tar.gz → 0.1.30__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usecli
-Version: 0.1.28
+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.28 → 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.28 → usecli-0.1.30}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usecli"
-version = "0.1.28"
+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.28 → usecli-0.1.30}/src/usecli/__init__.py

@@ -17,6 +17,7 @@ from usecli.cli.core.ui.list import list_commands
 from usecli.cli.services.command_service import CommandService
 from usecli.menu import Menu
 from usecli.params import Argument, Option
+from usecli.shared.config.manager import get_config
 from usecli.ui import Confirm, Console, Prompt, console
 
 colors = import_module("usecli.cli.config.colors")
@@ -52,6 +53,44 @@ def _is_interactive_flag_present() -> bool:
     return "-i" in sys.argv or "--interactive" in sys.argv
 
 
+def _get_cli_help_text() -> str:
+    fallback = "Usecli CLI - An elegant CLI framework for Python"
+    fallback_description = "An elegant CLI framework for Python"
+    config = get_config()
+
+    description = config.get("description")
+    has_description = (
+        config.has_key("description")
+        and isinstance(description, str)
+        and description.strip()
+    )
+
+    title = config.get("title")
+    has_title = config.has_key("title") and isinstance(title, str) and title.strip()
+
+    command_name = config.get("command_name")
+    has_command_name = (
+        config.has_key("command_name")
+        and isinstance(command_name, str)
+        and command_name.strip()
+    )
+
+    if not has_description and not has_title and not has_command_name:
+        return fallback
+
+    display_name = (
+        title.strip()
+        if has_title
+        else command_name.strip()
+        if has_command_name
+        else "Usecli CLI"
+    )
+    display_description = (
+        description.strip() if has_description else fallback_description
+    )
+    return f"{display_name} - {display_description}"
+
+
 class PrefixMatchingGroup(TyperGroup):
     """Custom Typer group that supports prefix matching for commands.
 
@@ -134,7 +173,7 @@ class FilteredListCommand(click.Command):
 
 
 app = typer.Typer(
-    help="Usecli CLI - An elegant CLI framework for Python",
+    help=_get_cli_help_text(),
     invoke_without_command=True,
     no_args_is_help=False,
     cls=PrefixMatchingGroup,

{usecli-0.1.28 → 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.28 → 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)