Files
2026-11-02 22:54:14 +08:00

121 lines
3.5 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""
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']