kapsel-cli 0.3.6__tar.gz → 0.3.8__tar.gz

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kapsel-cli
-Version: 0.3.6
+Version: 0.3.8
 Summary: Next-generation cross-platform terminal capsule & ergonomic shell multiplexer with context-aware command translation and 1,000+ CLI completions.
 Author-email: MrEiu <k648888@vip.qq.com>
 License: MIT

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/kapsel/__init__.py

@@ -3,4 +3,4 @@ Kapsel: Cross-platform adaptive smart terminal capsule.
 Wrap complexity, expose simplicity.
 """
 
-__version__ = "0.3.6"
+__version__ = "0.3.8"

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/kapsel/completion/kps/builtins/add.py

@@ -9,93 +9,72 @@ import importlib.util
 from pathlib import Path
 import shutil
 import sys
-from typing import List, Optional
+from typing import List, Optional, Tuple
 from rich.console import Console
 from rich.panel import Panel
+from rich.table import Table
 
 from kapsel.storage.config import get_kapsel_dir, load_config, update_config_value
 from kapsel.ui.banner import ensure_utf8_io
 
 
-def handle_add_command(args: List[str], console: Optional[Console] = None) -> int:
+def _install_single_plugin(
+    target_raw: str,
+    con: Console,
+    is_dev: bool = False,
+    is_batch: bool = False,
+) -> Tuple[bool, str]:
     """
-    Handles 'kapsel add <plugin_name>' system command.
-    Enables local plugins, triggers their standalone install.py, and registers them into config.yaml.
+    Installs a single plugin by name or path:
+    1. Resolves source directory (dev local, user global, or remote fetch).
+    2. Copies to user global plugins directory.
+    3. Adds to config.yaml enabled plugins list.
+    4. Triggers standalone install.py if present.
+    Returns (success: bool, message: str).
     """
-    ensure_utf8_io()
-    con = console or Console(legacy_windows=False)
-
-    if not args:
-        con.print("[bold #f43f5e]Error:[/] Please specify a plugin name to add.")
-        con.print("[dim]Usage: kapsel add <plugin_name> (e.g. kapsel add install)[/]\n")
-        return 1
-
-    target_raw = args[0].strip()
-
-    # Handle 'kapsel add update' to scan and refresh catalog subcommands dictionary
-    if target_raw.lower() == "update":
-        from kapsel.core.plugin.catalog import update_plugin_catalog, render_catalog_table
-        con.print("[bold #00f0ff]🔄 Scanning repository plugins and updating catalog dictionary...[/]")
-        updated_catalog = update_plugin_catalog(con)
-        render_catalog_table(updated_catalog, con)
-        con.print("[bold #10b981]✔ Plugin catalog and subcommands completion dictionary successfully updated![/]\n")
-        return 0
-
-    cfg = load_config()
-    is_dev = getattr(cfg, "is_dev", False)
-
-    source_path = Path(target_raw).expanduser()
-
     global_plugins_dir = get_kapsel_dir() / "plugins"
     global_plugins_dir.mkdir(parents=True, exist_ok=True)
 
-    # Determine plugin ID and source:
-    # In release mode, bare names like 'install' will never be hijacked by local folders.
-    # Only treat as a local directory if explicit path syntax is used (./, ../, /, \) or in dev mode.
+    source_path = Path(target_raw).expanduser()
     has_path_qualifier = any(sep in target_raw for sep in ("/", "\\")) or target_raw.startswith(".")
 
     if (has_path_qualifier or is_dev) and source_path.exists() and source_path.is_dir():
-        # User specified an explicit directory path (or in dev mode where local directory takes priority)
         target_name = source_path.name.lower()
         dest_plugin_dir = global_plugins_dir / target_name
 
-        # Verify source has __init__.py
         if not (source_path / "__init__.py").exists():
-            con.print(f"[bold #f43f5e]Error:[/] Source directory '{source_path}' does not contain '__init__.py'.")
-            return 1
+            err = f"Source directory '{source_path}' does not contain '__init__.py'."
+            con.print(f"[bold #f43f5e]Error:[/] {err}")
+            return False, err
 
-        # Install / sync to user global plugin directory
         shutil.copytree(source_path, dest_plugin_dir, dirs_exist_ok=True)
         plugin_dir = dest_plugin_dir
-
     else:
-        # User specified a plugin name (e.g. kapsel add install)
         target_name = target_raw.lower()
         dest_plugin_dir = global_plugins_dir / target_name
         dev_plugin_dir = Path.cwd() / "plugins" / target_name
 
         if is_dev and dev_plugin_dir.exists() and dev_plugin_dir.is_dir() and (dev_plugin_dir / "__init__.py").exists():
-            # If present in local dev directory (dev mode only), sync to global user directory
             shutil.copytree(dev_plugin_dir, dest_plugin_dir, dirs_exist_ok=True)
             plugin_dir = dest_plugin_dir
         elif dest_plugin_dir.exists() and dest_plugin_dir.is_dir():
             plugin_dir = dest_plugin_dir
         else:
-            # 3. Not found locally: Automatically fetch from official remote repository
             from kapsel.core.plugin.fetcher import fetch_plugin_from_remote
-
             if fetch_plugin_from_remote(target_name, dest_plugin_dir, con):
                 plugin_dir = dest_plugin_dir
             else:
-                con.print(f"[bold #f43f5e]Error:[/] Plugin '[white]{target_name}[/]' could not be installed.")
-                con.print(f"[dim]Expected location:[/] {dest_plugin_dir}")
-                con.print("[dim]To install a custom plugin, specify its local path or place it into your global plugins directory.[/]\n")
-                return 1
+                err = f"Plugin '{target_name}' could not be installed."
+                con.print(f"[bold #f43f5e]Error:[/] {err}")
+                if not is_batch:
+                    con.print(f"[dim]Expected location:[/] {dest_plugin_dir}")
+                    con.print("[dim]To install a custom plugin, specify its local path or place it into your global plugins directory.[/]\n")
+                return False, err
 
-    # Verify that the final plugin directory contains __init__.py
     if not (plugin_dir / "__init__.py").exists():
-        con.print(f"[bold #f43f5e]Error:[/] Plugin directory '{plugin_dir}' does not contain a valid '__init__.py'.")
-        return 1
+        err = f"Plugin directory '{plugin_dir}' does not contain a valid '__init__.py'."
+        con.print(f"[bold #f43f5e]Error:[/] {err}")
+        return False, err
 
     # Add to config.yaml enabled plugins list
     cfg = load_config()
@@ -105,7 +84,6 @@ def handle_add_command(args: List[str], console: Optional[Console] = None) -> in
         update_config_value("plugins", "enabled", new_enabled)
 
     # Decoupled plugin dependency installation:
-    # Trigger standalone install.py if provided by the plugin
     install_script = plugin_dir / "install.py"
     if install_script.exists():
         try:
@@ -132,6 +110,109 @@ def handle_add_command(args: List[str], console: Optional[Console] = None) -> in
 
     msg = f"[bold #10b981]✔ Plugin '[#00f0ff]{target_name}[/]' (v{ver}) successfully added and enabled![/]\n\n"
     msg += f"[dim]Location: {plugin_dir}[/]"
+    return True, msg
+
+
+def _handle_add_all(con: Console, is_dev: bool = False) -> int:
+    """
+    Sequentially installs and runs installation scripts for all official Kapsel plugins.
+    """
+    from kapsel.core.plugin.catalog import load_plugin_catalog_rich, DEFAULT_CATALOG
+    catalog = load_plugin_catalog_rich()
+    if not catalog:
+        catalog = {k: {"description": v} for k, v in DEFAULT_CATALOG.items()}
+
+    plugin_names = set()
+    for k in catalog.keys():
+        if k not in ("update", "all") and not k.startswith(("_", "$")):
+            plugin_names.add(k)
+
+    dev_plugins_dir = Path.cwd() / "plugins"
+    if is_dev and dev_plugins_dir.is_dir():
+        for item in dev_plugins_dir.iterdir():
+            if item.is_dir() and (item / "__init__.py").exists():
+                if item.name.lower() not in ("update", "all"):
+                    plugin_names.add(item.name.lower())
+
+    ordered_plugins = sorted(plugin_names)
+    total = len(ordered_plugins)
+
+    con.print(f"\n[bold #00f0ff]============================================================[/]")
+    con.print(f"[bold #00f0ff]   📦 Kapsel Batch Plugin Installer: {total} Plugins Found   [/]")
+    con.print(f"[bold #00f0ff]============================================================[/]\n")
+
+    succeeded: List[str] = []
+    failed: List[str] = []
+
+    for idx, name in enumerate(ordered_plugins, 1):
+        con.print(f"[bold #00f0ff]━━━ [{idx}/{total}] Adding & Installing Plugin: [white]{name}[/] ━━━[/]")
+        try:
+            ok, msg = _install_single_plugin(name, con, is_dev=is_dev, is_batch=True)
+            if ok:
+                succeeded.append(name)
+                con.print(f"  [bold #10b981]✔ Added & configured successfully[/]\n")
+            else:
+                failed.append(name)
+                con.print(f"  [bold #f43f5e]✘ Installation failed[/]\n")
+        except Exception as e:
+            failed.append(name)
+            con.print(f"  [bold #f43f5e]✘ Unexpected error during '{name}' install:[/] {e}\n")
+
+    # Summary table
+    table = Table(title="[bold #00f0ff]📊 Batch Installation Summary[/]", border_style="#0891b2")
+    table.add_column("Plugin", style="#00f0ff")
+    table.add_column("Status", style="white")
+
+    for name in ordered_plugins:
+        if name in succeeded:
+            table.add_row(name, "[bold #10b981]✔ Installed & Enabled[/]")
+        else:
+            table.add_row(name, "[bold #f43f5e]✘ Failed[/]")
+
+    con.print(table)
+    summary_color = "#10b981" if not failed else "#f59e0b"
+    con.print(f"\n[{summary_color}]Batch Completed:[/] [white]{len(succeeded)} succeeded[/], "
+              f"[{'#f43f5e' if failed else 'white'}]{len(failed)} failed[/].\n")
+    return 0 if succeeded else 1
+
+
+def handle_add_command(args: List[str], console: Optional[Console] = None) -> int:
+    """
+    Handles 'kapsel add <plugin_name>' system command.
+    Enables local plugins, triggers their standalone install.py, and registers them into config.yaml.
+    Supports 'kapsel add all' to sequentially install all available plugins.
+    """
+    ensure_utf8_io()
+    con = console or Console(legacy_windows=False)
+
+    if not args:
+        con.print("[bold #f43f5e]Error:[/] Please specify a plugin name to add.")
+        con.print("[dim]Usage: kapsel add <plugin_name> | all | update (e.g. kapsel add all)[/]\n")
+        return 1
+
+    target_raw = args[0].strip()
+
+    # Handle 'kapsel add update' to scan and refresh catalog subcommands dictionary
+    if target_raw.lower() == "update":
+        from kapsel.core.plugin.catalog import update_plugin_catalog, render_catalog_table
+        con.print("[bold #00f0ff]🔄 Scanning repository plugins and updating catalog dictionary...[/]")
+        updated_catalog = update_plugin_catalog(con)
+        render_catalog_table(updated_catalog, con)
+        con.print("[bold #10b981]✔ Plugin catalog and subcommands completion dictionary successfully updated![/]\n")
+        return 0
+
+    cfg = load_config()
+    is_dev = getattr(cfg, "is_dev", False)
+
+    # Handle 'kapsel add all' to sequentially install all available plugins
+    if target_raw.lower() == "all":
+        return _handle_add_all(con, is_dev=is_dev)
+
+    # Handle single plugin installation
+    success, msg = _install_single_plugin(target_raw, con, is_dev=is_dev, is_batch=False)
+    if success:
+        con.print(Panel(msg, title="[bold #00f0ff]🔌 Plugin System[/]", border_style="#0891b2", expand=False))
+        return 0
+    else:
+        return 1
 
-    con.print(Panel(msg, title="[bold #00f0ff]🔌 Plugin System[/]", border_style="#0891b2", expand=False))
-    return 0

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/kapsel/completion/kps/builtins/upgrade.py

@@ -46,9 +46,11 @@ OFFICIAL_PLUGINS_CATALOG_URL = "https://raw.githubusercontent.com/MrEiu/plugins/
 OFFICIAL_PLUGINS_CATALOG_MIRROR_URL = "https://ghproxy.net/https://raw.githubusercontent.com/MrEiu/plugins/master/catalog.json"
 
 
-def _parse_semver(ver_str: str) -> Tuple[int, ...]:
+def _parse_semver(ver_str: Optional[str]) -> Tuple[int, ...]:
     """Parses a semver version string into an integer tuple for accurate comparison."""
-    clean = re.sub(r"^[vV]", "", ver_str.strip())
+    if not ver_str:
+        return (0, 0, 0)
+    clean = re.sub(r"^[vV]", "", str(ver_str).strip())
     parts = []
     for part in clean.split("."):
         num_m = re.match(r"^(\d+)", part)
@@ -128,11 +130,11 @@ def check_kapsel_core_update() -> Dict[str, Any]:
     # 1. Try GitHub Releases API first (provides rich release notes)
     gh_data = _fetch_url_json([KAPSEL_GITHUB_RELEASE_API, KAPSEL_GITHUB_RELEASE_MIRROR_API])
     if gh_data and "tag_name" in gh_data:
-        latest_tag = gh_data["tag_name"]
-        latest_ver = re.sub(r"^[vV]", "", latest_tag)
+        latest_tag = gh_data.get("tag_name") or ""
+        latest_ver = re.sub(r"^[vV]", "", str(latest_tag).strip())
         res["latest"] = latest_ver
-        res["notes"] = gh_data.get("body", "").strip()
-        res["published_at"] = gh_data.get("published_at", "")[:10]
+        res["notes"] = (gh_data.get("body") or "").strip()
+        res["published_at"] = (gh_data.get("published_at") or "")[:10]
         if _parse_semver(latest_ver) > _parse_semver(CURRENT_KAPSEL_VERSION):
             res["has_update"] = True
             return res
@@ -140,11 +142,11 @@ def check_kapsel_core_update() -> Dict[str, Any]:
     # 2. Fallback to PyPI JSON API
     pypi_data = _fetch_url_json([KAPSEL_PYPI_JSON_API, KAPSEL_PYPI_MIRROR_JSON_API])
     if pypi_data and "info" in pypi_data:
-        info = pypi_data["info"]
-        latest_ver = info.get("version", CURRENT_KAPSEL_VERSION)
+        info = pypi_data.get("info") or {}
+        latest_ver = info.get("version") or CURRENT_KAPSEL_VERSION
         res["latest"] = latest_ver
         if not res["notes"]:
-            res["notes"] = info.get("summary", "")
+            res["notes"] = (info.get("summary") or "").strip()
         if _parse_semver(latest_ver) > _parse_semver(CURRENT_KAPSEL_VERSION):
             res["has_update"] = True
             return res

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/kapsel/completion/spec_manager.py

@@ -79,6 +79,7 @@ CORE_SYSTEM_COMMANDS: List[Dict[str, Any]] = [
         "name": "add",
         "description": "Enable and register a plugin into Kapsel environment",
         "commands": [
+            {"name": "all", "description": "Install and enable all official Kapsel plugins sequentially"},
             {"name": "update", "description": "Scan plugins and update completion dictionary"},
         ],
     },
@@ -420,10 +421,11 @@ class CarapaceSpecManager:
             from kapsel.core.plugin.catalog import load_plugin_catalog
             catalog = load_plugin_catalog()
             add_subcmds: List[Dict[str, Any]] = [
-                {"name": "update", "description": "Scan plugins and update completion dictionary"}
+                {"name": "all", "description": "Install and enable all official Kapsel plugins sequentially"},
+                {"name": "update", "description": "Scan plugins and update completion dictionary"},
             ]
             for p_name, p_desc in sorted(catalog.items()):
-                if p_name != "update":
+                if p_name not in ("update", "all"):
                     add_subcmds.append({"name": p_name, "description": p_desc})
             for d_name, d_info in sorted(discovered_specs.items()):
                 if not any(c["name"] == d_name for c in add_subcmds):
@@ -431,7 +433,7 @@ class CarapaceSpecManager:
                         "name": d_name,
                         "description": d_info.description or f"Kapsel {d_name} extension",
                     })
-            plugin_subcmds = [c for c in add_subcmds if c["name"] != "update"]
+            plugin_subcmds = [c for c in add_subcmds if c["name"] not in ("update", "all")]
             for cmd_entry in kapsel_commands:
                 if cmd_entry["name"] == "add":
                     cmd_entry["commands"] = add_subcmds

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/kapsel_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kapsel-cli
-Version: 0.3.6
+Version: 0.3.8
 Summary: Next-generation cross-platform terminal capsule & ergonomic shell multiplexer with context-aware command translation and 1,000+ CLI completions.
 Author-email: MrEiu <k648888@vip.qq.com>
 License: MIT

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kapsel-cli"
-version = "0.3.6"
+version = "0.3.8"
 description = "Next-generation cross-platform terminal capsule & ergonomic shell multiplexer with context-aware command translation and 1,000+ CLI completions."
 readme = "README.md"
 requires-python = ">=3.9"

{kapsel_cli-0.3.6 → kapsel_cli-0.3.8}/tests/test_plugin_fetcher.py

@@ -40,3 +40,13 @@ def test_kps_add_calls_remote_fetcher_when_missing():
         ret = handle_add_command(["nonexistent_plugin_xyz"])
         assert ret == 1
         assert mock_fetch.called
+
+
+def test_kapsel_add_all_batch():
+    """Verifies that 'kapsel add all' invokes batch installation sequentially."""
+    with patch("kapsel.completion.kps.builtins.add._install_single_plugin") as mock_single_install:
+        mock_single_install.return_value = (True, "Installed")
+        ret = handle_add_command(["all"])
+        assert ret == 0
+        assert mock_single_install.call_count >= 10
+