76147bae94
一切皆为插件的开发者工具运行时框架
🧩 核心特性:
- 插件热插拔 (importlib 动态加载)
- 依赖自动解析 (拓扑排序 + 循环检测)
- 企业级稳定 (熔断/降级/重试/隔离)
- 事件驱动 (发布/订阅事件总线)
- 完整配置 (YAML 配置 + 热重载)
93 lines
2.4 KiB
Python
93 lines
2.4 KiB
Python
"""插件类型定义"""
|
|
from abc import ABC, abstractmethod
|
|
from typing import Any, Optional
|
|
|
|
|
|
# ========== 插件自定义类型注册 ==========
|
|
_plugin_types: dict[str, Any] = {}
|
|
|
|
|
|
def register_plugin_type(type_name: str, type_class: Any):
|
|
"""注册插件自定义类型"""
|
|
_plugin_types[type_name] = type_class
|
|
|
|
|
|
def get_plugin_type(type_name: str) -> Optional[Any]:
|
|
"""获取已注册的插件类型"""
|
|
return _plugin_types.get(type_name)
|
|
|
|
|
|
def list_plugin_types() -> dict[str, Any]:
|
|
"""列出所有已注册的插件类型"""
|
|
return _plugin_types.copy()
|
|
|
|
|
|
# ========== HTTP 响应类型 ==========
|
|
class Response:
|
|
"""HTTP 响应对象"""
|
|
def __init__(self, status: int = 200, headers: Optional[dict[str, str]] = None, body: str = ""):
|
|
self.status = status
|
|
self.headers = headers or {}
|
|
self.body = body
|
|
|
|
|
|
# ========== 插件数据类型 ==========
|
|
class Metadata:
|
|
"""插件元数据"""
|
|
def __init__(self, name: str = "", version: str = "", author: str = "", description: str = ""):
|
|
self.name = name
|
|
self.version = version
|
|
self.author = author
|
|
self.description = description
|
|
|
|
|
|
class PluginConfig:
|
|
"""插件配置"""
|
|
def __init__(self, enabled: bool = True, args: Optional[dict[str, Any]] = None):
|
|
self.enabled = enabled
|
|
self.args = args or {}
|
|
|
|
|
|
class Manifest:
|
|
"""插件清单"""
|
|
def __init__(self, metadata: Optional[Metadata] = None, config: Optional[PluginConfig] = None, dependencies: Optional[list[str]] = None):
|
|
self.metadata = metadata or Metadata()
|
|
self.config = config or PluginConfig()
|
|
self.dependencies = dependencies or []
|
|
|
|
|
|
# ========== 插件基类 ==========
|
|
class Plugin(ABC):
|
|
"""插件基类"""
|
|
|
|
@abstractmethod
|
|
def init(self, deps: Optional[dict[str, Any]] = None):
|
|
"""初始化插件"""
|
|
...
|
|
|
|
@abstractmethod
|
|
def start(self):
|
|
"""启动插件"""
|
|
...
|
|
|
|
@abstractmethod
|
|
def stop(self):
|
|
"""停止插件"""
|
|
...
|
|
|
|
def meta(self) -> Manifest:
|
|
"""获取插件元数据"""
|
|
return Manifest()
|
|
|
|
def reload(self, config: Optional[dict[str, Any]] = None):
|
|
"""热重载插件配置"""
|
|
pass
|
|
|
|
def health(self) -> bool:
|
|
"""健康检查"""
|
|
return True
|
|
|
|
def stats(self) -> dict[str, Any]:
|
|
"""获取插件统计信息"""
|
|
return {}
|