usecli 0.1.32__tar.gz → 0.1.33__tar.gz

{usecli-0.1.32 → usecli-0.1.33}/PKG-INFO

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

@@ -1,6 +1,6 @@
 [project]
 name = "usecli"
-version = "0.1.32"
+version = "0.1.33"
 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.32 → usecli-0.1.33}/src/usecli/cli/commands/init_command.py

@@ -27,7 +27,7 @@ from usecli.cli.core.base_command import BaseCommand
 from usecli.cli.core.exceptions import UsecliBadParameter
 from usecli.cli.core.validators import validate_command_name
 from usecli.cli.utils.interactive.terminal_menu import terminal_menu
-from usecli.shared.config.globals import TEMPLATES_DIR, THEMES_DIR
+from usecli.shared.config.globals import TEMPLATES_DIR, THEMES_DIR, USECLI_TOML
 from usecli.shared.config.manager import ConfigManager, get_config
 
 console = Console()
@@ -113,6 +113,23 @@ class InitCommand(BaseCommand):
         pyproject_path.write_text(content)
         return True
 
+    def _write_usecli_toml(
+        self, project_root: Path, config_content: str, force: bool
+    ) -> str:
+        config_path = project_root / USECLI_TOML
+        existed = config_path.exists()
+        if existed and not force:
+            should_overwrite = Confirm.ask(
+                f"[{COLOR.WARNING}]usecli.toml already exists at {config_path}.[/{COLOR.WARNING}]\n"
+                "Overwrite it with the new settings from this init run?",
+                default=False,
+            )
+            if not should_overwrite:
+                return "skipped"
+
+        config_path.write_text(config_content.rstrip() + "\n")
+        return "updated" if existed else "created"
+
     def _ensure_project_scripts(
         self, pyproject_path: Path, command_name: str, force: bool
     ) -> str:
@@ -685,6 +702,7 @@ include = ["{root_package}*"]
         )
 
         scripts_status: str | None = None
+        usecli_toml_status: str | None = None
 
         # Check if pyproject.toml exists
         if pyproject_path.exists():
@@ -744,6 +762,22 @@ include = ["{root_package}*"]
 
             self._sync_environment(project_root, command_name)
 
+        usecli_toml_status = self._write_usecli_toml(
+            project_root, config_content, force
+        )
+        if usecli_toml_status == "created":
+            console.print(
+                f"[{COLOR.SUCCESS}]Created {USECLI_TOML} for runtime config fallback[/{COLOR.SUCCESS}]"
+            )
+        elif usecli_toml_status == "updated":
+            console.print(
+                f"[{COLOR.SUCCESS}]Updated {USECLI_TOML} for runtime config fallback[/{COLOR.SUCCESS}]"
+            )
+        elif usecli_toml_status == "skipped":
+            console.print(
+                f"[{COLOR.WARNING}]Skipped updating {USECLI_TOML}.[/{COLOR.WARNING}]"
+            )
+
         # Show summary
         summary_command = (
             command_name

{usecli-0.1.32 → usecli-0.1.33}/src/usecli/cli/config/colors.py

@@ -21,6 +21,8 @@ else:
     import tomli as tomllib
 
 
+PYPROJECT_TOML = "pyproject.toml"
+USECLI_TOML = "usecli.toml"
 DEFAULT_THEME_NAME = "default"
 THEMES_DIR = Path(__file__).resolve().parent.parent / "themes"
 DEFAULT_THEME_COLORS: dict[str, str] = {
@@ -53,10 +55,14 @@ def _find_project_root(start_dir: Path | None = None) -> Path | None:
     current = start_dir.resolve()
 
     while True:
-        pyproject_path = current / "pyproject.toml"
+        pyproject_path = current / PYPROJECT_TOML
         if pyproject_path.exists():
             return current
 
+        usecli_path = current / USECLI_TOML
+        if usecli_path.exists():
+            return current
+
         git_dir = current / ".git"
         if git_dir.exists():
             return current
@@ -73,7 +79,7 @@ def _load_usecli_config(project_root: Path | None) -> dict[str, Any]:
     if project_root is None:
         return {}
 
-    pyproject_path = project_root / "pyproject.toml"
+    pyproject_path = project_root / PYPROJECT_TOML
     if not pyproject_path.exists():
         return {}
 

{usecli-0.1.32 → usecli-0.1.33}/src/usecli/shared/config/globals.py

@@ -17,3 +17,4 @@ THEMES_DIR = CLI_ROOT / "themes"
 
 # Config file names
 PYPROJECT_TOML = "pyproject.toml"
+USECLI_TOML = "usecli.toml"

{usecli-0.1.32 → usecli-0.1.33}/src/usecli/shared/config/manager.py

@@ -12,6 +12,7 @@ from pathlib import Path
 from typing import Any
 
 from usecli.cli.core.exceptions.config import UsecliConfigError
+from usecli.shared.config.globals import PYPROJECT_TOML, USECLI_TOML
 
 if sys.version_info >= (3, 11):
     import tomllib
@@ -87,6 +88,7 @@ class ConfigManager:
     def __init__(
         self,
         pyproject_path: Path | None = None,
+        usecli_toml_path: Path | None = None,
         start_dir: Path | None = None,
     ) -> None:
         """Initialize the configuration manager.
@@ -102,12 +104,21 @@ class ConfigManager:
 
         if pyproject_path is None:
             pyproject_path = self._find_pyproject_toml(start_dir) or (
-                start_dir / "pyproject.toml"
+                start_dir / PYPROJECT_TOML
+            )
+
+        if usecli_toml_path is None:
+            usecli_toml_path = self._find_usecli_toml(start_dir) or (
+                start_dir / USECLI_TOML
             )
 
         self.pyproject_path: Path = pyproject_path
+        self.usecli_toml_path: Path = usecli_toml_path
         self.start_dir: Path = start_dir
-        self.project_root: Path = find_project_root(start_dir) or start_dir.resolve()
+        detected_root = find_project_root(start_dir)
+        if detected_root is None and self.usecli_toml_path.exists():
+            detected_root = self.usecli_toml_path.parent
+        self.project_root: Path = (detected_root or start_dir).resolve()
         self._config: dict[str, Any] = {}
         self._overrides: dict[str, Any] = {}
         self._load_config()
@@ -117,18 +128,32 @@ class ConfigManager:
         self._config = self.DEFAULT_CONFIG.copy()
         self._overrides = {}
 
+        loaded = False
         if self.pyproject_path.exists():
             try:
                 pyproject_config = self._load_pyproject_toml(self.pyproject_path)
                 if pyproject_config:
                     self._config = _deep_merge(self._config, pyproject_config)
                     self._overrides = _deep_merge(self._overrides, pyproject_config)
+                    loaded = True
             except (tomllib.TOMLDecodeError, OSError) as e:
                 raise UsecliConfigError(
                     f"Failed to load pyproject.toml: {e}",
                     config_file=str(self.pyproject_path),
                 ) from e
 
+        if not loaded and self.usecli_toml_path.exists():
+            try:
+                usecli_config = self._load_usecli_toml(self.usecli_toml_path)
+                if usecli_config:
+                    self._config = _deep_merge(self._config, usecli_config)
+                    self._overrides = _deep_merge(self._overrides, usecli_config)
+            except (tomllib.TOMLDecodeError, OSError) as e:
+                raise UsecliConfigError(
+                    f"Failed to load usecli.toml: {e}",
+                    config_file=str(self.usecli_toml_path),
+                ) from e
+
         default_themes = _normalize_themes_dir(self.DEFAULT_CONFIG.get("themes_dir"))
         override_themes = _normalize_themes_dir(self._overrides.get("themes_dir"))
         merged_themes = _dedupe_items(default_themes + override_themes)
@@ -151,7 +176,7 @@ class ConfigManager:
         current = start_dir.resolve()
 
         while True:
-            pyproject_path = current / "pyproject.toml"
+            pyproject_path = current / PYPROJECT_TOML
             if pyproject_path.exists():
                 return pyproject_path
 
@@ -162,6 +187,38 @@ class ConfigManager:
 
         return None
 
+    @classmethod
+    def _find_usecli_toml(cls, start_dir: Path) -> Path | None:
+        current = start_dir.resolve()
+
+        while True:
+            config_path = current / USECLI_TOML
+            if config_path.exists():
+                return config_path
+
+            parent = current.parent
+            if parent == current:
+                break
+            current = parent
+
+        return cls._find_usecli_toml_on_sys_path()
+
+    @staticmethod
+    def _find_usecli_toml_on_sys_path() -> Path | None:
+        for entry in sys.path:
+            if not entry:
+                continue
+            path = Path(entry)
+            if not path.exists() or not path.is_dir():
+                continue
+            candidate = path / USECLI_TOML
+            if candidate.exists():
+                return candidate
+            for child in path.glob(f"*/{USECLI_TOML}"):
+                if child.exists():
+                    return child
+        return None
+
     @staticmethod
     def _load_pyproject_toml(path: Path) -> dict[str, Any]:
         """Load pyproject.toml and return [tool.usecli] section.
@@ -176,6 +233,23 @@ class ConfigManager:
             data = tomllib.load(f)
             return data.get("tool", {}).get("usecli", {})
 
+    @staticmethod
+    def _load_usecli_toml(path: Path) -> dict[str, Any]:
+        with open(path, "rb") as f:
+            data = tomllib.load(f)
+
+        tool_section = data.get("tool", {})
+        if isinstance(tool_section, dict):
+            usecli_section = tool_section.get("usecli", {})
+            if isinstance(usecli_section, dict):
+                return usecli_section
+
+        usecli_section = data.get("usecli", {})
+        if isinstance(usecli_section, dict):
+            return usecli_section
+
+        return {}
+
     def get(self, key: str, default: Any = None) -> Any:
         """Get a configuration value using dot notation.
 
@@ -256,9 +330,13 @@ class ConfigManager:
     @property
     def pyproject_exists(self) -> bool:
         """Check if pyproject.toml with [tool.usecli] exists."""
-        if not self.pyproject_path.exists():
-            return False
-        return self._pyproject_has_usecli(self.pyproject_path)
+        if self.pyproject_path.exists() and self._pyproject_has_usecli(
+            self.pyproject_path
+        ):
+            return True
+        if self.usecli_toml_path.exists():
+            return True
+        return False
 
     @staticmethod
     def _load_project_version(path: Path) -> str | None:
@@ -305,10 +383,14 @@ def find_project_root(start_dir: Path | None = None) -> Path | None:
     current = start_dir.resolve()
 
     while True:
-        pyproject_path = current / "pyproject.toml"
+        pyproject_path = current / PYPROJECT_TOML
         if pyproject_path.exists():
             return current
 
+        usecli_path = current / USECLI_TOML
+        if usecli_path.exists():
+            return current
+
         git_dir = current / ".git"
         if git_dir.exists():
             return current