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

ErisPulse/utils/cli/commands/uninstall.pyi

@@ -0,0 +1,37 @@
+# type: ignore
+#
+# Auto-generated type stub for uninstall.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+Uninstall 命令实现
+
+支持卸载模块、适配器、CLI 扩展
+"""
+
+import sys
+from argparse import ArgumentParser
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+class UninstallCommand(Command):
+    """
+    卸载命令
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化命令
+        """
+        ...
+    def add_arguments(self: object, parser: ArgumentParser) -> ...:
+        """
+        添加命令参数
+        """
+        ...
+    def execute(self: object, args: ...) -> ...:
+        """
+        执行命令
+        """
+        ...

ErisPulse/utils/cli/commands/upgrade.py

@@ -0,0 +1,62 @@
+"""
+Upgrade 命令实现
+
+升级组件
+"""
+
+import sys
+from argparse import ArgumentParser
+from rich.prompt import Confirm
+
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+
+class UpgradeCommand(Command):
+    """升级命令"""
+    
+    name = "upgrade"
+    description = "升级组件（不指定包名则升级所有）"
+    
+    def __init__(self):
+        """初始化命令"""
+        self.package_manager = PackageManager()
+    
+    def add_arguments(self, parser: ArgumentParser):
+        """添加命令参数"""
+        parser.add_argument(
+            'package',
+            nargs='*',
+            help='要升级的包名 (可选，不指定则升级所有)'
+        )
+        parser.add_argument(
+            '--force', '-f',
+            action='store_true',
+            help='跳过确认直接升级'
+        )
+        parser.add_argument(
+            '--pre',
+            action='store_true',
+            help='包含预发布版本'
+        )
+    
+    def execute(self, args):
+        """执行命令"""
+        if args.package:
+            # 升级指定包
+            success = self.package_manager.upgrade_package(
+                args.package,
+                pre=args.pre
+            )
+            if not success:
+                sys.exit(1)
+        else:
+            # 升级所有包
+            if args.force or Confirm.ask(
+                "确定要升级所有ErisPulse组件吗？",
+                default=False
+            ):
+                success = self.package_manager.upgrade_all()
+                if not success:
+                    sys.exit(1)

ErisPulse/utils/cli/commands/upgrade.pyi

@@ -0,0 +1,38 @@
+# type: ignore
+#
+# Auto-generated type stub for upgrade.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+Upgrade 命令实现
+
+升级组件
+"""
+
+import sys
+from argparse import ArgumentParser
+from rich.prompt import Confirm
+from ...package_manager import PackageManager
+from ...console import console
+from ..base import Command
+
+class UpgradeCommand(Command):
+    """
+    升级命令
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化命令
+        """
+        ...
+    def add_arguments(self: object, parser: ArgumentParser) -> ...:
+        """
+        添加命令参数
+        """
+        ...
+    def execute(self: object, args: ...) -> ...:
+        """
+        执行命令
+        """
+        ...

ErisPulse/utils/cli/registry.py

@@ -0,0 +1,112 @@
+"""
+CLI 命令注册器
+
+负责命令的注册、查找和管理
+"""
+
+from typing import Optional, List, Dict
+from .base import Command
+
+
+class CommandRegistry:
+    """
+    命令注册器
+    
+    管理所有已注册的 CLI 命令
+    
+    {!--< tips >!--}
+    1. 使用单例模式确保全局唯一
+    2. 支持命令的动态注册和查找
+    3. 支持第三方命令的兼容
+    {!--< /tips >!--}
+    
+    :ivar _commands: 已注册的命令字典 {name: Command}
+    """
+    
+    _instance = None
+    
+    def __new__(cls):
+        """实现单例模式"""
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._commands: Dict[str, Command] = {}
+            cls._instance._external_commands: Dict[str, Command] = {}
+        return cls._instance
+    
+    def register(self, command: Command):
+        """
+        注册命令
+        
+        :param command: 要注册的命令实例
+        :raises ValueError: 命令名称已存在时抛出
+        """
+        if command.name in self._commands:
+            raise ValueError(f"命令 '{command.name}' 已存在")
+        self._commands[command.name] = command
+    
+    def register_external(self, name: str, command: Command):
+        """
+        注册第三方命令
+        
+        :param name: 命令名称
+        :param command: 命令实例
+        """
+        self._external_commands[name] = command
+    
+    def get(self, name: str) -> Optional[Command]:
+        """
+        获取命令
+        
+        :param name: 命令名称
+        :return: 命令实例，未找到返回 None
+        """
+        # 优先查找内置命令
+        if name in self._commands:
+            return self._commands[name]
+        # 然后查找外部命令
+        return self._external_commands.get(name)
+    
+    def get_all(self) -> List[Command]:
+        """
+        获取所有命令（包括外部命令）
+        
+        :return: 所有命令列表
+        """
+        return list(self._commands.values()) + list(self._external_commands.values())
+    
+    def list_all(self) -> List[str]:
+        """
+        列出所有命令名称
+        
+        :return: 命令名称列表
+        """
+        return list(self._commands.keys()) + list(self._external_commands.keys())
+    
+    def list_builtin(self) -> List[str]:
+        """
+        列出内置命令名称
+        
+        :return: 内置命令名称列表
+        """
+        return list(self._commands.keys())
+    
+    def list_external(self) -> List[str]:
+        """
+        列出外部命令名称
+        
+        :return: 外部命令名称列表
+        """
+        return list(self._external_commands.keys())
+    
+    def exists(self, name: str) -> bool:
+        """
+        检查命令是否存在
+        
+        :param name: 命令名称
+        :return: 命令是否存在
+        """
+        return name in self._commands or name in self._external_commands
+    
+    def clear_external(self):
+        """清空外部命令"""
+        self._external_commands.clear()

ErisPulse/utils/cli/registry.pyi

@@ -0,0 +1,99 @@
+# type: ignore
+#
+# Auto-generated type stub for registry.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+CLI 命令注册器
+
+负责命令的注册、查找和管理
+"""
+
+from typing import Optional, List, Dict
+from .base import Command
+
+class CommandRegistry:
+    """
+    命令注册器
+    
+    管理所有已注册的 CLI 命令
+    
+    {!--< tips >!--}
+    1. 使用单例模式确保全局唯一
+    2. 支持命令的动态注册和查找
+    3. 支持第三方命令的兼容
+    {!--< /tips >!--}
+    
+    :ivar _commands: 已注册的命令字典 {name: Command}
+    """
+    def __new__(cls: object) -> ...:
+        """
+        实现单例模式
+        """
+        ...
+    def register(self: object, command: Command) -> ...:
+        """
+        注册命令
+        
+        :param command: 要注册的命令实例
+        :raises ValueError: 命令名称已存在时抛出
+        """
+        ...
+    def register_external(self: object, name: str, command: Command) -> ...:
+        """
+        注册第三方命令
+        
+        :param name: 命令名称
+        :param command: 命令实例
+        """
+        ...
+    def get(self: object, name: str) -> Optional[Command]:
+        """
+        获取命令
+        
+        :param name: 命令名称
+        :return: 命令实例，未找到返回 None
+        """
+        ...
+    def get_all(self: object) -> List[Command]:
+        """
+        获取所有命令（包括外部命令）
+        
+        :return: 所有命令列表
+        """
+        ...
+    def list_all(self: object) -> List[str]:
+        """
+        列出所有命令名称
+        
+        :return: 命令名称列表
+        """
+        ...
+    def list_builtin(self: object) -> List[str]:
+        """
+        列出内置命令名称
+        
+        :return: 内置命令名称列表
+        """
+        ...
+    def list_external(self: object) -> List[str]:
+        """
+        列出外部命令名称
+        
+        :return: 外部命令名称列表
+        """
+        ...
+    def exists(self: object, name: str) -> bool:
+        """
+        检查命令是否存在
+        
+        :param name: 命令名称
+        :return: 命令是否存在
+        """
+        ...
+    def clear_external(self: object) -> ...:
+        """
+        清空外部命令
+        """
+        ...

ErisPulse/utils/console.pyi

@@ -0,0 +1,20 @@
+# type: ignore
+#
+# Auto-generated type stub for console.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+import sys
+from rich.console import Console
+from rich.theme import Theme
+from rich.highlighter import RegexHighlighter
+
+class CommandHighlighter(RegexHighlighter):
+    """
+    高亮CLI命令和参数
+    
+    {!--< tips >!--}
+    使用正则表达式匹配命令行参数和选项
+    {!--< /tips >!--}
+    """
+    ...

ErisPulse/utils/package_manager.pyi

@@ -0,0 +1,224 @@
+# type: ignore
+#
+# Auto-generated type stub for package_manager.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 包管理器
+
+提供包安装、卸载、升级和查询功能
+"""
+
+import os
+import asyncio
+import importlib.metadata
+import json
+import subprocess
+import sys
+import time
+from typing import List, Dict, Tuple, Optional, Any
+from rich.panel import Panel
+from rich.progress import Progress, BarColumn, TextColumn
+from rich.prompt import Confirm
+from .console import console
+
+class PackageManager:
+    """
+    ErisPulse包管理器
+    
+    提供包安装、卸载、升级和查询功能
+    
+    {!--< tips >!--}
+    1. 支持本地和远程包管理
+    2. 包含1小时缓存机制
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化包管理器
+        """
+        ...
+    async def _fetch_remote_packages(self: object, url: str) -> Optional[dict]:
+        """
+        从指定URL获取远程包数据
+        
+        :param url: 远程包数据URL
+        :return: 解析后的JSON数据，失败返回None
+        
+        :raises ClientError: 网络请求失败时抛出
+        :raises JSONDecodeError: JSON解析失败时抛出
+        """
+        ...
+    async def get_remote_packages(self: object, force_refresh: bool = ...) -> dict:
+        """
+        获取远程包列表，带缓存机制
+        
+        :param force_refresh: 是否强制刷新缓存
+        :return: 包含模块和适配器的字典
+        
+        :return:
+            dict: {
+                "modules": {模块名: 模块信息},
+                "adapters": {适配器名: 适配器信息},
+                "cli_extensions": {扩展名: 扩展信息}
+            }
+        """
+        ...
+    def get_installed_packages(self: object) -> Dict[(str, Dict[(str, Dict[(str, str)])])]:
+        """
+        获取已安装的包信息
+        
+        :return: 已安装包字典，包含模块、适配器和CLI扩展
+        
+        :return:
+            dict: {
+                "modules": {模块名: 模块信息},
+                "adapters": {适配器名: 适配器信息},
+                "cli_extensions": {扩展名: 扩展信息}
+            }
+        """
+        ...
+    def _is_module_enabled(self: object, module_name: str) -> bool:
+        """
+        检查模块是否启用
+        
+        :param module_name: 模块名称
+        :return: 模块是否启用
+        
+        :raises ImportError: 核心模块不可用时抛出
+        """
+        ...
+    def _normalize_name(self: object, name: str) -> str:
+        """
+        标准化包名，统一转为小写以实现大小写不敏感比较
+        
+        :param name: 原始名称
+        :return: 标准化后的名称
+        """
+        ...
+    async def _find_package_by_alias(self: object, alias: str) -> Optional[str]:
+        """
+        通过别名查找实际包名（大小写不敏感）
+        
+        :param alias: 包别名
+        :return: 实际包名，未找到返回None
+        """
+        ...
+    def _find_installed_package_by_name(self: object, name: str) -> Optional[str]:
+        """
+        在已安装包中查找实际包名（大小写不敏感）
+        
+        :param name: 包名或别名
+        :return: 实际包名，未找到返回None
+        """
+        ...
+    def _run_pip_command_with_output(self: object, args: List[str], description: str) -> Tuple[(bool, str, str)]:
+        """
+        执行pip命令并捕获输出
+        
+        :param args: pip命令参数列表
+        :param description: 进度条描述
+        :return: (是否成功, 标准输出, 标准错误)
+        """
+        ...
+    def _compare_versions(self: object, version1: str, version2: str) -> int:
+        """
+        比较两个版本号
+        
+        :param version1: 版本号1
+        :param version2: 版本号2
+        :return: 1 if version1 > version2, -1 if version1 < version2, 0 if equal
+        """
+        ...
+    def _check_sdk_compatibility(self: object, min_sdk_version: str) -> Tuple[(bool, str)]:
+        """
+        检查SDK版本兼容性
+        
+        :param min_sdk_version: 所需的最小SDK版本
+        :return: (是否兼容, 当前版本信息)
+        """
+        ...
+    async def _get_package_info(self: object, package_name: str) -> Optional[Dict[(str, Any)]]:
+        """
+        获取包的详细信息（包括min_sdk_version等）
+        
+        :param package_name: 包名或别名
+        :return: 包信息字典
+        """
+        ...
+    def install_package(self: object, package_names: List[str], upgrade: bool = ..., pre: bool = ...) -> bool:
+        """
+        安装指定包（支持多个包）
+        
+        :param package_names: 要安装的包名或别名列表
+        :param upgrade: 是否升级已安装的包
+        :param pre: 是否包含预发布版本
+        :return: 安装是否成功
+        """
+        ...
+    def uninstall_package(self: object, package_names: List[str]) -> bool:
+        """
+        卸载指定包（支持多个包，支持别名）
+        
+        :param package_names: 要卸载的包名或别名列表
+        :return: 卸载是否成功
+        """
+        ...
+    def upgrade_all(self: object) -> bool:
+        """
+        升级所有已安装的ErisPulse包
+        
+        :return: 升级是否成功
+        
+        :raises KeyboardInterrupt: 用户取消操作时抛出
+        """
+        ...
+    def upgrade_package(self: object, package_names: List[str], pre: bool = ...) -> bool:
+        """
+        升级指定包（支持多个包）
+        
+        :param package_names: 要升级的包名或别名列表
+        :param pre: 是否包含预发布版本
+        :return: 升级是否成功
+        """
+        ...
+    def search_package(self: object, query: str) -> Dict[(str, List[Dict[(str, str)]])]:
+        """
+        搜索包（本地和远程）
+        
+        :param query: 搜索关键词
+        :return: 匹配的包信息
+        """
+        ...
+    def get_installed_version(self: object) -> str:
+        """
+        获取当前安装的ErisPulse版本
+        
+        :return: 当前版本号
+        """
+        ...
+    async def get_pypi_versions(self: object) -> List[Dict[(str, Any)]]:
+        """
+        从PyPI获取ErisPulse的所有可用版本
+        
+        :return: 版本信息列表
+        """
+        ...
+    def _is_pre_release(self: object, version: str) -> bool:
+        """
+        判断版本是否为预发布版本
+        
+        :param version: 版本号
+        :return: 是否为预发布版本
+        """
+        ...
+    def update_self(self: object, target_version: str = ..., force: bool = ...) -> bool:
+        """
+        更新ErisPulse SDK本身
+        
+        :param target_version: 目标版本号，None表示更新到最新版本
+        :param force: 是否强制更新
+        :return: 更新是否成功
+        """
+        ...

ErisPulse/utils/reload_handler.pyi

@@ -0,0 +1,64 @@
+# type: ignore
+#
+# Auto-generated type stub for reload_handler.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 热重载处理器
+
+实现热重载功能，监控文件变化并重启进程
+"""
+
+import os
+import subprocess
+import sys
+import time
+from watchdog.events import FileSystemEventHandler
+from .console import console
+
+class ReloadHandler(FileSystemEventHandler):
+    """
+    文件系统事件处理器
+    
+    实现热重载功能，监控文件变化并重启进程
+    
+    {!--< tips >!--}
+    1. 支持.py文件修改重载
+    2. 支持配置文件修改重载
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, script_path: str, reload_mode: bool = ...) -> ...:
+        """
+        初始化处理器
+        
+        :param script_path: 要监控的脚本路径
+        :param reload_mode: 是否启用重载模式
+        """
+        ...
+    def start_process(self: object) -> ...:
+        """
+        启动监控进程
+        """
+        ...
+    def _terminate_process(self: object) -> ...:
+        """
+        终止当前进程
+        
+        :raises subprocess.TimeoutExpired: 进程终止超时时抛出
+        """
+        ...
+    def on_modified(self: object, event: ...) -> ...:
+        """
+        文件修改事件处理
+        
+        :param event: 文件系统事件
+        """
+        ...
+    def _handle_reload(self: object, event: ..., reason: str) -> ...:
+        """
+        处理热重载逻辑
+        :param event: 文件系统事件
+        :param reason: 重载原因
+        """
+        ...