ErisPulse 2.3.2__py3-none-any.whl → 2.3.3__py3-none-any.whl

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/__init__.pyi

@@ -0,0 +1,310 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 主模块
+
+提供SDK核心功能模块加载和初始化功能
+
+{!--< tips >!--}
+1. 使用前请确保已正确安装所有依赖
+2. 调用await sdk.init()进行初始化
+3. 模块加载采用懒加载机制
+{!--< /tips >!--}
+"""
+
+import os
+import sys
+import types
+import importlib
+import asyncio
+import inspect
+import importlib.metadata
+from typing import Dict, List, Tuple, Type, Any, TYPE_CHECKING
+from pathlib import Path
+from .Core import Event
+from .Core import lifecycle, logger, exceptions
+from .Core import storage, env, config
+from .Core import adapter, AdapterFather, BaseAdapter, SendDSL
+from .Core import module
+from .Core import router, adapter_server
+from .Core import ux, UXManager
+
+sdk: SDKProtocol
+
+class LazyModule:
+    """
+    懒加载模块包装器
+    
+    当模块第一次被访问时才进行实例化
+    
+    {!--< tips >!--}
+    1. 模块的实际实例化会在第一次属性访问时进行
+    2. 依赖模块会在被使用时自动初始化
+    3. 对于继承自 BaseModule 的模块，会自动调用生命周期方法
+    {!--< /tips >!--}
+    """
+    def __init__(self: None, module_name: str, module_class: Type, sdk_ref: Any, module_info: Dict[(str, Any)]) -> None:
+        """
+        初始化懒加载包装器
+        
+        :param module_name: str 模块名称
+        :param module_class: Type 模块类
+        :param sdk_ref: Any SDK引用
+        :param module_info: Dict[str, Any] 模块信息字典
+        """
+        ...
+    async def _initialize(self: object) -> ...:
+        """
+        实际初始化模块
+        
+        :raises LazyLoadError: 当模块初始化失败时抛出
+        """
+        ...
+    def _initialize_sync(self: object) -> ...:
+        """
+        同步初始化模块，用于在异步上下文中进行同步调用
+        
+        :raises LazyLoadError: 当模块初始化失败时抛出
+        """
+        ...
+    async def _complete_async_init(self: object) -> ...:
+        """
+        完成异步初始化部分，用于同步初始化后的异步处理
+        
+        这个方法用于处理 module.load 和事件提交等异步操作
+        """
+        ...
+    def _ensure_initialized(self: object) -> None:
+        """
+        确保模块已初始化
+        
+        :raises LazyLoadError: 当模块未初始化时抛出
+        """
+        ...
+    def __getattr__(self: object, name: str) -> Any:
+        """
+        属性访问时触发初始化
+        
+        :param name: str 属性名
+        :return: Any 属性值
+        """
+        ...
+    def __setattr__(self: object, name: str, value: Any) -> None:
+        """
+        属性设置
+        
+        :param name: str 属性名
+        :param value: Any 属性值
+        """
+        ...
+    def __delattr__(self: object, name: str) -> None:
+        """
+        属性删除
+        
+        :param name: str 属性名
+        """
+        ...
+    def __getattribute__(self: object, name: str) -> Any:
+        """
+        属性访问，初始化后直接委托给实际实例
+        
+        :param name: str 属性名
+        :return: Any 属性值
+        """
+        ...
+    def __dir__(self: object) -> List[str]:
+        """
+        返回模块属性列表
+        
+        :return: List[str] 属性列表
+        """
+        ...
+    def __repr__(self: object) -> str:
+        """
+        返回模块表示字符串
+        
+        :return: str 表示字符串
+        """
+        ...
+    def __call__(self: object, *args: ..., **kwargs: ...) -> ...:
+        """
+        代理函数调用
+        """
+        ...
+
+class AdapterLoader:
+    """
+    适配器加载器
+    
+    专门用于从PyPI包加载和初始化适配器
+    
+    {!--< tips >!--}
+    1. 适配器必须通过entry-points机制注册到erispulse.adapter组
+    2. 适配器类必须继承BaseAdapter
+    3. 适配器不适用懒加载
+    {!--< /tips >!--}
+    """
+    async def load() -> Tuple[(Dict[(str, object)], List[str], List[str])]:
+        """
+        从PyPI包entry-points加载适配器
+        
+        :return: 
+            Dict[str, object]: 适配器对象字典 {适配器名: 模块对象}
+            List[str]: 启用的适配器名称列表
+            List[str]: 停用的适配器名称列表
+            
+        :raises ImportError: 当无法加载适配器时抛出
+        """
+        ...
+
+class ModuleLoader:
+    """
+    模块加载器
+    
+    专门用于从PyPI包加载和初始化普通模块
+    
+    {!--< tips >!--}
+    1. 模块必须通过entry-points机制注册到erispulse.module组
+    2. 模块类名应与entry-point名称一致
+    {!--< /tips >!--}
+    """
+    async def load() -> Tuple[(Dict[(str, object)], List[str], List[str])]:
+        """
+        从PyPI包entry-points加载模块
+        
+        :return: 
+            Dict[str, object]: 模块对象字典 {模块名: 模块对象}
+            List[str]: 启用的模块名称列表
+            List[str]: 停用的模块名称列表
+            
+        :raises ImportError: 当无法加载模块时抛出
+        """
+        ...
+    def _should_lazy_load(module_class: Type) -> bool:
+        """
+        检查模块是否应该懒加载
+        
+        :param module_class: Type 模块类
+        :return: bool 如果返回 False，则立即加载；否则懒加载
+        """
+        ...
+
+class ModuleInitializer:
+    """
+    模块初始化器（注意：适配器是一个特殊的模块）
+    
+    负责协调适配器和模块的初始化流程
+    
+    {!--< tips >!--}
+    1. 初始化顺序：适配器 → 模块
+    2. 模块初始化采用懒加载机制
+    {!--< /tips >!--}
+    """
+    async def init() -> bool:
+        """
+        初始化所有模块和适配器
+        
+        执行步骤:
+        1. 从PyPI包加载适配器
+        2. 从PyPI包加载模块
+        3. 预记录所有模块信息
+        4. 注册适配器
+        5. 初始化各模块
+        
+        :return: bool 初始化是否成功
+        :raises InitError: 当初始化失败时抛出
+        """
+        ...
+
+async def init_progress() -> bool:
+    """
+    初始化项目环境文件
+    
+    1. 检查并创建main.py入口文件
+    2. 确保基础目录结构存在
+    
+    :return: bool 是否创建了新的main.py文件
+    
+    {!--< tips >!--}
+    1. 如果main.py已存在则不会覆盖
+    2. 此方法通常由SDK内部调用
+    {!--< /tips >!--}
+    """
+    ...
+
+async def init() -> bool:
+    """
+    SDK初始化入口
+    
+    :return: bool SDK初始化是否成功
+    """
+    ...
+
+def init_sync() -> bool:
+    """
+    SDK初始化入口（同步版本）
+    
+    用于命令行直接调用，自动在事件循环中运行异步初始化
+    
+    :return: bool SDK初始化是否成功
+    """
+    ...
+
+def init_task() -> asyncio.Task:
+    """
+    SDK初始化入口，返回Task对象
+    
+    :return: asyncio.Task 初始化任务
+    """
+    ...
+
+async def uninit() -> bool:
+    """
+    SDK反初始化
+    
+    执行以下操作：
+    1. 关闭所有适配器
+    2. 卸载所有模块
+    3. 清理所有事件处理器
+    4. 清理僵尸线程
+    
+    :return: bool 反初始化是否成功
+    """
+    ...
+
+async def restart() -> bool:
+    """
+    SDK重新启动
+    
+    执行完整的反初始化后再初始化过程
+    
+    :return: bool 重新加载是否成功
+    """
+    ...
+
+async def run(keep_running: bool = ...) -> None:
+    """
+    无头模式运行ErisPulse
+    
+    此方法提供了一种无需入口启动的方式，适用于与其它框架集成的场景
+    """
+    ...
+
+async def load_module(module_name: str) -> bool:
+    """
+    手动加载指定模块
+    
+    :param module_name: str 要加载的模块名称
+    :return: bool 加载是否成功
+    
+    {!--< tips >!--}
+    1. 可用于手动触发懒加载模块的初始化
+    2. 如果模块不存在或已加载会返回False
+    3. 对于需要异步初始化的模块，这是唯一的加载方式
+    {!--< /tips >!--}
+    """
+    ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/__main__.pyi

@@ -0,0 +1,24 @@
+# type: ignore
+#
+# Auto-generated type stub for __main__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 命令行工具
+
+提供ErisPulse生态系统的包管理、模块控制和开发工具功能。
+"""
+
+from .utils import CLI
+
+def main() -> ...:
+    """
+    CLI入口点
+    
+    {!--< tips >!--}
+    1. 创建CLI实例并运行
+    2. 处理全局异常
+    {!--< /tips >!--}
+    """
+    ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/sdk_protocol.pyi

@@ -0,0 +1,100 @@
+# type: ignore
+#
+# Auto-generated type stub for sdk_protocol.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK Protocol 定义
+
+提供 SDK 的类型接口定义，用于 IDE 类型提示和静态类型检查
+"""
+
+from typing import Protocol, runtime_checkable, Any, TypeVar
+from typing_extensions import ParamSpec
+import asyncio
+from .Core.Event import Event as EventType
+from .Core.lifecycle import LifecycleManager
+from .Core.logger import Logger
+from .Core.storage import StorageManager
+from .Core.config import ConfigManager
+from .Core.adapter import AdapterManager
+from .Core.module import ModuleManager
+from .Core.router import RouterManager
+from .Core.ux import UXManager
+from .Core.Bases.adapter import BaseAdapter, SendDSL
+
+class SDKProtocol(Protocol):
+    """
+    SDK 对象的 Protocol 接口定义
+    
+    定义了 SDK 对象应该具有的所有属性和方法，用于类型检查
+    """
+    Event: type[EventType]
+    lifecycle: LifecycleManager
+    logger: Logger
+    exceptions: Any
+    storage: StorageManager
+    env: StorageManager
+    config: ConfigManager
+    adapter: AdapterManager
+    AdapterFather: type[BaseAdapter]
+    BaseAdapter: type[BaseAdapter]
+    SendDSL: type[SendDSL]
+    module: ModuleManager
+    router: RouterManager
+    adapter_server: RouterManager
+    ux: UXManager
+    UXManager: type[UXManager]
+    async def init(self: object) -> bool:
+        """
+        SDK初始化入口
+        
+        :return: bool SDK初始化是否成功
+        """
+        ...
+    def init_task(self: object) -> asyncio.Task:
+        """
+        SDK初始化入口，返回Task对象
+        
+        :return: asyncio.Task 初始化任务
+        """
+        ...
+    async def load_module(self: object, module_name: str) -> bool:
+        """
+        手动加载指定模块
+        
+        :param module_name: str 要加载的模块名称
+        :return: bool 加载是否成功
+        """
+        ...
+    async def run(self: object, keep_running: bool = ...) -> None:
+        """
+        无头模式运行ErisPulse
+        
+        :param keep_running: bool 是否保持运行
+        """
+        ...
+    async def restart(self: object) -> bool:
+        """
+        SDK重新启动
+        
+        :return: bool 重新加载是否成功
+        """
+        ...
+    async def uninit(self: object) -> bool:
+        """
+        SDK反初始化
+        
+        :return: bool 反初始化是否成功
+        """
+        ...
+
+def check_sdk_compatible(obj: Any) -> bool:
+    """
+    检查对象是否符合 SDK Protocol
+    
+    :param obj: 要检查的对象
+    :return: bool 是否符合协议
+    """
+    ...

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/utils/__init__.pyi

@@ -0,0 +1,16 @@
+# type: ignore
+#
+# Auto-generated type stub for __init__.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+"""
+ErisPulse SDK 工具模块
+
+包含各种辅助工具和实用程序。
+"""
+
+from .package_manager import PackageManager
+from .reload_handler import ReloadHandler
+from .cli import CLI
+from .console import console

erispulse-2.3.3.data/data/ErisPulse-stubs/ErisPulse/utils/cli.pyi

@@ -0,0 +1,145 @@
+# type: ignore
+#
+# Auto-generated type stub for cli.py
+# DO NOT EDIT MANUALLY - Generated by generate-type-stubs.py
+#
+
+import argparse
+import importlib.metadata
+import sys
+import os
+import time
+import asyncio
+from typing import List, Dict, Optional, Any
+from watchdog.observers import Observer
+from rich.panel import Panel
+from rich.table import Table
+from rich.prompt import Confirm, Prompt
+from rich.box import SIMPLE
+from .console import console
+
+class CLI:
+    """
+    ErisPulse命令行接口
+    
+    提供完整的命令行交互功能
+    
+    {!--< tips >!--}
+    1. 支持动态加载第三方命令
+    2. 支持模块化子命令系统
+    {!--< /tips >!--}
+    """
+    def __init__(self: None) -> ...:
+        """
+        初始化CLI
+        """
+        ...
+    def _create_parser(self: object) -> argparse.ArgumentParser:
+        """
+        创建命令行参数解析器
+        
+        :return: 配置好的ArgumentParser实例
+        """
+        ...
+    def _get_external_commands(self: object) -> List[str]:
+        """
+        获取所有已注册的第三方命令名称
+        
+        :return: 第三方命令名称列表
+        """
+        ...
+    def _load_external_commands(self: object, subparsers: ...) -> ...:
+        """
+        加载第三方CLI命令
+        
+        :param subparsers: 子命令解析器
+        
+        :raises ImportError: 加载命令失败时抛出
+        """
+        ...
+    def _print_version(self: object) -> ...:
+        """
+        打印版本信息
+        """
+        ...
+    def _print_installed_packages(self: object, pkg_type: str, outdated_only: bool = ...) -> ...:
+        """
+        打印已安装包信息
+        
+        :param pkg_type: 包类型 (modules/adapters/cli/all)
+        :param outdated_only: 是否只显示可升级的包
+        """
+        ...
+    def _print_remote_packages(self: object, pkg_type: str) -> ...:
+        """
+        打印远程包信息
+        
+        :param pkg_type: 包类型 (modules/adapters/cli/all)
+        """
+        ...
+    def _is_package_outdated(self: object, package_name: str, current_version: str) -> bool:
+        """
+        检查包是否过时
+        
+        :param package_name: 包名
+        :param current_version: 当前版本
+        :return: 是否有新版本可用
+        """
+        ...
+    def _resolve_package_name(self: object, short_name: str) -> Optional[str]:
+        """
+        解析简称到完整包名（大小写不敏感）
+        
+        :param short_name: 模块/适配器简称
+        :return: 完整包名，未找到返回None
+        """
+        ...
+    def _print_search_results(self: object, query: str, results: Dict[(str, List[Dict[(str, str)]])]) -> ...:
+        """
+        打印搜索结果
+        
+        :param query: 搜索关键词
+        :param results: 搜索结果
+        """
+        ...
+    def _print_version_list(self: object, versions: List[Dict[(str, Any)]], include_pre: bool = ...) -> ...:
+        """
+        打印版本列表
+        
+        :param versions: 版本信息列表
+        :param include_pre: 是否包含预发布版本
+        """
+        ...
+    def _setup_watchdog(self: object, script_path: str, reload_mode: bool) -> ...:
+        """
+        设置文件监控
+        
+        :param script_path: 要监控的脚本路径
+        :param reload_mode: 是否启用重载模式
+        """
+        ...
+    def _cleanup(self: object) -> ...:
+        """
+        清理资源
+        """
+        ...
+    def run(self: object) -> ...:
+        """
+        运行CLI
+        
+        :raises KeyboardInterrupt: 用户中断时抛出
+        :raises Exception: 命令执行失败时抛出
+        """
+        ...
+
+def _cleanup_adapters() -> ...:
+    """
+    清理适配器资源
+    """
+    ...
+
+def _cleanup_modules() -> ...:
+    """
+    清理模块资源
+    """
+    ...

erispulse-2.3.3.data/data/ErisPulse-stubs/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 >!--}
+    """
+    ...