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

210 lines
6.3 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/extractors/registry.py - 提取器注册中心
提供提取器的动态注册、查找、实例化功能。
支持从配置文件动态加载提取器类。
"""
import importlib
import logging
from typing import Dict, Type, Optional, List
from app.core.extractors.base import BaseExtractor
logger = logging.getLogger(__name__)
class ExtractorRegistry:
"""
提取器注册中心
职责:
1. 管理所有可用的提取器类
2. 提供装饰器注册机制
3. 根据 ID 获取提取器实例
4. 支持动态导入(从配置文件加载)
"""
_extractors: Dict[str, Type[BaseExtractor]] = {}
_default_extractor_id: str = "deep_mode_v1"
@classmethod
def register(cls, extractor_id: Optional[str] = None):
"""
装饰器:注册提取器类
用法:
@ExtractorRegistry.register("custom_v1")
class CustomExtractor(BaseExtractor):
pass
Args:
extractor_id: 提取器 ID(可选,默认使用类的 get_id())
"""
def decorator(extractor_class: Type[BaseExtractor]):
# 确定 ID
eid = extractor_id
if eid is None:
if hasattr(extractor_class, 'get_id'):
eid = extractor_class.get_id()
else:
eid = extractor_class.__name__.lower()
# 注册
cls._extractors[eid] = extractor_class
logger.debug(f"已注册提取器: {eid} -> {extractor_class.__name__}")
return extractor_class
return decorator
@classmethod
def register_class(cls, extractor_class: Type[BaseExtractor], extractor_id: Optional[str] = None):
"""
直接注册提取器类(非装饰器方式)
Args:
extractor_class: 提取器类
extractor_id: 提取器 ID(可选)
"""
eid = extractor_id
if eid is None:
if hasattr(extractor_class, 'get_id'):
eid = extractor_class.get_id()
else:
eid = extractor_class.__name__.lower()
cls._extractors[eid] = extractor_class
logger.info(f"已注册提取器: {eid} -> {extractor_class.__name__}")
@classmethod
def get(cls, extractor_id: Optional[str] = None) -> BaseExtractor:
"""
获取提取器实例
Args:
extractor_id: 提取器 ID(None 则返回默认提取器)
Returns:
提取器实例
Raises:
ValueError: 提取器 ID 不存在
"""
eid = extractor_id or cls._default_extractor_id
if eid not in cls._extractors:
raise ValueError(
f"未知的提取器 ID: {eid},可用的提取器: {list(cls._extractors.keys())}"
)
extractor_class = cls._extractors[eid]
return extractor_class()
@classmethod
def get_class(cls, extractor_id: str) -> Type[BaseExtractor]:
"""
获取提取器类(不实例化)
Args:
extractor_id: 提取器 ID
Returns:
提取器类
Raises:
ValueError: 提取器 ID 不存在
"""
if extractor_id not in cls._extractors:
raise ValueError(f"未知的提取器: {extractor_id}")
return cls._extractors[extractor_id]
@classmethod
def list_all(cls) -> List[Dict[str, str]]:
"""
列出所有已注册的提取器
Returns:
提取器信息列表,每项包含 id/name/description
"""
result = []
for eid, extractor_class in cls._extractors.items():
info = {
"id": eid,
"name": extractor_class.get_name() if hasattr(extractor_class, 'get_name') else extractor_class.__name__,
"description": extractor_class.get_description() if hasattr(extractor_class, 'get_description') else "",
}
result.append(info)
return result
@classmethod
def exists(cls, extractor_id: str) -> bool:
"""
检查提取器是否存在
Args:
extractor_id: 提取器 ID
Returns:
是否存在
"""
return extractor_id in cls._extractors
@classmethod
def set_default(cls, extractor_id: str):
"""
设置默认提取器
Args:
extractor_id: 提取器 ID
Raises:
ValueError: 提取器不存在
"""
if not cls.exists(extractor_id):
raise ValueError(f"无法设置默认提取器:{extractor_id} 不存在")
cls._default_extractor_id = extractor_id
logger.info(f"默认提取器已设置为: {extractor_id}")
@classmethod
def get_default_id(cls) -> str:
"""获取默认提取器 ID"""
return cls._default_extractor_id
@classmethod
def load_from_module(cls, module_path: str, class_name: str, extractor_id: str):
"""
动态加载并注册提取器类
用于从配置文件加载自定义提取器
Args:
module_path: 模块路径(如 "app.core.extractors.custom")
class_name: 类名(如 "CustomExtractor")
extractor_id: 注册的 ID
Raises:
ImportError: 模块不存在
AttributeError: 类不存在
"""
try:
module = importlib.import_module(module_path)
extractor_class = getattr(module, class_name)
# 验证是否为 BaseExtractor 子类
if not issubclass(extractor_class, BaseExtractor):
raise TypeError(f"{class_name} 不是 BaseExtractor 的子类")
cls.register_class(extractor_class, extractor_id)
logger.info(f"动态加载提取器成功: {module_path}.{class_name} -> {extractor_id}")
except Exception as e:
logger.error(f"动态加载提取器失败: {module_path}.{class_name} - {e}")
raise
__all__ = ['ExtractorRegistry']