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

ErisPulse/CLI/utils/package_manager.pyi

@@ -0,0 +1,241 @@
+# 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: 包别名或PyPI包名
+        :return: 实际包名，未找到返回None
+        """
+        ...
+    def _find_installed_package_by_name(self: object, name: str) -> Optional[str]:
+        """
+        在已安装包中查找实际包名（大小写不敏感）
+        
+        :param name: 包名或别名
+        :return: 实际包名，未找到返回None
+        """
+        ...
+    async def check_package_updates(self: object) -> Dict[(str, Tuple[(str, str)])]:
+        """
+        检查包更新，对比本地版本和远程版本
+        
+        :return: {包名: (当前版本, 最新版本)}，仅包含有新版本的包
+        """
+        ...
+    async def _get_pypi_package_version(self: object, package_name: str, force_refresh: bool = ...) -> Optional[str]:
+        """
+        从PyPI获取包的最新版本，带缓存机制
+        
+        :param package_name: PyPI包名
+        :param force_refresh: 是否强制刷新缓存
+        :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 → CLI/utils}/reload_handler.py

@@ -10,7 +10,7 @@ import sys
 import time
 from watchdog.events import FileSystemEventHandler
 
-from .console import console
+from ..console import console
 
 
 class ReloadHandler(FileSystemEventHandler):
@@ -96,16 +96,15 @@ class ReloadHandler(FileSystemEventHandler):
         :param event: 文件系统事件
         :param reason: 重载原因
         """
-        from ErisPulse.Core import logger
     
         try:
-            from .cli import _cleanup_adapters, _cleanup_modules
-            logger.info(f"检测到文件变更 ({reason})，正在关闭适配器和模块...")
-            _cleanup_adapters()
-            _cleanup_modules()
+            import asyncio
+            from ... import uninit
+            console.print(f"检测到文件变更 ({reason})，正在关闭适配器和模块...")
+            asyncio.run(uninit())
         except Exception as e:
-            logger.warning(f"关闭适配器和模块时出错: {e}")
+            console.print(f"关闭适配器和模块时出错: {e}")
         
-        logger.info("正在重启...")
+        console.print("正在重启...")
         self._terminate_process()
         self.start_process()

ErisPulse/CLI/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: 重载原因
+        """
+        ...

ErisPulse/Core/Bases/__init__.pyi

@@ -0,0 +1,14 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 基础模块
+
+提供核心基类定义，包括适配器和模块基类
+"""
+
+from .adapter import SendDSL, BaseAdapter
+from .module import BaseModule

ErisPulse/Core/Bases/adapter.py

@@ -72,7 +72,19 @@ class SendDSL:
         >>> adapter.Send.To("123").Using("bot1").Text("Hello")  # 支持乱序
         """
         return self.__class__(self._adapter, self._target_type, self._target_id, account_id)
-
+    
+    def Account(self, account_id: Union[str, int]) -> 'SendDSL':
+        """
+        设置发送账号
+        
+        :param _account_id: 发送账号
+        :return: SendDSL实例
+        
+        :example:
+        >>> adapter.Send.Account("bot1").To("123").Text("Hello")
+        >>> adapter.Send.To("123").Account("bot1").Text("Hello")  # 支持乱序
+        """
+        return self.__class__(self._adapter, self._target_type, self._target_id, account_id)
 
 class BaseAdapter:
     """

ErisPulse/Core/Bases/adapter.pyi

@@ -0,0 +1,140 @@
+# type: ignore
+#
+# Auto-generated type stub for adapter.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse 适配器基础模块
+
+提供适配器和消息发送DSL的基类实现
+
+{!--< tips >!--}
+1. 用于实现与不同平台的交互接口
+2. 提供统一的消息发送DSL风格接口
+{!--< /tips >!--}
+"""
+
+import asyncio
+from typing import Any, Optional, Union, Awaitable
+
+class SendDSL:
+    """
+    消息发送DSL基类
+    
+    用于实现 Send.To(...).Func(...) 风格的链式调用接口
+    
+    {!--< tips >!--}
+    1. 子类应实现具体的消息发送方法(如Text, Image等)
+    2. 通过__getattr__实现动态方法调用
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, adapter: BaseAdapter, target_type: Optional[str] = ..., target_id: Optional[str] = ..., account_id: Optional[str] = ...) -> ...:
+        """
+        初始化DSL发送器
+        
+        :param adapter: 所属适配器实例
+        :param target_type: 目标类型(可选)
+        :param target_id: 目标ID(可选)
+        :param _account_id: 发送账号(可选)
+        """
+        ...
+    def To(self: object, target_type: str = ..., target_id: Union[(str, int)] = ...) -> SendDSL:
+        """
+        设置消息目标
+        
+        :param target_type: 目标类型(可选)
+        :param target_id: 目标ID(可选)
+        :return: SendDSL实例
+        
+        :example:
+        >>> adapter.Send.To("user", "123").Text("Hello")
+        >>> adapter.Send.To("123").Text("Hello")  # 简化形式
+        """
+        ...
+    def Using(self: object, account_id: Union[(str, int)]) -> SendDSL:
+        """
+        设置发送账号
+        
+        :param _account_id: 发送账号
+        :return: SendDSL实例
+        
+        :example:
+        >>> adapter.Send.Using("bot1").To("123").Text("Hello")
+        >>> adapter.Send.To("123").Using("bot1").Text("Hello")  # 支持乱序
+        """
+        ...
+    def Account(self: object, account_id: Union[(str, int)]) -> SendDSL:
+        """
+        设置发送账号
+        
+        :param _account_id: 发送账号
+        :return: SendDSL实例
+        
+        :example:
+        >>> adapter.Send.Account("bot1").To("123").Text("Hello")
+        >>> adapter.Send.To("123").Account("bot1").Text("Hello")  # 支持乱序
+        """
+        ...
+
+class BaseAdapter:
+    """
+    适配器基类
+    
+    提供与外部平台交互的标准接口，子类必须实现必要方法
+    
+    {!--< tips >!--}
+    1. 必须实现call_api, start和shutdown方法
+    2. 可以自定义Send类实现平台特定的消息发送逻辑
+    3. 通过on装饰器注册事件处理器
+    4. 支持OneBot12协议的事件处理
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        ...
+    async def call_api(self: object, endpoint: str, **params: Any) -> Any:
+        """
+        调用平台API的抽象方法
+        
+        :param endpoint: API端点
+        :param params: API参数
+        :return: API调用结果
+        :raises NotImplementedError: 必须由子类实现
+        """
+        ...
+    async def start(self: object) -> None:
+        """
+        启动适配器的抽象方法
+        
+        :raises NotImplementedError: 必须由子类实现
+        """
+        ...
+    async def shutdown(self: object) -> None:
+        """
+        关闭适配器的抽象方法
+        
+        :raises NotImplementedError: 必须由子类实现
+        """
+        ...
+    async def emit(self: object) -> None:
+        ...
+    def send(self: object, target_type: str, target_id: str, message: Any, **kwargs: Any) -> asyncio.Task:
+        """
+        发送消息的便捷方法，返回一个 asyncio Task
+        
+        :param target_type: 目标类型
+        :param target_id: 目标ID
+        :param message: 消息内容
+        :param kwargs: 其他参数
+            - method: 发送方法名(默认为"Text")
+        :return: asyncio.Task 对象，用户可以自主决定是否等待
+        
+        :raises AttributeError: 当发送方法不存在时抛出
+            
+        :example:
+        >>> task = adapter.send("user", "123", "Hello")
+        >>> # 用户可以选择等待: result = await task
+        >>> # 或者不等待让其在后台执行
+        >>> await adapter.send("group", "456", "Hello", method="Markdown")  # 直接等待
+        """
+        ...

ErisPulse/Core/Bases/manager.py

@@ -0,0 +1,136 @@
+"""
+ErisPulse 管理器基类
+
+提供适配器和模块管理器的统一接口定义
+
+{!--< tips >!--}
+适配器管理器和模块管理器都应继承此基类以保持接口一致性
+{!--< /tips >!--}
+"""
+
+from abc import ABC, abstractmethod
+from typing import Dict, List, Any, Type, Optional
+
+
+class ManagerBase(ABC):
+    """
+    管理器基类
+    
+    定义适配器和模块管理器的统一接口
+    
+    {!--< tips >!--}
+    统一方法：
+    - register(): 注册类
+    - unregister(): 取消注册
+    - get(): 获取实例
+    - exists(): 检查是否存在
+    - enable()/disable(): 启用/禁用
+    - is_enabled(): 检查是否启用
+    - list_*(): 列出相关项
+    {!--< /tips >!--}
+    """
+    
+    # ==================== 注册与取消注册 ====================
+    
+    @abstractmethod
+    def register(self, name: str, class_type: Type, info: Optional[Dict] = None) -> bool:
+        """
+        注册类
+        
+        :param name: 名称
+        :param class_type: 类类型
+        :param info: 额外信息
+        :return: 是否注册成功
+        """
+        ...
+    
+    @abstractmethod
+    def unregister(self, name: str) -> bool:
+        """
+        取消注册
+        
+        :param name: 名称
+        :return: 是否取消成功
+        """
+        ...
+    
+    # ==================== 实例获取 ====================
+    
+    @abstractmethod
+    def get(self, name: str) -> Any:
+        """
+        获取实例
+        
+        :param name: 名称
+        :return: 实例或 None
+        """
+        ...
+    
+    # ==================== 存在性检查 ====================
+    
+    @abstractmethod
+    def exists(self, name: str) -> bool:
+        """
+        检查是否存在（在配置中注册）
+        
+        :param name: 名称
+        :return: 是否存在
+        """
+        ...
+    
+    # ==================== 启用/禁用管理 ====================
+    
+    @abstractmethod
+    def is_enabled(self, name: str) -> bool:
+        """
+        检查是否启用
+        
+        :param name: 名称
+        :return: 是否启用
+        """
+        ...
+    
+    @abstractmethod
+    def enable(self, name: str) -> bool:
+        """
+        启用
+        
+        :param name: 名称
+        :return: 是否成功
+        """
+        ...
+    
+    @abstractmethod
+    def disable(self, name: str) -> bool:
+        """
+        禁用
+        
+        :param name: 名称
+        :return: 是否成功
+        """
+        ...
+    
+    # ==================== 列表方法 ====================
+    
+    @abstractmethod
+    def list_registered(self) -> List[str]:
+        """
+        列出所有已注册的项
+        
+        :return: 名称列表
+        """
+        ...
+    
+    @abstractmethod
+    def list_items(self) -> Dict[str, bool]:
+        """
+        列出所有项及其状态
+        
+        :return: {名称: 是否启用} 字典
+        """
+        ...
+
+
+__all__ = [
+    "ManagerBase"
+]