ErisPulse 1.1.8__py3-none-any.whl → 1.1.11__py3-none-any.whl

ErisPulse/adapter.py

@@ -47,7 +47,7 @@ class BaseAdapter:
         # 绑定当前适配器的 Send 实例
         self.Send = self.__class__.Send(self)
 
-    def on(self, event_type: str):
+    def on(self, event_type: str = "*"):
         def decorator(func: Callable):
             @functools.wraps(func)
             async def wrapper(*args, **kwargs):
@@ -69,11 +69,32 @@ class BaseAdapter:
     async def shutdown(self):
         raise NotImplementedError
 
+    def add_handler(self, *args):
+        if len(args) == 1:
+            event_type = "*"
+            handler = args[0]
+        elif len(args) == 2:
+            event_type, handler = args
+        else:
+            raise TypeError("add_handler() 接受 1 个（监听所有事件）或 2 个参数（指定事件类型）")
+
+        @functools.wraps(handler)
+        async def wrapper(*handler_args, **handler_kwargs):
+            return await handler(*handler_args, **handler_kwargs)
+
+        self._handlers[event_type].append(wrapper)
     async def emit(self, event_type: str, data: Any):
+        # 先执行中间件
         for middleware in self._middlewares:
             data = await middleware(data)
 
-        for handler in self._handlers.get(event_type, []):
+        # 触发具体事件类型的处理器
+        if event_type in self._handlers:
+            for handler in self._handlers[event_type]:
+                await handler(data)
+
+        # 触发通配符 "*" 的处理器
+        for handler in self._handlers.get("*", []):
             await handler(data)
 
     async def send(self, target_type: str, target_id: str, message: Any, **kwargs):
@@ -107,6 +128,17 @@ class AdapterManager:
         self._adapters[platform] = instance
         self._platform_to_instance[platform] = instance
 
+        if len(platform) <= 10:
+            from itertools import product
+            combinations = [''.join(c) for c in product(*[(ch.lower(), ch.upper()) for ch in platform])]
+            for name in set(combinations):
+                setattr(self, name, instance)
+        else:
+            self.logger.warning(f"平台名 {platform} 过长，如果您是开发者，请考虑使用更短的名称")
+            setattr(self, platform.lower(), instance)
+            setattr(self, platform.upper(), instance)
+            setattr(self, platform.capitalize(), instance)
+
         return True
 
     async def startup(self, platforms: List[str] = None):
@@ -131,8 +163,6 @@ class AdapterManager:
 
     async def _run_adapter(self, adapter: BaseAdapter, platform: str):
         from . import sdk
-        retry_count = 0
-        max_retry = 3
 
         # 加锁防止并发启动
         if not getattr(adapter, "_starting_lock", None):
@@ -144,34 +174,51 @@ class AdapterManager:
                 sdk.logger.info(f"适配器 {platform}（实例ID: {id(adapter)}）已被其他协程启动，跳过")
                 return
 
-            while retry_count < max_retry:
+            retry_count = 0
+            fixed_delay = 3 * 60 * 60
+            backoff_intervals = [60, 10 * 60, 30 * 60, 60 * 60]
+
+            while True:
                 try:
                     await adapter.start()
                     self._started_instances.add(adapter)
                     sdk.logger.info(f"适配器 {platform}（实例ID: {id(adapter)}）已启动")
-                    break
+                    return
                 except Exception as e:
                     retry_count += 1
                     sdk.logger.error(f"平台 {platform} 启动失败（第{retry_count}次重试）: {e}")
+
                     try:
                         await adapter.shutdown()
                     except Exception as stop_err:
                         sdk.logger.warning(f"停止适配器失败: {stop_err}")
 
-                    if retry_count >= max_retry:
-                        sdk.logger.critical(f"平台 {platform} 达到最大重试次数，放弃重启")
-                        raise sdk.raiserr.AdapterStartFailedError(f"平台 {platform} 适配器无法重写启动: {e}")
+                    # 计算等待时间
+                    if retry_count <= len(backoff_intervals):
+                        wait_time = backoff_intervals[retry_count - 1]
+                    else:
+                        wait_time = fixed_delay
+
+                    sdk.logger.info(f"将在 {wait_time // 60} 分钟后再次尝试重启 {platform}")
+                    await asyncio.sleep(wait_time)
+
     async def shutdown(self):
         for adapter in self._adapters.values():
             await adapter.shutdown()
 
     def get(self, platform: str) -> BaseAdapter:
-        return self._adapters.get(platform)
+        platform_lower = platform.lower()
+        for registered, instance in self._adapters.items():
+            if registered.lower() == platform_lower:
+                return instance
+        return None
 
     def __getattr__(self, platform: str) -> BaseAdapter:
-        if platform not in self._adapters:
-            raise AttributeError(f"平台 {platform} 的适配器未注册")
-        return self._adapters[platform]
+        platform_lower = platform.lower()
+        for registered, instance in self._adapters.items():
+            if registered.lower() == platform_lower:
+                return instance
+        raise AttributeError(f"平台 {platform} 的适配器未注册")
 
     @property
     def platforms(self) -> list:

ErisPulse/db.py

@@ -113,9 +113,12 @@ from ErisPulse import sdk
             try:
                 with open(env_file, "w", encoding="utf-8") as f:
                     f.write(content)
-                self.logger.info("已自动生成 env.py 文件")
+                return True
             except Exception as e:
-                self.logger.error(f"无法创建 env.py 文件: {e}")
+                from . import sdk
+                sdk.logger.error(f"无法创建 env.py 文件: {e}")
+                return False
+        return False
 
     def __getattr__(self, key):
         try:

ErisPulse/mods.py

@@ -27,6 +27,11 @@ class ModuleManager:
     def set_module_status(self, module_name: str, status: bool) -> None:
         self.env.set(f"{self.status_prefix}{module_name}", bool(status))
 
+        module_info = self.get_module(module_name)
+        if module_info:
+            module_info["status"] = bool(status)
+            self.env.set(f"{self.module_prefix}{module_name}", module_info)
+
     def get_module_status(self, module_name: str) -> bool:
         status = self.env.get(f"{self.status_prefix}{module_name}", True)
         if isinstance(status, str):

ErisPulse/util.py

@@ -25,9 +25,35 @@ def topological_sort(elements, dependencies, error):
                 queue.append(neighbor)
     if len(sorted_list) != len(elements):
         from . import sdk
-        sdk.logger.error(f"Topological sort failed: {sorted_list} vs {elements}")
+        sdk.logger.error(f"依赖导入错误: {elements} vs  {sorted_list} | 发生了循环依赖")
     return sorted_list
 
+def show_topology():
+    from . import sdk
+    dep_data = sdk.env.get('module_dependencies')
+    if not dep_data:
+        return "未找到模块依赖关系数据，请先运行sdk.init()"
+        
+    sorted_modules = topological_sort(
+        dep_data['modules'], 
+        dep_data['dependencies'], 
+        sdk.raiserr.CycleDependencyError
+    )
+    
+    tree = {}
+    for module in sorted_modules:
+        tree[module] = dep_data['dependencies'].get(module, [])
+    
+    result = ["模块拓扑关系表:"]
+    for i, module in enumerate(sorted_modules, 1):
+        deps = dep_data['dependencies'].get(module, [])
+        indent = "  " * (len(deps) if deps else 0)
+        result.append(f"{i}. {indent}{module}")
+        if deps:
+            result.append(f"   {indent}└─ 依赖: {', '.join(deps)}")
+    
+    return "\n".join(result)
+
 def ExecAsync(async_func, *args, **kwargs):
     loop = asyncio.get_event_loop()
     return loop.run_in_executor(executor, lambda: asyncio.run(async_func(*args, **kwargs)))
@@ -70,4 +96,4 @@ def retry(max_attempts=3, delay=1):
                         raise
                     time.sleep(delay)
         return wrapper
-    return decorator
+    return decorator

{erispulse-1.1.8.dist-info → erispulse-1.1.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 1.1.8
+Version: 1.1.11
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 Classifier: Development Status :: 5 - Production/Stable
@@ -18,11 +18,23 @@ Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: aiohttp
+Requires-Dist: watchdog
+Dynamic: license-file
 
 ![](./.github/assets/erispulse_logo.png)
+**ErisPulse** 是基于 [Framer](https://github.com/FramerOrg/Framer) 构建的异步机器人开发框架。
+
+## 合作伙伴
+[![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
+
+### 框架选型指南
+| 需求          | 推荐框架       | 理由                          |
+|-------------------|----------------|-----------------------------|
+| 轻量化/底层模块化 | [Framer](https://github.com/FramerOrg/Framer) | 高度解耦的模块化设计          |
+| 全功能机器人开发  | ErisPulse      | 开箱即用的完整解决方案        |
 
-基于 [RyhBotPythonSDK V2](https://github.com/runoneall/RyhBotPythonSDK2) 构建，由 [sdkFrame](https://github.com/runoneall/sdkFrame) 提供支持的异步机器人开发框架。
 
 ## ✨ 核心特性
 - ⚡ 完全异步架构设计（async/await）
@@ -48,7 +60,7 @@ from ErisPulse import sdk, logger
 async def main():
     sdk.init()
     logger.info("ErisPulse 已启动")
-    # 这里可以添加自定义逻辑 | 如模块的 AddHandle，AddTrigger 等
+    # 这里可以添加自定义逻辑
 
 if __name__ == "__main__":
     asyncio.run(main())

erispulse-1.1.11.dist-info/RECORD

@@ -0,0 +1,14 @@
+ErisPulse/__init__.py,sha256=tCgjl-0rUeiHV_2rdFlQ-CVTFzbKdjdqXvUApRc6Avk,8095
+ErisPulse/__main__.py,sha256=ZdrOqsZU1C5wJ4CycTge9l7IUldVUDtak17yWRxnxhs,47728
+ErisPulse/adapter.py,sha256=slwStdR8fNPp72o5miut9ffLjwekfljzq0c1qkA1tmg,8625
+ErisPulse/db.py,sha256=DuIc19GbCQMi17BWfLjaDHnthIbdysTSRxaYVFur07w,4424
+ErisPulse/logger.py,sha256=sMA1mUZvwJ8wHwdyCrgIf_VRICv_uBCkx3tmd1stF3E,6094
+ErisPulse/mods.py,sha256=lNiZP2EcfUhYRnOQwROyVnmhsfmk8JAZhmbhxfC2-VQ,3513
+ErisPulse/raiserr.py,sha256=z8BigWkVrBE9dD_dJa5np2YYREwdugyWXKE4_-LEO_Q,2616
+ErisPulse/util.py,sha256=ux3-QRT0_JjabL6S9KChhyR1E_CSRiVYEFYV5txML1M,3406
+erispulse-1.1.11.dist-info/licenses/LICENSE,sha256=plj4EYVfKAzc0ZWoC5T2vsQ86u0yLpu17NdAPeIcgVo,1066
+erispulse-1.1.11.dist-info/METADATA,sha256=6_XH6PEXuF2kNGuorHF1msyRdF6R1iyybLRx0OegrXk,2751
+erispulse-1.1.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+erispulse-1.1.11.dist-info/entry_points.txt,sha256=AjKvOdYR7QGXVpEJhjUYUwV2JluE4lm9vNbknC3hjOM,155
+erispulse-1.1.11.dist-info/top_level.txt,sha256=Lm_qtkVvNJR8_dXh_qEDdl_12cZGpic-i4HUlVVUMZc,10
+erispulse-1.1.11.dist-info/RECORD,,

erispulse-1.1.11.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ErisPulse
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

erispulse-1.1.8.dist-info/RECORD

@@ -1,13 +0,0 @@
-ErisPulse/__init__.py,sha256=wNfAnZu0-jFzCLyQhfiXvj7lb0DxSLmRCBUowxUYJW0,7783
-ErisPulse/__main__.py,sha256=-UdhsYP_X7EagomCjo73Y_qQdXwtMbDS5KoOSrI-OcU,32181
-ErisPulse/adapter.py,sha256=u7XdJxIEHxGRh4RXwTX-vv1R1_oP0M6ZJBehe3rKi0I,6807
-ErisPulse/db.py,sha256=OIndsysBOUfSyGMhKs-YVYj9dv5D92YIAltM0ZmwrkA,4379
-ErisPulse/logger.py,sha256=sMA1mUZvwJ8wHwdyCrgIf_VRICv_uBCkx3tmd1stF3E,6094
-ErisPulse/mods.py,sha256=M9XQWUQYNZ11m845hxbewBAauWXnysy-aOdLwb5xy_M,3312
-ErisPulse/raiserr.py,sha256=z8BigWkVrBE9dD_dJa5np2YYREwdugyWXKE4_-LEO_Q,2616
-ErisPulse/util.py,sha256=b9TqyRZKkpclN2fkHmWqBl3lnBMnUbucMvKvbqD5Ws8,2541
-erispulse-1.1.8.dist-info/METADATA,sha256=UnKdj5QcnPTnmW0zRHWo2mxUME2CjJSM9ffcB1UUQNM,2282
-erispulse-1.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-erispulse-1.1.8.dist-info/entry_points.txt,sha256=AjKvOdYR7QGXVpEJhjUYUwV2JluE4lm9vNbknC3hjOM,155
-erispulse-1.1.8.dist-info/top_level.txt,sha256=Lm_qtkVvNJR8_dXh_qEDdl_12cZGpic-i4HUlVVUMZc,10
-erispulse-1.1.8.dist-info/RECORD,,