usecli 0.1.63__tar.gz → 0.1.65__tar.gz

{usecli-0.1.63 → usecli-0.1.65}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usecli
-Version: 0.1.63
+Version: 0.1.65
 Summary: A powerful Python CLI framework for building beautiful, developer-friendly command-line tools.
 Author: Edward Boswell
 Author-email: Edward Boswell <thememium@gmail.com>

{usecli-0.1.63 → usecli-0.1.65}/pyproject.toml

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

@@ -15,6 +15,8 @@ if TYPE_CHECKING:
     import typer
     from rich.console import Console
 
+    from usecli.cli.config.colors import COLOR
+    from usecli.cli.config.colors import COLOR as theme
     from usecli.cli.core.base_command import BaseCommand
     from usecli.menu import Menu
     from usecli.params import Argument, Option
@@ -48,7 +50,7 @@ def __getattr__(name: str) -> Any:
         return value
 
     # Handle CLI framework components - lazy initialization
-    if name in ("app", "service", "BaseCommand", "colors", "theme"):
+    if name in ("app", "service", "BaseCommand", "colors", "COLOR", "theme"):
         _ensure_cli_initialized()
         return globals()[name]
 
@@ -191,6 +193,7 @@ def _ensure_cli_initialized() -> None:
     # Setup module aliasing
     colors = import_module("usecli.cli.config.colors")
     globals()["colors"] = colors
+    globals()["COLOR"] = COLOR
     globals()["theme"] = COLOR
     sys.modules.setdefault(__name__ + ".colors", colors)
     sys.modules.setdefault("colors", colors)
@@ -229,6 +232,7 @@ def _get_service():
 
 __all__ = [
     "BaseCommand",
+    "COLOR",
     "console",
     "Console",
     "main",

{usecli-0.1.63 → usecli-0.1.65}/src/usecli/cli/commands/defaults/base/about_command.py

@@ -85,23 +85,9 @@ def _parse_dependency_requirement(req: str) -> tuple[str, str | None]:
 def _get_console_script_distribution(command_name: str | None):
     if not command_name:
         return None
-    import importlib.metadata
+    from usecli.shared.config.manager import _find_distribution_for_console_script
 
-    try:
-        distributions = importlib.metadata.distributions()
-    except Exception:
-        return None
-    for dist in distributions:
-        try:
-            entry_points = dist.entry_points
-        except Exception:
-            continue
-        for entry_point in entry_points:
-            if entry_point.group != "console_scripts":
-                continue
-            if entry_point.name == command_name:
-                return dist
-    return None
+    return _find_distribution_for_console_script(command_name)
 
 
 def _get_package_dependencies_from_distribution(dist) -> list[tuple[str, str | None]]:

{usecli-0.1.63 → usecli-0.1.65}/src/usecli/cli/config/colors.py

@@ -175,41 +175,21 @@ def _get_command_name() -> str | None:
     return command if command else None
 
 
-_distributions_cache: list[Any] | None = None
-
-
-def _get_distributions() -> list[Any]:
-    global _distributions_cache
-    if _distributions_cache is not None:
-        return _distributions_cache
-    try:
-        import importlib.metadata
-
-        _distributions_cache = list(importlib.metadata.distributions())
-    except Exception:
-        _distributions_cache = []
-    return _distributions_cache
-
-
 def _get_console_script_aliases(command_name: str | None) -> set[str]:
-    """Get all aliases for a console script from package metadata."""
+    from usecli.shared.config.manager import _find_distribution_for_console_script
+
     if not command_name:
         return set()
     aliases: set[str] = {command_name}
-    distributions = _get_distributions()
-    for dist in distributions:
+    dist = _find_distribution_for_console_script(command_name)
+    if dist is not None:
         try:
-            entry_points = dist.entry_points
-        except Exception:
-            continue
-        names = [
-            entry_point.name
-            for entry_point in entry_points
-            if entry_point.group == "console_scripts"
-        ]
-        if command_name in names:
+            names = [
+                ep.name for ep in dist.entry_points if ep.group == "console_scripts"
+            ]
             aliases.update(names)
-            break
+        except Exception:
+            pass
     return aliases
 
 
@@ -315,36 +295,30 @@ def _find_usecli_config_in_named_package(package_name: str) -> Path | None:
 
 
 def _find_usecli_config_for_console_script() -> Path | None:
+    from usecli.shared.config.manager import _find_distribution_for_console_script
+
     command_name = os.path.basename(sys.argv[0]) if sys.argv else ""
     if not command_name:
         return None
-    distributions = _get_distributions()
-    for dist in distributions:
-        try:
-            entry_points = dist.entry_points
-        except Exception:
-            continue
-        for entry_point in entry_points:
-            if entry_point.group != "console_scripts":
-                continue
-            if entry_point.name != command_name:
-                continue
-            metadata = dist.metadata
-            dist_name = ""
-            if "Name" in metadata:
-                dist_name = metadata["Name"]
-            elif "name" in metadata:
-                dist_name = metadata["name"]
-            candidates: list[str] = []
-            if dist_name:
-                candidates.append(dist_name)
-                normalized = dist_name.replace("-", "_")
-                if normalized not in candidates:
-                    candidates.append(normalized)
-            for package_name in candidates:
-                match = _find_usecli_config_in_named_package(package_name)
-                if match:
-                    return match
+    dist = _find_distribution_for_console_script(command_name)
+    if dist is None:
+        return None
+    metadata = dist.metadata
+    dist_name = ""
+    if "Name" in metadata:
+        dist_name = metadata["Name"]
+    elif "name" in metadata:
+        dist_name = metadata["name"]
+    candidates: list[str] = []
+    if dist_name:
+        candidates.append(dist_name)
+        normalized = dist_name.replace("-", "_")
+        if normalized not in candidates:
+            candidates.append(normalized)
+    for package_name in candidates:
+        match = _find_usecli_config_in_named_package(package_name)
+        if match:
+            return match
     return None
 
 

{usecli-0.1.63 → usecli-0.1.65}/src/usecli/shared/config/manager.py

@@ -164,6 +164,49 @@ def _reset_distributions_cache() -> None:
     _distributions_cache = None
 
 
+def _find_distribution_for_console_script(
+    command_name: str,
+) -> Any | None:
+    """Find the distribution that owns a console_script by name.
+
+    Uses targeted O(1) lookups before falling back to a full O(N) scan.
+    """
+    if not command_name:
+        return None
+
+    metadata = _get_importlib_metadata()
+
+    # Fast path 1: command name directly (e.g. 'gitgepa' → 'git-gepa')
+    try:
+        dist = metadata.distribution(command_name)
+        for ep in dist.entry_points:
+            if ep.group == "console_scripts" and ep.name == command_name:
+                return dist
+    except Exception:
+        pass
+
+    # Fast path 2: current package name (e.g. 'usecli')
+    package_name = _get_package_name()
+    if package_name and package_name != command_name:
+        try:
+            dist = metadata.distribution(package_name)
+            for ep in dist.entry_points:
+                if ep.group == "console_scripts" and ep.name == command_name:
+                    return dist
+        except Exception:
+            pass
+
+    # Slow path: scan all distributions
+    for dist in _get_distributions():
+        try:
+            for ep in dist.entry_points:
+                if ep.group == "console_scripts" and ep.name == command_name:
+                    return dist
+        except Exception:
+            continue
+    return None
+
+
 def _deep_merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
     result = base.copy()
     for key, value in override.items():
@@ -543,41 +586,33 @@ class ConfigManager:
         command_name = os.path.basename(sys.argv[0]) if sys.argv else ""
         if not command_name:
             return None
-        distributions = _get_distributions()
-        for dist in distributions:
-            try:
-                entry_points = dist.entry_points
-            except Exception:
-                continue
-            for entry_point in entry_points:
-                if entry_point.group != "console_scripts":
-                    continue
-                if entry_point.name != command_name:
-                    continue
-                metadata = dist.metadata
-                dist_name = ""
-                if "Name" in metadata:
-                    dist_name = metadata["Name"]
-                elif "name" in metadata:
-                    dist_name = metadata["name"]
-                candidates = []
-                if dist_name:
-                    candidates.append(dist_name)
-                    normalized = dist_name.replace("-", "_")
-                    if normalized not in candidates:
-                        candidates.append(normalized)
-                aliases = cls._get_console_script_aliases(command_name)
-                for package_name in candidates:
-                    source_root = cls._resolve_editable_source_root(dist)
-                    if source_root:
-                        source_config = cls._search_source_for_config(
-                            source_root, command_name, aliases
-                        )
-                        if source_config:
-                            return source_config
-                    match = cls._find_usecli_config_in_named_package(package_name)
-                    if match:
-                        return match
+        dist = _find_distribution_for_console_script(command_name)
+        if dist is None:
+            return None
+        metadata = dist.metadata
+        dist_name = ""
+        if "Name" in metadata:
+            dist_name = metadata["Name"]
+        elif "name" in metadata:
+            dist_name = metadata["name"]
+        candidates = []
+        if dist_name:
+            candidates.append(dist_name)
+            normalized = dist_name.replace("-", "_")
+            if normalized not in candidates:
+                candidates.append(normalized)
+        aliases = cls._get_console_script_aliases(command_name)
+        for package_name in candidates:
+            source_root = cls._resolve_editable_source_root(dist)
+            if source_root:
+                source_config = cls._search_source_for_config(
+                    source_root, command_name, aliases
+                )
+                if source_config:
+                    return source_config
+            match = cls._find_usecli_config_in_named_package(package_name)
+            if match:
+                return match
         return None
 
     @staticmethod
@@ -651,20 +686,15 @@ class ConfigManager:
         if not command_name:
             return set()
         aliases: set[str] = {command_name}
-        distributions = _get_distributions()
-        for dist in distributions:
+        dist = _find_distribution_for_console_script(command_name)
+        if dist is not None:
             try:
-                entry_points = dist.entry_points
-            except Exception:
-                continue
-            names = [
-                entry_point.name
-                for entry_point in entry_points
-                if entry_point.group == "console_scripts"
-            ]
-            if command_name in names:
+                names = [
+                    ep.name for ep in dist.entry_points if ep.group == "console_scripts"
+                ]
                 aliases.update(names)
-                break
+            except Exception:
+                pass
         return aliases
 
     @staticmethod
@@ -953,22 +983,37 @@ def reset_config() -> None:
     global _config_manager, _config_cwd
     _config_manager = None
     _config_cwd = None
+    _config_search_cache.clear()
+    _project_root_cache.clear()
+
+
+def _reset_project_root_cache() -> None:
+    _project_root_cache.clear()
+
+
+_project_root_cache: dict[str, Path | None] = {}
 
 
 def find_project_root(start_dir: Path | None = None) -> Path | None:
     if start_dir is None:
         start_dir = _get_path().cwd()
 
+    cache_key = str(start_dir.resolve())
+    if cache_key in _project_root_cache:
+        return _project_root_cache[cache_key]
+
     current = start_dir.resolve()
 
     git_root: Path | None = None
     while True:
         pyproject_path = current / PYPROJECT_TOML
         if pyproject_path.exists():
+            _project_root_cache[cache_key] = current
             return current
 
         usecli_path = current / USECLI_CONFIG_TOML
         if usecli_path.exists():
+            _project_root_cache[cache_key] = current
             return current
 
         git_dir = current / ".git"
@@ -986,16 +1031,19 @@ def find_project_root(start_dir: Path | None = None) -> Path | None:
     # Skip expensive recursive search when search root is a high-level directory.
     # Global tools running from HOME or / will never find a project config this way.
     if str(search_root) in _get_high_level_dirs():
+        _project_root_cache[cache_key] = git_root
         return git_root
 
     # Try fast lookups before expensive rglob (perf: global tools).
     console_match = ConfigManager._find_usecli_config_for_console_script()
     if console_match:
+        _project_root_cache[cache_key] = console_match.parent
         return console_match.parent
 
     if ConfigManager._is_within_usecli_package(start_dir):
         package_match = ConfigManager._find_usecli_config_in_package()
         if package_match:
+            _project_root_cache[cache_key] = package_match.parent
             return package_match.parent
 
     config_match = ConfigManager._find_usecli_config_in_tree(
@@ -1004,8 +1052,10 @@ def find_project_root(start_dir: Path | None = None) -> Path | None:
         skip_venv=True,
     )
     if config_match:
+        _project_root_cache[cache_key] = config_match.parent
         return config_match.parent
 
+    _project_root_cache[cache_key] = git_root
     return git_root