ErisPulse 2.3.3.dev0__py3-none-any.whl → 2.3.4.dev0__py3-none-any.whl

ErisPulse/utils/cli/commands/list_remote.py

@@ -0,0 +1,128 @@
+"""
+List-Remote 命令实现
+
+列出远程可用的组件
+"""
+
+import asyncio
+from argparse import ArgumentParser
+
+from rich.table import Table
+from rich.box import SIMPLE
+
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+
+class ListRemoteCommand(Command):
+    """远程列表命令"""
+    
+    name = "list-remote"
+    description = "列出远程可用的组件"
+    
+    def __init__(self):
+        """初始化命令"""
+        self.package_manager = PackageManager()
+    
+    def add_arguments(self, parser: ArgumentParser):
+        """添加命令参数"""
+        parser.add_argument(
+            '--type', '-t',
+            choices=['modules', 'adapters', 'cli', 'all'],
+            default='all',
+            help='列出类型 (默认: all)'
+        )
+        parser.add_argument(
+            '--refresh', '-r',
+            action='store_true',
+            help='强制刷新远程包列表'
+        )
+    
+    def execute(self, args):
+        """执行命令"""
+        pkg_type = args.type
+        force_refresh = args.refresh
+        
+        if pkg_type == "all":
+            self._print_remote_packages("modules", force_refresh)
+            self._print_remote_packages("adapters", force_refresh)
+            self._print_remote_packages("cli", force_refresh)
+        else:
+            self._print_remote_packages(pkg_type, force_refresh)
+    
+    def _print_remote_packages(self, pkg_type: str, force_refresh: bool = False):
+        """
+        打印远程包信息
+        
+        :param pkg_type: 包类型 (modules/adapters/cli)
+        :param force_refresh: 是否强制刷新缓存
+        """
+        remote_packages = asyncio.run(
+            self.package_manager.get_remote_packages(force_refresh=force_refresh)
+        )
+        
+        if pkg_type == "modules" and remote_packages["modules"]:
+            table = Table(
+                title="远程模块",
+                box=SIMPLE,
+                header_style="module"
+            )
+            table.add_column("模块名", style="module")
+            table.add_column("包名")
+            table.add_column("最新版本")
+            table.add_column("描述")
+            
+            for name, info in remote_packages["modules"].items():
+                table.add_row(
+                    name,
+                    info["package"],
+                    info["version"],
+                    info.get("description", "")
+                )
+            
+            console.print(table)
+            
+        elif pkg_type == "adapters" and remote_packages["adapters"]:
+            table = Table(
+                title="远程适配器",
+                box=SIMPLE,
+                header_style="adapter"
+            )
+            table.add_column("适配器名", style="adapter")
+            table.add_column("包名")
+            table.add_column("最新版本")
+            table.add_column("描述")
+            
+            for name, info in remote_packages["adapters"].items():
+                table.add_row(
+                    name,
+                    info["package"],
+                    info["version"],
+                    info.get("description", "")
+                )
+            
+            console.print(table)
+            
+        elif pkg_type == "cli" and remote_packages.get("cli_extensions"):
+            table = Table(
+                title="远程CLI扩展",
+                box=SIMPLE,
+                header_style="cli"
+            )
+            table.add_column("命令名", style="cli")
+            table.add_column("包名")
+            table.add_column("最新版本")
+            table.add_column("描述")
+            
+            for name, info in remote_packages["cli_extensions"].items():
+                table.add_row(
+                    name,
+                    info["package"],
+                    info["version"],
+                    info.get("description", "")
+                )
+            
+            console.print(table)
+        elif not remote_packages.get(pkg_type.replace("cli", "cli_extensions"), {}):
+            console.print(f"[dim]远程没有找到 {pkg_type}[/]")

ErisPulse/utils/cli/commands/list_remote.pyi

@@ -0,0 +1,47 @@
+# type: ignore
+#
+# Auto-generated type stub for list_remote.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+List-Remote 命令实现
+
+列出远程可用的组件
+"""
+
+import asyncio
+from argparse import ArgumentParser
+from rich.table import Table
+from rich.box import SIMPLE
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+class ListRemoteCommand(Command):
+    """
+    远程列表命令
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化命令
+        """
+        ...
+    def add_arguments(self: object, parser: ArgumentParser) -> ...:
+        """
+        添加命令参数
+        """
+        ...
+    def execute(self: object, args: ...) -> ...:
+        """
+        执行命令
+        """
+        ...
+    def _print_remote_packages(self: object, pkg_type: str, force_refresh: bool = ...) -> ...:
+        """
+        打印远程包信息
+        
+        :param pkg_type: 包类型 (modules/adapters/cli)
+        :param force_refresh: 是否强制刷新缓存
+        """
+        ...

ErisPulse/utils/cli/commands/run.py

@@ -0,0 +1,112 @@
+"""
+Run 命令实现
+
+运行主程序
+"""
+
+import os
+import time
+from argparse import ArgumentParser
+from watchdog.observers import Observer
+from rich.panel import Panel
+
+from ...console import console
+from ...reload_handler import ReloadHandler
+from ..base import Command
+
+
+class RunCommand(Command):
+    """运行命令"""
+    
+    name = "run"
+    description = "运行主程序"
+    
+    def add_arguments(self, parser: ArgumentParser):
+        """添加命令参数"""
+        parser.add_argument(
+            'script',
+            nargs='?',
+            help='要运行的主程序路径 (默认: main.py)'
+        )
+        parser.add_argument(
+            '--reload',
+            action='store_true',
+            help='启用热重载模式'
+        )
+        parser.add_argument(
+            '--no-reload',
+            action='store_true',
+            help='禁用热重载模式'
+        )
+    
+    def execute(self, args):
+        """执行命令"""
+        script = args.script or "main.py"
+        
+        # 检查脚本是否存在
+        if not os.path.exists(script):
+            from .... import _prepare_environment
+            import asyncio
+            asyncio.run(_prepare_environment())
+        
+        reload_mode = args.reload and not args.no_reload
+        
+        # 设置文件监控
+        self.observer = None
+        self.handler = None
+        self._setup_watchdog(script, reload_mode)
+        
+        try:
+            # 保持运行
+            console.print("\n[cyan]按 Ctrl+C 停止程序[/cyan]")
+            while True:
+                time.sleep(0.5)
+        except KeyboardInterrupt:
+            console.print("\n[info]正在安全关闭...[/]")
+            self._cleanup()
+            console.print("[success]已安全退出[/]")
+    
+    def _setup_watchdog(self, script_path: str, reload_mode: bool):
+        """
+        设置文件监控
+        
+        :param script_path: 要监控的脚本路径
+        :param reload_mode: 是否启用重载模式
+        """
+        watch_dirs = [
+            os.path.dirname(os.path.abspath(script_path)),
+        ]
+        
+        # 添加配置目录
+        config_dir = os.path.abspath(os.getcwd())
+        if config_dir not in watch_dirs:
+            watch_dirs.append(config_dir)
+        
+        self.handler = ReloadHandler(script_path, reload_mode)
+        self.observer = Observer()
+        
+        for d in watch_dirs:
+            if os.path.exists(d):
+                self.observer.schedule(
+                    self.handler,
+                    d,
+                    recursive=reload_mode
+                )
+                console.print(f"[dim]监控目录: [path]{d}[/][/]")
+        
+        self.observer.start()
+        
+        mode_desc = "[bold]开发重载模式[/]" if reload_mode else "[bold]配置监控模式[/]"
+        console.print(Panel(
+            f"{mode_desc}\n监控目录: [path]{', '.join(watch_dirs)}[/]",
+            title="热重载已启动",
+            border_style="info"
+        ))
+    
+    def _cleanup(self):
+        """清理资源"""
+        if self.observer:
+            self.observer.stop()
+            if self.handler and self.handler.process:
+                self.handler._terminate_process()
+            self.observer.join()

ErisPulse/utils/cli/commands/run.pyi

@@ -0,0 +1,48 @@
+# type: ignore
+#
+# Auto-generated type stub for run.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+Run 命令实现
+
+运行主程序
+"""
+
+import os
+import time
+from argparse import ArgumentParser
+from watchdog.observers import Observer
+from rich.panel import Panel
+from ...console import console
+from ...reload_handler import ReloadHandler
+from ..base import Command
+
+class RunCommand(Command):
+    """
+    运行命令
+    """
+    def add_arguments(self: object, parser: ArgumentParser) -> ...:
+        """
+        添加命令参数
+        """
+        ...
+    def execute(self: object, args: ...) -> ...:
+        """
+        执行命令
+        """
+        ...
+    def _setup_watchdog(self: object, script_path: str, reload_mode: bool) -> ...:
+        """
+        设置文件监控
+        
+        :param script_path: 要监控的脚本路径
+        :param reload_mode: 是否启用重载模式
+        """
+        ...
+    def _cleanup(self: object) -> ...:
+        """
+        清理资源
+        """
+        ...

ErisPulse/utils/cli/commands/self_update.py

@@ -0,0 +1,237 @@
+"""
+Self-Update 命令实现
+
+更新 ErisPulse SDK 本身
+"""
+
+import sys
+import asyncio
+from argparse import ArgumentParser
+from rich.prompt import Confirm, Prompt
+from rich.panel import Panel
+
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+
+class SelfUpdateCommand(Command):
+    """自更新命令"""
+    
+    name = "self-update"
+    description = "更新 ErisPulse SDK 本身"
+    
+    def __init__(self):
+        """初始化命令"""
+        self.package_manager = PackageManager()
+    
+    def add_arguments(self, parser: ArgumentParser):
+        """添加命令参数"""
+        parser.add_argument(
+            'version',
+            nargs='?',
+            help='要更新到的版本号 (可选，默认为最新版本)'
+        )
+        parser.add_argument(
+            '--pre',
+            action='store_true',
+            help='包含预发布版本'
+        )
+        parser.add_argument(
+            '--force', '-f',
+            action='store_true',
+            help='强制更新，即使版本相同'
+        )
+    
+    def execute(self, args):
+        """执行命令"""
+        current_version = self.package_manager.get_installed_version()
+        console.print(Panel(
+            f"[title]ErisPulse SDK 自更新[/]\n"
+            f"当前版本: [bold]{current_version}[/]",
+            title_align="left"
+        ))
+        
+        # 获取可用版本
+        with console.status("[bold green]正在获取版本信息...", spinner="dots"):
+            versions = asyncio.run(self.package_manager.get_pypi_versions())
+        
+        if not versions:
+            console.print("[error]无法获取版本信息[/]")
+            sys.exit(1)
+        
+        # 确定目标版本
+        target_version = self._select_target_version(versions, args.version, args.pre)
+        
+        if target_version is None:
+            console.print("[info]操作已取消[/]")
+            sys.exit(0)
+        
+        # 确认更新
+        if target_version == current_version and not args.force:
+            console.print(f"[info]当前已是目标版本 [bold]{current_version}[/][/]")
+            sys.exit(0)
+        elif not args.force:
+            if not Confirm.ask(
+                f"确认将ErisPulse SDK从 [bold]{current_version}[/] 更新到 [bold]{target_version}[/] 吗？",
+                default=False
+            ):
+                console.print("[info]操作已取消[/]")
+                sys.exit(0)
+        
+        # 执行更新
+        success = self.package_manager.update_self(target_version, args.force)
+        if not success:
+            sys.exit(1)
+    
+    def _select_target_version(self, versions, specified_version: str = None, 
+                            include_pre: bool = False) -> str:
+        """
+        选择目标版本
+        
+        :param versions: 版本列表
+        :param specified_version: 用户指定的版本
+        :param include_pre: 是否包含预发布版本
+        :return: 目标版本号
+        """
+        if specified_version:
+            # 用户已指定版本
+            if not any(v['version'] == specified_version for v in versions):
+                console.print(f"[warning]版本 {specified_version} 可能不存在[/]")
+                if not Confirm.ask("是否继续？", default=False):
+                    return None
+            return specified_version
+        
+        # 交互式选择
+        stable_versions = [v for v in versions if not v["pre_release"]]
+        pre_versions = [v for v in versions if v["pre_release"]]
+        
+        latest_stable = stable_versions[0] if stable_versions else None
+        latest_pre = pre_versions[0] if pre_versions and include_pre else None
+        
+        choices = []
+        choice_versions = {}
+        
+        if latest_stable:
+            choice = f"最新稳定版 ({latest_stable['version']})"
+            choices.append(choice)
+            choice_versions[choice] = latest_stable['version']
+        
+        if include_pre and latest_pre:
+            choice = f"最新预发布版 ({latest_pre['version']})"
+            choices.append(choice)
+            choice_versions[choice] = latest_pre['version']
+        
+        # 添加其他选项
+        choices.append("查看所有版本")
+        choices.append("手动指定版本")
+        choices.append("取消")
+        
+        # 显示选项
+        console.print("\n[info]请选择更新选项:[/]")
+        for i, choice in enumerate(choices, 1):
+            console.print(f"  {i}. {choice}")
+        
+        while True:
+            try:
+                selected_input = Prompt.ask(
+                    "请输入选项编号",
+                    default="1"
+                )
+                
+                if selected_input.isdigit():
+                    selected_index = int(selected_input)
+                    if 1 <= selected_index <= len(choices):
+                        selected = choices[selected_index - 1]
+                        break
+                    else:
+                        console.print("[warning]请输入有效的选项编号[/]")
+                else:
+                    if selected_input in choices:
+                        selected = selected_input
+                        break
+                    else:
+                        console.print("[warning]请输入有效的选项编号或选项名称[/]")
+            except KeyboardInterrupt:
+                console.print("\n[info]操作已取消[/]")
+                return None
+        
+        if selected == "取消":
+            return None
+        elif selected == "手动指定版本":
+            target_version = Prompt.ask("请输入要更新到的版本号")
+            if not any(v['version'] == target_version for v in versions):
+                console.print(f"[warning]版本 {target_version} 可能不存在[/]")
+                if not Confirm.ask("是否继续？", default=False):
+                    return None
+            return target_version
+        elif selected == "查看所有版本":
+            return self._select_from_version_list(versions, include_pre)
+        else:
+            return choice_versions[selected]
+    
+    def _select_from_version_list(self, versions, include_pre: bool = False) -> str:
+        """
+        从版本列表中选择
+        
+        :param versions: 版本列表
+        :param include_pre: 是否包含预发布版本
+        :return: 选中的版本号
+        """
+        from rich.table import Table
+        from rich.box import SIMPLE
+        
+        table = Table(
+            title="可用版本",
+            box=SIMPLE,
+            header_style="info"
+        )
+        table.add_column("序号")
+        table.add_column("版本")
+        table.add_column("类型")
+        table.add_column("上传时间")
+        
+        displayed = 0
+        version_list = []
+        for version_info in versions:
+            if not include_pre and version_info["pre_release"]:
+                continue
+                
+            version_list.append(version_info)
+            version_type = "[yellow]预发布[/]" if version_info["pre_release"] else "[green]稳定版[/]"
+            table.add_row(
+                str(displayed + 1),
+                version_info["version"],
+                version_type,
+                version_info["uploaded"][:10] if version_info["uploaded"] else "未知"
+            )
+            displayed += 1
+            
+            if displayed >= 10:
+                break
+        
+        if displayed == 0:
+            console.print("[info]没有找到符合条件的版本[/]")
+            return None
+        
+        console.print(table)
+        
+        # 显示版本选择
+        console.print("\n[info]请选择要更新到的版本:[/]")
+        while True:
+            try:
+                version_input = Prompt.ask("请输入版本序号或版本号")
+                if version_input.isdigit():
+                    version_index = int(version_input)
+                    if 1 <= version_index <= len(version_list):
+                        return version_list[version_index - 1]['version']
+                    else:
+                        console.print("[warning]请输入有效的版本序号[/]")
+                else:
+                    if any(v['version'] == version_input for v in version_list):
+                        return version_input
+                    else:
+                        console.print("[warning]请输入有效的版本序号或版本号[/]")
+            except KeyboardInterrupt:
+                console.print("\n[info]操作已取消[/]")
+                return None

ErisPulse/utils/cli/commands/self_update.pyi

@@ -0,0 +1,59 @@
+# type: ignore
+#
+# Auto-generated type stub for self_update.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+Self-Update 命令实现
+
+更新 ErisPulse SDK 本身
+"""
+
+import sys
+import asyncio
+from argparse import ArgumentParser
+from rich.prompt import Confirm, Prompt
+from rich.panel import Panel
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+class SelfUpdateCommand(Command):
+    """
+    自更新命令
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化命令
+        """
+        ...
+    def add_arguments(self: object, parser: ArgumentParser) -> ...:
+        """
+        添加命令参数
+        """
+        ...
+    def execute(self: object, args: ...) -> ...:
+        """
+        执行命令
+        """
+        ...
+    def _select_target_version(self: object, versions: ..., specified_version: str = ..., include_pre: bool = ...) -> str:
+        """
+        选择目标版本
+        
+        :param versions: 版本列表
+        :param specified_version: 用户指定的版本
+        :param include_pre: 是否包含预发布版本
+        :return: 目标版本号
+        """
+        ...
+    def _select_from_version_list(self: object, versions: ..., include_pre: bool = ...) -> str:
+        """
+        从版本列表中选择
+        
+        :param versions: 版本列表
+        :param include_pre: 是否包含预发布版本
+        :return: 选中的版本号
+        """
+        ...

ErisPulse/utils/cli/commands/uninstall.py

@@ -0,0 +1,37 @@
+"""
+Uninstall 命令实现
+
+支持卸载模块、适配器、CLI 扩展
+"""
+
+import sys
+from argparse import ArgumentParser
+
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+
+class UninstallCommand(Command):
+    """卸载命令"""
+    
+    name = "uninstall"
+    description = "卸载模块/适配器包"
+    
+    def __init__(self):
+        """初始化命令"""
+        self.package_manager = PackageManager()
+    
+    def add_arguments(self, parser: ArgumentParser):
+        """添加命令参数"""
+        parser.add_argument(
+            'package',
+            nargs='+',
+            help='要卸载的包名（可指定多个）'
+        )
+    
+    def execute(self, args):
+        """执行命令"""
+        success = self.package_manager.uninstall_package(args.package)
+        if not success:
+            sys.exit(1)