121 lines
3.5 KiB
Python
121 lines
3.5 KiB
Python
"""
|
||
app/core/parsers/registry.py - 解析器注册中心
|
||
|
||
提供解析器的动态注册、查找、实例化功能
|
||
"""
|
||
|
||
import importlib
|
||
import sys
|
||
from typing import Dict, Type, Optional, List
|
||
|
||
from app.core.config import logger
|
||
from .base import ResponseParser
|
||
|
||
|
||
class ParserRegistry:
|
||
"""
|
||
解析器注册中心
|
||
|
||
职责:
|
||
1. 管理所有可用的响应解析器
|
||
2. 提供注册机制
|
||
3. 根据 ID 获取解析器实例
|
||
"""
|
||
|
||
_parsers: Dict[str, Type[ResponseParser]] = {}
|
||
|
||
@classmethod
|
||
def register_class(cls, parser_class: Type[ResponseParser], parser_id: Optional[str] = None):
|
||
"""
|
||
注册解析器类
|
||
|
||
Args:
|
||
parser_class: 解析器类
|
||
parser_id: 解析器 ID(可选,默认使用 get_id())
|
||
"""
|
||
pid = parser_id or parser_class.get_id()
|
||
cls._parsers[pid] = parser_class
|
||
logger.info(f"已注册响应解析器: {pid} -> {parser_class.__name__}")
|
||
|
||
@classmethod
|
||
def get(cls, parser_id: str) -> ResponseParser:
|
||
"""
|
||
获取解析器实例
|
||
|
||
Args:
|
||
parser_id: 解析器 ID
|
||
|
||
Returns:
|
||
解析器实例
|
||
|
||
Raises:
|
||
ValueError: 解析器 ID 不存在
|
||
"""
|
||
if parser_id not in cls._parsers:
|
||
raise ValueError(
|
||
f"未知的解析器 ID: {parser_id},可用的解析器: {list(cls._parsers.keys())}"
|
||
)
|
||
|
||
parser_class = cls._parsers[parser_id]
|
||
return parser_class()
|
||
|
||
@classmethod
|
||
def exists(cls, parser_id: str) -> bool:
|
||
"""检查解析器是否存在"""
|
||
return parser_id in cls._parsers
|
||
|
||
@classmethod
|
||
def list_all(cls) -> List[Dict[str, str]]:
|
||
"""
|
||
列出所有已注册的解析器
|
||
|
||
Returns:
|
||
解析器信息列表
|
||
"""
|
||
result = []
|
||
for pid, parser_class in cls._parsers.items():
|
||
info = {
|
||
"id": pid,
|
||
"name": parser_class.get_name(),
|
||
"description": parser_class.get_description(),
|
||
"patterns": parser_class.get_supported_patterns(),
|
||
}
|
||
result.append(info)
|
||
|
||
return result
|
||
|
||
@classmethod
|
||
def load_from_module(cls, module_path: str, class_name: str, parser_id: str):
|
||
"""
|
||
动态加载并注册解析器类
|
||
|
||
Args:
|
||
module_path: 模块路径(如 "app.core.parsers.custom")
|
||
class_name: 类名(如 "CustomParser")
|
||
parser_id: 注册的 ID
|
||
|
||
Raises:
|
||
ImportError: 模块不存在
|
||
AttributeError: 类不存在
|
||
"""
|
||
try:
|
||
importlib.invalidate_caches()
|
||
if module_path in sys.modules:
|
||
module = importlib.reload(sys.modules[module_path])
|
||
else:
|
||
module = importlib.import_module(module_path)
|
||
parser_class = getattr(module, class_name)
|
||
|
||
if not issubclass(parser_class, ResponseParser):
|
||
raise TypeError(f"{class_name} 不是 ResponseParser 的子类")
|
||
|
||
cls.register_class(parser_class, parser_id)
|
||
logger.info(f"动态加载解析器成功: {module_path}.{class_name} -> {parser_id}")
|
||
|
||
except Exception as e:
|
||
logger.error(f"动态加载解析器失败: {module_path}.{class_name} - {e}")
|
||
raise
|
||
|
||
|
||
__all__ = ['ParserRegistry']
|