ErisPulse 2.4.6.dev3__tar.gz → 2.4.6.dev4__tar.gz

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.4.6.dev3
+Version: 2.4.6.dev4
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: ErisDev <erisdev@88.com>
 Maintainer-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ErisPulse"
-version = "2.4.6-dev.3"
+version = "2.4.6-dev.4"
 description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。"
 readme = "README.md"
 requires-python = ">=3.10"

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/CLI/commands/run.py

@@ -116,28 +116,50 @@ class RunCommand(Command):
         else:
             self._run_internal(reload_mode)
 
+    _RESTART_EXIT_CODE = 42
+
     def _run_internal(self, reload_mode: bool):
         """
         直接运行 SDK（不指定脚本时）
+
+        以子进程方式运行 SDK，支持硬重启：当 SDK 进程以特定退出码退出时，
+        自动重新启动新进程，确保资源完全释放。
         """
 
-        async def _run():
-            from ... import sdk
+        if reload_mode:
+            async def _run():
+                from ... import sdk
 
-            if reload_mode:
                 loop = asyncio.get_running_loop()
                 self._setup_watchdog(".", loop)
+                await sdk.run(keep_running=True)
 
-            await sdk.run(keep_running=True)
+            try:
+                asyncio.run(_run())
+            except KeyboardInterrupt:
+                pass
+            finally:
+                if hasattr(self, "_observer"):
+                    self._observer.stop()
+                    self._observer.join()
+            return
+
+        cmd = [sys.executable, "-c",
+               "import asyncio; from ErisPulse import sdk; "
+               "asyncio.run(sdk.run(keep_running=True))"]
 
         try:
-            asyncio.run(_run())
+            while True:
+                process = subprocess.Popen(cmd)
+                process.wait()
+
+                if process.returncode == self._RESTART_EXIT_CODE:
+                    console.print("[info]收到硬重启请求，正在重新启动...[/]")
+                    time.sleep(0.5)
+                    continue
+                break
         except KeyboardInterrupt:
             pass
-        finally:
-            if reload_mode and hasattr(self, "_observer"):
-                self._observer.stop()
-                self._observer.join()
 
     def _run_script(self, script_path: str, reload_mode: bool):
         script_path_abs = os.path.abspath(script_path)

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/CLI/commands/run.pyi

@@ -53,6 +53,9 @@ class RunCommand(Command):
     def _run_internal(self: object, reload_mode: bool) -> ...:
         """
         直接运行 SDK（不指定脚本时）
+        
+        以子进程方式运行 SDK，支持硬重启：当 SDK 进程以特定退出码退出时，
+        自动重新启动新进程，确保资源完全释放。
         """
         ...
     def _run_script(self: object, script_path: str, reload_mode: bool) -> ...:

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/adapter.py

@@ -135,24 +135,32 @@ class AdapterManager(ManagerBase):
         if existing_instance is not None:
             self._adapters[platform] = existing_instance
         else:
-            # 创建适配器实例
-            # 检查适配器类 __init__ 方法的参数
-            init_signature = inspect.signature(adapter_class.__init__)
-            params = [p for p in init_signature.parameters.values() if p.name != "self"]
-
-            sdk_to_use = self._sdk
-            if sdk_to_use is None:
-                from .. import sdk
-
-                sdk_to_use = sdk
-
-            # 根据参数情况创建实例
-            if params:
-                instance = adapter_class(sdk_to_use)
-            else:
-                instance = adapter_class()
-
-            self._adapters[platform] = instance
+            try:
+                # 创建适配器实例
+                # 检查适配器类 __init__ 方法的参数
+                init_signature = inspect.signature(adapter_class.__init__)
+                params = [p for p in init_signature.parameters.values() if p.name != "self"]
+
+                sdk_to_use = self._sdk
+                if sdk_to_use is None:
+                    from .. import sdk
+
+                    sdk_to_use = sdk
+            
+                # 根据参数情况创建实例
+                if params:
+                    instance = adapter_class(sdk_to_use)
+                else:
+                    instance = adapter_class()
+
+                self._adapters[platform] = instance
+            except SystemExit as e:
+                logger.error(f"适配器 {platform} 尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                             f"请不要在适配器中使用 sys.exit() 或 raise SystemExit")
+                return False
+            except Exception as e:
+                logger.error(f"创建适配器实例 {platform} 失败: {e}")
+                return False
 
         return True
 

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/Core/module.py

@@ -203,6 +203,18 @@ class ModuleManager(ManagerBase):
             logger.info(f"模块 {module_name} 加载成功")
             return True
 
+        except SystemExit as e:
+            await lifecycle.submit_event(
+                "module.load",
+                data={
+                    "module_name": module_name,
+                    "success": False,
+                },
+                msg=f"模块 {module_name} 尝试退出进程 (SystemExit)",
+            )
+            logger.error(f"模块 {module_name} 尝试退出进程 (SystemExit({e.code}))，已跳过该模块。"
+                         f"请不要在模块中使用 sys.exit() 或 raise SystemExit，请改用 raise RuntimeError 或返回错误")
+            return False
         except Exception as e:
             await lifecycle.submit_event(
                 "module.load",

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/loaders/adapter.py

@@ -91,8 +91,10 @@ class AdapterLoader(BaseLoader):
 
             logger.print_section_separator()
 
-        except Exception as e:
+        except BaseException as e:
             logger.error(f"加载 {group_name} entry-points 失败: {e}")
+            if isinstance(e, SystemExit):
+                logger.warning(f"拦截到 SystemExit，已阻止进程退出，跳过后续适配器加载")
 
         return objs, enabled_list, disabled_list
 
@@ -172,6 +174,9 @@ class AdapterLoader(BaseLoader):
             objs[meta_name] = adapter_obj
             enabled_list.append(meta_name)
 
+        except SystemExit as e:
+            logger.error(f"加载适配器 {meta_name} 时触发 SystemExit({e.code})，已跳过。"
+                         f"请不要在适配器中使用 sys.exit() 或 raise SystemExit")
         except Exception as e:
             logger.error(f"加载适配器 {meta_name} 失败，已跳过: {e}")
 
@@ -224,6 +229,15 @@ class AdapterLoader(BaseLoader):
                                 data={"platform": platform, "success": True},
                             )
                     return success
+                except SystemExit as e:
+                    logger.error(f"适配器 {name} 注册时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                                 f"请不要使用 sys.exit() 或 raise SystemExit")
+                    await lifecycle.submit_event(
+                        "adapter.load",
+                        msg=f"适配器 {name} 注册时触发 SystemExit",
+                        data={"platform": name, "success": False},
+                    )
+                    return False
                 except Exception as e:
                     logger.error(f"适配器 {name} 注册失败: {e}")
                     # 提交适配器加载失败事件
@@ -243,7 +257,7 @@ class AdapterLoader(BaseLoader):
         failed_adapters = []
         for i, result in enumerate(register_results):
             adapter_name = adapters[i]
-            if isinstance(result, Exception) or result is False:
+            if isinstance(result, BaseException) or result is False:
                 logger.warning(f"适配器 {adapter_name} 注册失败，已跳过")
                 failed_adapters.append(adapter_name)
 

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/loaders/module.py

@@ -93,6 +93,9 @@ class ModuleLoader(BaseLoader):
 
             logger.print_section_separator()
 
+        except SystemExit as e:
+            logger.error(f"加载 {group_name} 时触发 SystemExit({e.code})，已阻止进程退出。"
+                         f"请不要使用 sys.exit() 或 raise SystemExit")
         except Exception as e:
             logger.error(f"加载 {group_name} entry-points 失败: {e}")
 
@@ -191,6 +194,9 @@ class ModuleLoader(BaseLoader):
             objs[meta_name] = module_obj
             enabled_list.append(meta_name)
 
+        except SystemExit as e:
+            logger.error(f"加载模块 {meta_name} 时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                         f"请不要使用 sys.exit() 或 raise SystemExit")
         except Exception as e:
             logger.error(f"从 entry-point 加载模块 {meta_name} 失败，已跳过: {e}")
 
@@ -355,6 +361,10 @@ class ModuleLoader(BaseLoader):
                         manager_instance.register(name, module_class, obj.moduleInfo)
                         return True
                     return False
+                except SystemExit as e:
+                    logger.error(f"注册模块 {name} 时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                                 f"请不要使用 sys.exit() 或 raise SystemExit")
+                    return False
                 except Exception as e:
                     logger.error(f"注册模块 {name} 失败: {e}")
                     return False
@@ -368,7 +378,7 @@ class ModuleLoader(BaseLoader):
         failed_modules = []
         for i, result in enumerate(register_results):
             module_name = modules[i]
-            if isinstance(result, Exception) or result is False:
+            if isinstance(result, BaseException) or result is False:
                 logger.warning(f"模块 {module_name} 注册失败，已跳过")
                 failed_modules.append(module_name)
 
@@ -527,6 +537,9 @@ class ModuleLoader(BaseLoader):
                         logger.debug(f"挂载立即加载模块到 sdk: {meta_name}")
                     else:
                         logger.warning(f"立即加载模块 {meta_name} 失败，已跳过")
+            except SystemExit as e:
+                logger.warning(f"初始化模块 {meta_name} 时尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                               f"请不要使用 sys.exit() 或 raise SystemExit")
             except Exception as e:
                 logger.warning(f"初始化模块 {meta_name} 失败，已跳过: {e}")
 
@@ -655,6 +668,17 @@ class LazyModule:
                 f"懒加载模块 {object.__getattribute__(self, '_module_name')} 初始化完成"
             )
 
+        except SystemExit as e:
+            module_name = object.__getattribute__(self, "_module_name")
+            await lifecycle.submit_event(
+                "module.init",
+                msg=f"模块 {module_name} 尝试退出进程 (SystemExit)",
+                data={"module_name": module_name, "success": False},
+            )
+            logger.error(f"懒加载模块 {module_name} 尝试退出进程 (SystemExit({e.code}))，已跳过。"
+                         f"请不要使用 sys.exit() 或 raise SystemExit")
+            object.__setattr__(self, "_initialized", False)
+            object.__setattr__(self, "_init_failed", True)
         except Exception as e:
             await lifecycle.submit_event(
                 "module.init",
@@ -730,6 +754,9 @@ class LazyModule:
             new_loop = asyncio.new_event_loop()
             try:
                 new_loop.run_until_complete(self._initialize())
+            except SystemExit as e:
+                init_error[0] = e
+                object.__setattr__(self, "_init_failed", True)
             except Exception as e:
                 init_error[0] = e
                 object.__setattr__(self, "_init_failed", True)
@@ -784,6 +811,13 @@ class LazyModule:
                 f"懒加载模块 {object.__getattribute__(self, '_module_name')} 同步初始化完成"
             )
 
+        except SystemExit as e:
+            logger.error(
+                f"懒加载模块 {object.__getattribute__(self, '_module_name')} 尝试退出进程 "
+                f"(SystemExit({e.code}))，已跳过。请不要使用 sys.exit() 或 raise SystemExit"
+            )
+            object.__setattr__(self, "_initialized", False)
+            object.__setattr__(self, "_init_failed", True)
         except Exception as e:
             logger.error(
                 f"懒加载模块 {object.__getattribute__(self, '_module_name')} 同步初始化失败: {e}"

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/sdk.py

@@ -15,6 +15,7 @@ from __future__ import annotations
 
 import asyncio
 import importlib
+import os
 import sys
 from typing import TYPE_CHECKING
 from .Core.constants import UNINIT_SETTLE_DELAY_SECS, LIFECYCLE_TIMER_CORE_INIT, LIFECYCLE_TIMER_CORE_UNINIT
@@ -971,6 +972,39 @@ class SDK:
 
         return True
 
+    RESTART_EXIT_CODE = 42
+
+    async def hard_restart(self) -> bool:
+        """
+        硬重启：反初始化后退出进程，由父进程（run.py）重新启动新实例
+
+        与 restart()（热重启）的区别：
+        - restart(): 在同一进程内反初始化再重新初始化
+        - hard_restart(): 反初始化后退出进程，由父进程重新启动全新进程
+
+        确保资源完全释放
+
+        需要通过 epsdk run 启动才生效，否则进程退出后不会自动重启。
+
+        :return: bool 硬重启任务是否成功调度
+
+        :example:
+        >>> await sdk.hard_restart()
+        """
+
+        async def _do_hard_restart():
+            await asyncio.sleep(0.5)
+            try:
+                self.logger.info("[HardRestart] 开始硬重启，执行反初始化...")
+                await self.uninit()
+                self.logger.info("[HardRestart] 反初始化完成，正在退出进程...")
+            except Exception as e:
+                self.logger.error(f"[HardRestart] 反初始化异常: {e}")
+            os._exit(self.RESTART_EXIT_CODE)
+
+        asyncio.ensure_future(_do_hard_restart())
+        return True
+
     async def uninit(self) -> bool:
         """
         SDK 反初始化

{erispulse-2.4.6.dev3 → erispulse-2.4.6.dev4}/src/ErisPulse/sdk.pyi

@@ -20,6 +20,7 @@ example:
 from __future__ import annotations
 import asyncio
 import importlib
+import os
 import sys
 from typing import TYPE_CHECKING
 from .Core.constants import UNINIT_SETTLE_DELAY_SECS, LIFECYCLE_TIMER_CORE_INIT, LIFECYCLE_TIMER_CORE_UNINIT
@@ -170,6 +171,24 @@ class SDK:
         >>> await sdk.restart()
         """
         ...
+    async def hard_restart(self: object) -> bool:
+        """
+        硬重启：反初始化后退出进程，由父进程（run.py）重新启动新实例
+        
+        与 restart()（热重启）的区别：
+        - restart(): 在同一进程内反初始化再重新初始化
+        - hard_restart(): 反初始化后退出进程，由父进程重新启动全新进程
+        
+        确保资源完全释放
+        
+        需要通过 epsdk run 启动才生效，否则进程退出后不会自动重启。
+        
+        :return: bool 硬重启任务是否成功调度
+        
+        :example:
+        >>> await sdk.hard_restart()
+        """
+        ...
     async def uninit(self: object) -> bool:
         """
         SDK 反初始化