py-wlcli 0.8.0__py3-none-any.whl

wl_cli/commands/self/handlers/install_handler.py

@@ -0,0 +1,85 @@
+"""
+Handler for self install subcommand.
+"""
+
+import subprocess
+import sys
+
+from wl_cli.utils.logging import log_error_pair, log_info_pair
+
+from ...self.common.config import SelfConfig
+from ...self.services.installation_manager import InstallationManager
+from ...self.services.pypi_updater import PypiUpdater
+from .base_handler import BaseHandler
+
+
+class InstallHandler(BaseHandler):
+    """Handler for the install subcommand - installs specified version."""
+
+    def __init__(
+        self,
+        version: str | None,
+        uv_path: str,
+        env: dict,
+        installation_manager: InstallationManager,
+        config: SelfConfig,
+    ):
+        """
+        Initialize the install handler.
+
+        Args:
+            version: Version to install (None for latest)
+            uv_path: Path to uv executable
+            env: Environment variables
+            installation_manager: Installation manager instance
+            config: Self configuration
+        """
+        self._version = version
+        self._uv_path = uv_path
+        self._env = env
+        self._installation_manager = installation_manager
+        self._config = config
+
+    def execute(self) -> None:
+        """Execute the install subcommand."""
+        log_info_pair(
+            f"Installing wl version: {self._version or 'latest'}",
+            f"正在安装wl版本: {self._version or 'latest'}",
+        )
+
+        log_info_pair(
+            f"Using configuration: {self._config.__dict__}",
+            f"使用配置: {self._config.__dict__}",
+        )
+
+        try:
+            # Initialize environment already done by caller
+            # Install specified version
+            log_info_pair(
+                "Step 3: Installing specified version...", "步骤3: 安装指定版本..."
+            )
+            pypi_updater = PypiUpdater()
+            # Update cache timeout based on config
+            if hasattr(pypi_updater, "_cache_timeout"):
+                pypi_updater._cache_timeout = self._config.cache_timeout
+            pypi_updater.install_version(self._uv_path, self._env, self._version)
+
+            log_info_pair(
+                "Step 4: Installation completed successfully!", "步骤4: 安装成功完成！"
+            )
+        except FileNotFoundError as e:
+            log_error_pair(f"Environment error: {e}", f"环境错误：{e}")
+            log_error_pair(
+                "Please ensure uv is installed and available in PATH",
+                "请确保uv已安装并在PATH中可用",
+            )
+            sys.exit(2)
+        except subprocess.CalledProcessError as e:
+            log_error_pair(f"Installation error: {e}", f"安装错误：{e}")
+            log_error_pair(
+                "Please check your network connection and version specification",
+                "请检查网络连接和版本规格",
+            )
+            sys.exit(3)
+        except Exception as e:
+            self.handle_error(e, 1)

wl_cli/commands/self/handlers/status_handler.py

@@ -0,0 +1,66 @@
+"""
+Handler for self status subcommand.
+"""
+
+from wl_cli import __version__
+from wl_cli.utils.config import get_config
+from wl_cli.utils.logging import log_error_pair, log_info_pair
+
+from ...self.services.pypi_updater import PypiUpdater
+from .base_handler import BaseHandler
+
+
+class StatusHandler(BaseHandler):
+    """Handler for the status subcommand - shows current status and update info."""
+
+    def __init__(self, cache_timeout: int):
+        """
+        Initialize the status handler.
+
+        Args:
+            cache_timeout: Cache timeout in seconds
+        """
+        self._cache_timeout = cache_timeout
+
+    def execute(self) -> None:
+        """Execute the status subcommand."""
+        # Get configuration
+        cache_enabled = get_config("cache_enabled", True)
+        cache_timeout = get_config("cache_timeout", 300)
+
+        log_info_pair(
+            f"Current wl version: {__version__}", f"当前wl版本: {__version__}"
+        )
+        log_info_pair(
+            f"Configuration: cache_enabled={cache_enabled}, cache_timeout={cache_timeout}",
+            f"配置: cache_enabled={cache_enabled}, cache_timeout={cache_timeout}",
+        )
+
+        try:
+            # Check for updates
+            pypi_updater = PypiUpdater()
+            # Update cache timeout based on config
+            if hasattr(pypi_updater, "_cache_timeout"):
+                pypi_updater._cache_timeout = cache_timeout
+            latest_version = pypi_updater.get_latest_version()
+
+            if latest_version > __version__:
+                log_info_pair(
+                    f"A newer version is available: {latest_version}",
+                    f"有新版本可用: {latest_version}",
+                )
+                log_info_pair(
+                    "Run 'wl self update' to update", "运行 'wl self update' 进行更新"
+                )
+            else:
+                log_info_pair("You are using the latest version", "您正在使用最新版本")
+        except ConnectionError as e:
+            log_error_pair(f"Network error: {e}", f"网络错误：{e}")
+            log_error_pair(
+                "Please check your network connection and try again",
+                "请检查网络连接并重试",
+            )
+        except Exception as e:
+            log_error_pair(
+                f"Error checking for updates: {e}", f"错误：检查更新失败: {e}"
+            )

wl_cli/commands/self/handlers/uninstall_handler.py

@@ -0,0 +1,58 @@
+"""
+Handler for self uninstall subcommand.
+"""
+
+import subprocess
+import sys
+
+from wl_cli.utils.logging import log_error_pair, log_info_pair
+
+from ...self.services.installation_manager import InstallationManager
+from .base_handler import BaseHandler
+
+
+class UninstallHandler(BaseHandler):
+    """Handler for the uninstall subcommand - uninstalls wl command."""
+
+    def __init__(
+        self, uv_path: str, env: dict, installation_manager: InstallationManager
+    ):
+        """
+        Initialize the uninstall handler.
+
+        Args:
+            uv_path: Path to uv executable
+            env: Environment variables
+            installation_manager: Installation manager instance
+        """
+        self._uv_path = uv_path
+        self._env = env
+        self._installation_manager = installation_manager
+
+    def execute(self) -> None:
+        """Execute the uninstall subcommand."""
+        log_info_pair("Uninstalling wl command...", "正在卸载wl命令...")
+
+        try:
+            log_info_pair("Step 3: Uninstalling wl command...", "步骤3: 卸载wl命令...")
+            self._installation_manager.uninstall(self._uv_path, self._env)
+
+            log_info_pair(
+                "Step 4: Uninstallation completed successfully!",
+                "步骤4: 卸载成功完成！",
+            )
+        except FileNotFoundError as e:
+            log_error_pair(f"Environment error: {e}", f"环境错误：{e}")
+            log_error_pair(
+                "Please ensure uv is installed and available in PATH",
+                "请确保uv已安装并在PATH中可用",
+            )
+            sys.exit(2)
+        except subprocess.CalledProcessError as e:
+            log_error_pair(f"Uninstallation error: {e}", f"卸载错误：{e}")
+            log_error_pair(
+                "Please check if wl is properly installed", "请检查wl是否正确安装"
+            )
+            sys.exit(3)
+        except Exception as e:
+            self.handle_error(e, 1)

wl_cli/commands/self/handlers/update_handler.py

@@ -0,0 +1,102 @@
+"""
+Handler for self update subcommand.
+"""
+
+import sys
+from subprocess import CalledProcessError
+
+from wl_cli.utils.logging import log_error_pair, log_info_pair
+
+from ....utils.platform_adapter import PlatformAdapter
+from ...self.common.config import SelfConfig
+from ...self.services.installation_manager import InstallationManager
+from ...self.services.local_installer import LocalInstaller
+from ...self.services.pypi_updater import PypiUpdater
+from ...self.services.windows_update import WindowsUpdate
+from .base_handler import BaseHandler
+
+
+class UpdateHandler(BaseHandler):
+    """Handler for the update subcommand - updates wl command."""
+
+    def __init__(
+        self,
+        path: str | None,
+        uv_path: str,
+        env: dict,
+        installation_manager: InstallationManager,
+        config: SelfConfig,
+    ):
+        """
+        Initialize the update handler.
+
+        Args:
+            path: Path to local source (None for PyPI update)
+            uv_path: Path to uv executable
+            env: Environment variables
+            installation_manager: Installation manager instance
+            config: Self configuration
+        """
+        self._path = path
+        self._uv_path = uv_path
+        self._env = env
+        self._installation_manager = installation_manager
+        self._config = config
+
+    def execute(self) -> None:
+        """Execute the update subcommand."""
+        log_info_pair("Updating wl command...", "正在更新wl命令...")
+
+        log_info_pair(
+            f"Using configuration: {self._config.__dict__}",
+            f"使用配置: {self._config.__dict__}",
+        )
+
+        # Initialize variables that need to be accessible in except blocks
+        installation_manager: InstallationManager | None = self._installation_manager
+
+        try:
+            # Determine whether to install local or update from PyPI
+            if self._path is not None and self._path == ".":
+                # Install local code (like reinstall.bat)
+                log_info_pair(
+                    "Step 3: Installing local code...", "步骤3: 安装本地代码..."
+                )
+                local_installer = LocalInstaller()
+                local_installer.install(self._uv_path, self._env)
+            else:
+                # Update from PyPI using the same installation method
+                log_info_pair("Step 3: Updating from PyPI...", "步骤3: 从PyPI更新...")
+                pypi_updater = PypiUpdater()
+                # Update cache timeout based on config
+                if hasattr(pypi_updater, "_cache_timeout"):
+                    pypi_updater._cache_timeout = self._config.cache_timeout
+                pypi_updater.update(self._uv_path, self._env)
+
+            log_info_pair(
+                "Step 4: Update completed successfully!", "步骤4: 更新成功完成！"
+            )
+        except FileNotFoundError as e:
+            log_error_pair(f"Environment error: {e}", f"环境错误：{e}")
+            log_error_pair(
+                "Please ensure uv is installed and available in PATH",
+                "请确保uv已安装并在PATH中可用",
+            )
+            sys.exit(2)
+        except CalledProcessError as e:
+            log_error_pair(f"Installation error: {e}", f"安装错误：{e}")
+            log_error_pair(
+                "Please check your network connection and try again",
+                "请检查网络连接并重试",
+            )
+            sys.exit(3)
+        except Exception as e:
+            if (
+                installation_manager
+                and PlatformAdapter.is_windows()
+                and installation_manager.is_file_in_use_error(str(e))
+            ):
+                windows_update = WindowsUpdate()
+                windows_update.handle_access_error(self._uv_path or "")
+            else:
+                self.handle_error(e, 1)

wl_cli/commands/self/handlers/version_handler.py

@@ -0,0 +1,16 @@
+"""
+Handler for self version subcommand.
+"""
+
+from wl_cli import __version__
+from wl_cli.utils.logging import log_info_pair
+
+from .base_handler import BaseHandler
+
+
+class VersionHandler(BaseHandler):
+    """Handler for the version subcommand - shows current version."""
+
+    def execute(self) -> None:
+        """Execute the version subcommand."""
+        log_info_pair(f"wl version: {__version__}", f"wl 版本: {__version__}")

wl_cli/commands/self/self_command.py

@@ -0,0 +1,237 @@
+"""
+Self update command.
+"""
+
+import os
+import sys
+from typing import TYPE_CHECKING
+
+import click
+
+from wl_cli.utils.logging import log_error_pair, log_info_pair
+
+from ...env_status import emit_check
+from .common.capabilities import capability_names
+from .common.config import SelfConfig
+from .handlers.install_handler import InstallHandler
+from .handlers.status_handler import StatusHandler
+from .handlers.uninstall_handler import UninstallHandler
+from .handlers.update_handler import UpdateHandler
+from .handlers.version_handler import VersionHandler
+from .services.installation_manager import InstallationManager
+
+if TYPE_CHECKING:
+    from .handlers.base_handler import BaseHandler
+
+
+@click.group(
+    invoke_without_command=True,
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
+def self_group() -> None:
+    """Self management commands for the wl command.
+
+    Use one of the subcommands: update, version, install, uninstall, status,
+    capabilities
+
+    If no subcommand is specified, defaults to 'update'.
+    """
+    ctx = click.get_current_context()
+    if ctx.invoked_subcommand is None:
+        _execute_update_command()
+
+
+def _prepare_environment() -> tuple[str, dict, InstallationManager]:
+    """
+    Prepare environment for self commands.
+    为self命令准备环境。
+
+    Returns:
+        tuple: (uv_path, env, installation_manager)
+    """
+    log_info_pair("Step 1: Preparing environment...", "步骤1: 准备环境...")
+
+    installation_manager = InstallationManager()
+    uv_path, env = installation_manager.prepare_environment()
+
+    log_info_pair(
+        "Step 2: Determining installation method...", "步骤2: 确定安装方式..."
+    )
+
+    return uv_path, env, installation_manager
+
+
+def _execute_update_command(path: str | None = None) -> None:
+    """Execute the update command logic."""
+    try:
+        if path:
+            if ".." in path or (os.sep + ".." in path) or path.startswith(".."):
+                raise ValueError("Path traversal detected in path argument")
+
+        config = SelfConfig.load()
+        uv_path, env, installation_manager = _prepare_environment()
+        handler = UpdateHandler(path, uv_path, env, installation_manager, config)
+        handler.execute()
+    except Exception as e:
+        log_error_pair(f"Unexpected error: {e}", f"意外错误：{e}")
+        sys.exit(1)
+
+
+@self_group.command()
+@click.argument("path", default=None, required=False)
+def update(path: str | None) -> None:
+    """Update wl command to latest version."""
+    _execute_update_command(path=path)
+
+
+@self_group.command()
+def version() -> None:
+    """Show current version information."""
+    try:
+        handler = VersionHandler()
+        handler.execute()
+    except Exception as e:
+        log_error_pair(f"Unexpected error: {e}", f"意外错误：{e}")
+        sys.exit(1)
+
+
+@self_group.command()
+@click.argument("path", default=None, required=False)
+def install(path: str | None) -> None:
+    """Install specified version."""
+    try:
+        if path:
+            if ".." in path or (os.sep + ".." in path) or path.startswith(".."):
+                raise ValueError("Path traversal detected in path argument")
+
+        config = SelfConfig.load()
+        uv_path, env, installation_manager = _prepare_environment()
+        handler = InstallHandler(path, uv_path, env, installation_manager, config)
+        handler.execute()
+    except Exception as e:
+        log_error_pair(f"Unexpected error: {e}", f"意外错误：{e}")
+        sys.exit(1)
+
+
+@self_group.command()
+def uninstall() -> None:
+    """Uninstall wl command."""
+    try:
+        uv_path, env, installation_manager = _prepare_environment()
+        handler = UninstallHandler(uv_path, env, installation_manager)
+        handler.execute()
+    except Exception as e:
+        log_error_pair(f"Unexpected error: {e}", f"意外错误：{e}")
+        sys.exit(1)
+
+
+@self_group.command()
+def status() -> None:
+    """Show current status and update information."""
+    try:
+        config = SelfConfig.load()
+        handler = StatusHandler(config.cache_timeout)
+        handler.execute()
+    except Exception as e:
+        log_error_pair(f"Unexpected error: {e}", f"意外错误：{e}")
+        sys.exit(1)
+
+
+#: One-release deprecation window (#221): the alias keeps working, answers
+#: with the same envelope as ``wl env check --json`` and points consumers at
+#: the replacement. Removed after the release that ships 0.8.0.
+CAPABILITIES_DEPRECATION = "wl self capabilities is deprecated; use wl env check --json"
+
+
+@self_group.command()
+@click.option("--json", "as_json", is_flag=True, help="Output JSON format")
+def capabilities(as_json: bool) -> None:
+    """Deprecated alias for ``wl env check`` (#221, #270).
+
+    Capabilities are stable dotted names (``test.clean_cache``), not CLI flag
+    literals; consumers probe this instead of grepping ``--help``. Read-only:
+    ``--json`` emits the ``wl env check`` envelope (one line on stdout, never a
+    ``.wl`` write), while the deprecation notice goes to stderr. Without
+    ``--json`` the capability names are printed one per line.
+    """
+    click.echo(CAPABILITIES_DEPRECATION, err=True)
+    if as_json:
+        raise SystemExit(emit_check())
+    for name in capability_names():
+        click.echo(name)
+
+
+def self_command() -> click.Group:
+    """Return the self Click group for registration."""
+    return self_group
+
+
+class SelfCommand:
+    """Command for self-management of the wl command (legacy).
+
+    Subcommands:
+        update       - Update wl command to latest version
+        version      - Show current version information
+        install      - Install specified version
+        uninstall    - Uninstall wl command
+        status       - Show current status and update information
+        capabilities - Show the capabilities this wl build supports
+    """
+
+    @property
+    def name(self) -> str:
+        return "self"
+
+    @property
+    def help(self) -> str:
+        return (
+            "Self management commands "
+            "(update, version, install, uninstall, status, capabilities)"
+        )
+
+    def execute(self, subcommand: str = "update", path: str | None = None) -> None:
+        """
+        Self management commands for the wl command.
+        wl命令的自我管理命令。
+
+        Args:
+            subcommand: The subcommand to execute. Defaults to "update".
+            path: Path to local source or version specification.
+        """
+        valid_subcommands = ["update", "version", "install", "uninstall", "status"]
+        if subcommand not in valid_subcommands:
+            raise ValueError(f"Invalid subcommand: {subcommand}")
+
+        if path:
+            if ".." in path or (os.sep + ".." in path) or path.startswith(".."):
+                raise ValueError("Path traversal detected in path argument")
+
+        try:
+            config = SelfConfig.load()
+
+            handler: BaseHandler
+            if subcommand == "version":
+                handler = VersionHandler()
+                handler.execute()
+            elif subcommand == "update":
+                uv_path, env, installation_manager = _prepare_environment()
+                handler = UpdateHandler(
+                    path, uv_path, env, installation_manager, config
+                )
+                handler.execute()
+            elif subcommand == "install":
+                uv_path, env, installation_manager = _prepare_environment()
+                handler = InstallHandler(
+                    path, uv_path, env, installation_manager, config
+                )
+                handler.execute()
+            elif subcommand == "uninstall":
+                uv_path, env, installation_manager = _prepare_environment()
+                handler = UninstallHandler(uv_path, env, installation_manager)
+                handler.execute()
+            elif subcommand == "status":
+                handler = StatusHandler(config.cache_timeout)
+                handler.execute()
+        except Exception as e:
+            log_error_pair(f"Unexpected error: {e}", f"意外错误：{e}")
+            sys.exit(1)

wl_cli/commands/self/services/__init__.py

@@ -0,0 +1,15 @@
+"""
+Business services for self module.
+"""
+
+from .installation_manager import InstallationManager
+from .local_installer import LocalInstaller
+from .pypi_updater import PypiUpdater
+from .windows_update import WindowsUpdate
+
+__all__ = [
+    "InstallationManager",
+    "LocalInstaller",
+    "PypiUpdater",
+    "WindowsUpdate",
+]