usecli 0.1.76__tar.gz → 0.1.77__tar.gz

{usecli-0.1.76 → usecli-0.1.77}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usecli
-Version: 0.1.76
+Version: 0.1.77
 Summary: A powerful Python CLI framework for building beautiful, developer-friendly command-line tools.
 Author: Edward Boswell
 Author-email: Edward Boswell <thememium@gmail.com>
@@ -10,14 +10,14 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 Requires-Dist: case-converter>=1.2.0
-Requires-Dist: click>=8.3.1
-Requires-Dist: fzf-bin>=0.67.0
+Requires-Dist: click>=8.4.2
+Requires-Dist: fzf-bin>=0.74.1
 Requires-Dist: jinja2>=3.1.6
 Requires-Dist: pyfiglet>=1.0.4
-Requires-Dist: rich>=14.3.1
+Requires-Dist: rich>=15.0.0
 Requires-Dist: simple-term-menu>=1.6.6
-Requires-Dist: tomli>=2.4.0
-Requires-Dist: typer>=0.21.1
+Requires-Dist: tomli>=2.4.1
+Requires-Dist: typer>=0.27.0
 Requires-Python: >=3.10
 Project-URL: Homepage, https://github.com/thememium/usecli
 Project-URL: Documentation, https://github.com/thememium/usecli
@@ -163,7 +163,7 @@ Space-separated signatures create nested subcommands:
 
 ```python
 def signature(self) -> str:
-    return "spec show"   # usecli spec show
+    return "spec show"  # usecli spec show
 ```
 
 ### JSON Output

{usecli-0.1.76 → usecli-0.1.77}/README.md

@@ -135,7 +135,7 @@ Space-separated signatures create nested subcommands:
 
 ```python
 def signature(self) -> str:
-    return "spec show"   # usecli spec show
+    return "spec show"  # usecli spec show
 ```
 
 ### JSON Output

{usecli-0.1.76 → usecli-0.1.77}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "usecli"
-version = "0.1.76"
+version = "0.1.77"
 description = "A powerful Python CLI framework for building beautiful, developer-friendly command-line tools."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -11,14 +11,14 @@ classifiers = [
 ]
 dependencies = [
     "case-converter>=1.2.0",
-    "click>=8.3.1",
-    "fzf-bin>=0.67.0",
+    "click>=8.4.2",
+    "fzf-bin>=0.74.1",
     "jinja2>=3.1.6",
     "pyfiglet>=1.0.4",
-    "rich>=14.3.1",
+    "rich>=15.0.0",
     "simple-term-menu>=1.6.6",
-    "tomli>=2.4.0",
-    "typer>=0.21.1",
+    "tomli>=2.4.1",
+    "typer>=0.27.0",
 ]
 license = "MIT"
 license-files = ["LICEN[CS]E*"]
@@ -36,6 +36,7 @@ Changelog = "https://github.com/thememium/usecli/blob/master/CHANGELOG.md"
 
 [project.scripts]
 usecli = "usecli:main"
+INVALID = "usecli:main"
 
 [build-system]
 requires = ["uv_build>=0.10.2,<0.11.0"]
@@ -43,13 +44,13 @@ build-backend = "uv_build"
 
 [dependency-groups]
 dev = [
-    "deptry>=0.24.0",
-    "isort>=7.0.0",
-    "poethepoet>=0.41.0",
-    "pytest>=9.0.2",
+    "deptry>=0.25.1",
+    "isort>=8.0.1",
+    "poethepoet>=0.48.0",
+    "pytest>=9.1.1",
     "pytest-cov>=7.1.0",
-    "ruff>=0.15.1",
-    "ty>=0.0.17",
+    "ruff>=0.16.1",
+    "ty>=0.0.65",
 ]
 
 [tool.deptry]
@@ -75,6 +76,9 @@ typecheck = "uv run ty check"
 build = "uv build --no-sources"
 release = "bash scripts/release.sh"
 
+[tool.ty.environment]
+python-version = "3.12"
+
 [tool.ty.src]
 include = [
     "src",
@@ -90,3 +94,9 @@ exclude = [
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["cli*"]
+
+[tool.setuptools.package-data]
+cli = [
+    "**/*.toml",
+    "**/*.j2",
+]

{usecli-0.1.76 → usecli-0.1.77}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "usecli"
-version = "0.1.76"
+version = "0.1.77"
 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" }]
@@ -12,14 +12,14 @@ classifiers = [
 ]
 dependencies = [
   "case-converter>=1.2.0",
-  "click>=8.3.1",
-  "fzf-bin>=0.67.0",
+  "click>=8.4.2",
+  "fzf-bin>=0.74.1",
   "jinja2>=3.1.6",
   "pyfiglet>=1.0.4",
-  "rich>=14.3.1",
+  "rich>=15.0.0",
   "simple-term-menu>=1.6.6",
-  "tomli>=2.4.0",
-  "typer>=0.21.1",
+  "tomli>=2.4.1",
+  "typer>=0.27.0",
 ]
 license = "MIT"
 license-files = ["LICEN[CS]E*"]
@@ -33,6 +33,7 @@ Changelog = "https://github.com/thememium/usecli/blob/master/CHANGELOG.md"
 
 [project.scripts]
 usecli = "usecli:main"
+INVALID = "usecli:main"
 
 [build-system]
 requires = ["uv_build>=0.10.2,<0.11.0"]
@@ -40,13 +41,13 @@ build-backend = "uv_build"
 
 [dependency-groups]
 dev = [
-  "deptry>=0.24.0",
-  "isort>=7.0.0",
-  "poethepoet>=0.41.0",
-  "pytest>=9.0.2",
+  "deptry>=0.25.1",
+  "isort>=8.0.1",
+  "poethepoet>=0.48.0",
+  "pytest>=9.1.1",
   "pytest-cov>=7.1.0",
-  "ruff>=0.15.1",
-  "ty>=0.0.17",
+  "ruff>=0.16.1",
+  "ty>=0.0.65",
 ]
 
 [tool.deptry]
@@ -74,6 +75,9 @@ release = "bash scripts/release.sh"
 
 [tool.ty]
 
+[tool.ty.environment]
+python-version = "3.12"
+
 [tool.ty.src]
 include = ["src", "tests"]
 exclude = ["**/__pycache__", "**/.venv"]
@@ -85,3 +89,7 @@ exclude = ["**/__pycache__", "**/.venv"]
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["cli*"]
+
+[tool.setuptools.package-data]
+cli = ["**/*.toml", "**/*.j2"]
+

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/__init__.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 import sys
 from importlib import import_module
 
+from click import Command as _ClickCommand
+
 # Avoid importing typing at module level (costs ~6ms)
 # TYPE_CHECKING is False at runtime, so the if-block never executes
 TYPE_CHECKING = False
@@ -84,11 +86,14 @@ def _ensure_cli_initialized() -> None:
     from usecli.cli.services.command_service import CommandService
 
     # Store exceptions for error handling
+    # Typer vendors click internally and raises its own exception types.
+    # We import them dynamically since typer._click has no type stubs.
     try:
-        from typer._click.exceptions import BadParameter as TyperBadParameter  # type: ignore[import-untyped]
-        from typer._click.exceptions import ClickException as TyperClickException  # type: ignore[import-untyped]
-        from typer._click.exceptions import UsageError as TyperUsageError  # type: ignore[import-untyped]
-    except ImportError:
+        _typer_exceptions = import_module("typer._click.exceptions")
+        TyperBadParameter: Any = _typer_exceptions.BadParameter
+        TyperClickException: Any = _typer_exceptions.ClickException
+        TyperUsageError: Any = _typer_exceptions.UsageError
+    except (ImportError, AttributeError):
         TyperBadParameter = BadParameter
         TyperClickException = ClickException
         TyperUsageError = UsageError
@@ -138,7 +143,7 @@ def _ensure_cli_initialized() -> None:
                 return None
 
             if cmd_name in matches:
-                if (
+                if (  # pragma: no cover - unreachable duplicate of the branch above
                     cmd_name in group_alias_to_primary
                     and group_alias_to_primary[cmd_name] != cmd_name
                 ):
@@ -252,7 +257,14 @@ def _ensure_cli_initialized() -> None:
                         write_document(success_document())
                         return None
                     fail("Exit", f"Command exited with status {code}", code)
-                except Exception as error:
+                except (
+                    OSError,
+                    RuntimeError,
+                    ValueError,
+                    TypeError,
+                    AttributeError,
+                    KeyError,
+                ) as error:
                     print(
                         f"{error.__class__.__name__}: {error}",
                         file=sys.stderr,
@@ -340,19 +352,19 @@ def _get_service():
 
 
 __all__ = [
-    "BaseCommand",
     "COLOR",
-    "console",
+    "Argument",
+    "BaseCommand",
+    "Confirm",
     "Console",
-    "main",
     "Menu",
-    "Argument",
     "Option",
+    "ProgressBar",
     "Prompt",
-    "Confirm",
     "Spinner",
-    "ProgressBar",
     "colors",
+    "console",
+    "main",
     "theme",
 ]
 
@@ -432,32 +444,40 @@ def _build_alias_to_primary(alias_registry: dict[str, list[str]]) -> dict[str, s
 PrefixMatchingGroup = None
 
 
-class _FilteredListCommand:
+class _FilteredListCommand(_ClickCommand):
     """Command that displays a filtered list of commands."""
 
     def __init__(self, prefix_filter: str) -> None:
+        super().__init__(
+            name="filtered-list",
+            context_settings={},
+            params=[],
+            callback=None,
+            help=None,
+            epilog=None,
+            short_help=None,
+            no_args_is_help=False,
+            hidden=False,
+            deprecated=False,
+        )
         self.prefix_filter = prefix_filter
-        self.name = "filtered-list"
         self.allow_extra_args = True
         self.allow_interspersed_args = True
         self.ignore_unknown_options = True
-        self.hidden = False
-        self.deprecated = False
-        self.params = []
-        self.callback = None
-        self.help = None
-        self.epilog = None
-        self.short_help = None
-        self.no_args_is_help = False
-        self.context_settings = {}
 
     def get_short_help_str(self, limit=45):
         return ""
 
-    def make_context(self, info_name: str, args: list[str], **kwargs: object):
+    def make_context(
+        self,
+        info_name: str | None,
+        args: list[str],
+        parent: object | None = None,
+        **extra: Any,
+    ):
         from click import Context
 
-        ctx = Context(self, info_name=info_name, **kwargs)  # type: ignore[arg-type]
+        ctx = Context(self, info_name=info_name, **extra)
         return ctx
 
     def invoke(self, ctx):
@@ -615,7 +635,14 @@ def main() -> None:
         if hasattr(e, "show"):
             e.show()
         sys.exit(e.exit_code if hasattr(e, "exit_code") else 1)
-    except Exception as e:
+    except (
+        OSError,
+        RuntimeError,
+        ValueError,
+        TypeError,
+        AttributeError,
+        KeyError,
+    ) as e:
         from usecli.cli.core.exceptions import UsecliUsageError
 
         styled_error = UsecliUsageError(str(e))

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/commands/defaults/base/about_command.py

@@ -2,6 +2,7 @@ from __future__ import annotations
 
 import os
 import sys
+from importlib.metadata import PackageNotFoundError
 from pathlib import Path
 
 from usecli.cli.config.colors import COLOR
@@ -200,7 +201,7 @@ def _get_installed_script_commands(command_name: str | None) -> list[str]:
         return []
     try:
         entry_points = dist.entry_points
-    except Exception:
+    except (AttributeError, OSError):
         return []
     script_names = [
         entry_point.name
@@ -242,9 +243,7 @@ def _get_script_commands() -> list[str]:
             return [primary_command]
         return []
 
-    script_names = [
-        name for name in scripts.keys() if isinstance(name, str) and name.strip()
-    ]
+    script_names = [name for name in scripts if isinstance(name, str) and name.strip()]
     if primary_command and primary_command not in script_names:
         return [primary_command, *script_names]
     return script_names
@@ -281,7 +280,7 @@ class AboutCommand(BaseCommand):
 
                 installed_version = get_version(dep_name)
                 dependencies.append({"name": dep_name, "version": installed_version})
-            except Exception:
+            except (PackageNotFoundError, OSError):
                 dependencies.append({"name": dep_name, "version": spec})
 
         data: dict[str, object] = {
@@ -329,7 +328,7 @@ class AboutCommand(BaseCommand):
 
                     installed_version = get_version(dep_name)
                     self._print_row(dep_name, installed_version)
-                except Exception:
+                except (PackageNotFoundError, OSError):
                     if spec:
                         self._print_row(dep_name, spec)
                     else:

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/commands/defaults/base/internal/fzf_command.py

@@ -8,7 +8,7 @@ import shutil
 import subprocess
 import sys
 from pathlib import Path
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, cast
 
 import click
 import typer
@@ -41,16 +41,18 @@ def _get_required_arguments(command: ClickCommand) -> list[tuple[str, str, type]
 
         is_required = False
 
-        if param.default is inspect.Parameter.empty:
-            is_required = True
-        elif hasattr(param.default, "default") and param.default.default is ...:
+        if (
+            param.default is inspect.Parameter.empty
+            or hasattr(param.default, "default")
+            and param.default.default is ...
+        ):
             is_required = True
 
         if is_required:
             help_text = ""
             try:
                 help_text = getattr(param.default, "help", "") or ""
-            except AttributeError:
+            except AttributeError:  # pragma: no cover - getattr supplies a default
                 pass
 
             param_type: type = param.annotation
@@ -65,14 +67,17 @@ def _get_required_arguments(command: ClickCommand) -> list[tuple[str, str, type]
 def _get_optional_options(
     command: ClickCommand | typer.models.CommandInfo,
 ) -> list[tuple[str, str, str, type]]:
-    click_command: click.Command | None
+    click_command: click.Command | None = None
     if isinstance(command, click.Command):
         click_command = command
     elif isinstance(command, typer.models.CommandInfo):
-        click_command = typer.main.get_command_from_info(
-            command,
-            pretty_exceptions_short=False,
-            rich_markup_mode=None,
+        click_command = cast(
+            click.Command,
+            typer.main.get_command_from_info(
+                command,
+                pretty_exceptions_short=False,
+                rich_markup_mode=None,
+            ),
         )
     else:
         click_command = None
@@ -137,6 +142,7 @@ def _run_fzf_menu(
             input=input_data,
             capture_output=True,
             text=True,
+            check=False,
         )
 
         if result.returncode == 130 or not result.stdout.strip():
@@ -346,6 +352,7 @@ def run_interactive(
             capture_output=True,
             text=True,
             env={**os.environ, "FORCE_COLOR": "1", "CLICOLOR_FORCE": "1"},
+            check=False,
         )
         sys.stdout.write(help_result.stdout)
 
@@ -451,7 +458,7 @@ def run_interactive(
             for selected_option in selected_options:
                 idx = menu_options.index(selected_option)
                 (
-                    param_name,
+                    _param_name,
                     option_names,
                     help_text,
                     opt_type,
@@ -520,13 +527,12 @@ def run_interactive(
     console.print(f"[bold {COLOR.WARNING}]{full_cmd}")
     console.print()
 
-    subprocess.run(full_cmd, shell=True)
+    subprocess.run(full_cmd, shell=True, check=False)
 
-    try:
-        pass
-    except KeyboardInterrupt:
-        ErrorHandler.display_warning("Cancelled by user")
-        raise typer.Exit(code=0)
+
+_EXTRA_ARGS_DEFAULT = typer.Argument(
+    None, help="Additional arguments to pass to the selected command"
+)
 
 
 class FzfCommand(BaseCommand):
@@ -542,9 +548,7 @@ class FzfCommand(BaseCommand):
 
     def handle(
         self,
-        extra_args: list[str] = typer.Argument(
-            None, help="Additional arguments to pass to the selected command"
-        ),
+        extra_args: list[str] = _EXTRA_ARGS_DEFAULT,
     ) -> None:
         """Handle the fzf command execution.
 

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/commands/defaults/core/utils.py

@@ -4,12 +4,8 @@ from __future__ import annotations
 
 import re
 import sys
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from pathlib import Path
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:
-    pass
 
 
 class _LazyConsole:
@@ -122,7 +118,7 @@ def format_relative_time(timestamp: datetime) -> str:
     Returns:
         Relative time string (e.g., "2 hours ago", "3 days ago").
     """
-    now = datetime.now()
+    now = datetime.now(tz=timezone.utc)
     diff = now - timestamp
 
     if diff < timedelta(minutes=1):

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/commands/defaults/make/make_command.py

@@ -46,9 +46,7 @@ class MakeCommand(BaseCommand):
         class_name = (
             pascalcase(clean_name.replace(":", "_").replace(" ", "_")) + "Command"
         )
-        if ":" in clean_name:
-            command_name = clean_name
-        elif " " in clean_name:
+        if ":" in clean_name or " " in clean_name:
             command_name = clean_name
         else:
             command_name = snakecase(clean_name)

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/commands/defaults/make/make_theme_command.py

@@ -48,8 +48,7 @@ class MakeThemeCommand(BaseCommand):
         themes_dir.mkdir(parents=True, exist_ok=True)
 
         base_name = Path(clean_name).name
-        if base_name.endswith(".toml"):
-            base_name = base_name[: -len(".toml")]
+        base_name = base_name.removesuffix(".toml")
         if not base_name:
             console.print(
                 f"[{COLOR.ERROR}]Error: Theme name cannot be empty.[/{COLOR.ERROR}]"

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/commands/init_command.py

@@ -19,7 +19,7 @@ from rich.prompt import Confirm, Prompt
 if sys.version_info >= (3, 11):
     import tomllib
 else:
-    import tomli as tomllib
+    import tomli as tomllib  # pragma: no cover - only on Python < 3.11
 
 import pyfiglet
 
@@ -328,6 +328,7 @@ class InitCommand(BaseCommand):
                 capture_output=True,
                 text=True,
                 cwd=cwd,
+                check=False,
             )
             if result.returncode == 0:
                 console.print(
@@ -344,6 +345,7 @@ class InitCommand(BaseCommand):
             capture_output=True,
             text=True,
             cwd=cwd,
+            check=False,
         )
         if result.returncode == 0:
             console.print(
@@ -393,8 +395,7 @@ class InitCommand(BaseCommand):
         value = value.strip()
         if not value:
             return None
-        if value.startswith("#"):
-            value = value[1:]
+        value = value.removeprefix("#")
         if len(value) == 3:
             value = "".join(ch * 2 for ch in value)
         if len(value) != 6:

{usecli-0.1.76 → usecli-0.1.77}/src/usecli/cli/config/colors.py

@@ -11,11 +11,15 @@ Usage:
 
 from __future__ import annotations
 
+import logging
 import os
 import sys
 import time
+from collections.abc import Callable
 from pathlib import Path
-from typing import Any, Callable, Final, Protocol, cast, final
+from typing import Any, Final, Protocol, cast, final
+
+logger = logging.getLogger(__name__)
 
 
 def _import_tomllib():
@@ -188,8 +192,8 @@ def _get_console_script_aliases(command_name: str | None) -> set[str]:
                 ep.name for ep in dist.entry_points if ep.group == "console_scripts"
             ]
             aliases.update(names)
-        except Exception:
-            pass
+        except (AttributeError, OSError):
+            logger.debug("Failed to read entry points for distribution %s", dist)
     return aliases
 
 
@@ -456,8 +460,7 @@ def _hex_to_rgb(value: str) -> tuple[int, int, int] | None:
     value = value.strip()
     if not value:
         return None
-    if value.startswith("#"):
-        value = value[1:]
+    value = value.removeprefix("#")
     if len(value) == 3:
         value = "".join(ch * 2 for ch in value)
     if len(value) != 6: