ErisPulse.loaders.strict 模块
模块概述
ErisPulse 严格模式
提供统一的模块/适配器加载合规性管理。
提示
- 通过 ErisPulse.framework.strict_mode 配置级别(0=宽松(默认), 1=跳过, 2=致命)
- 通过 ErisPulse.framework.strict_mode_exceptions 配置豁免清单
- StrictModeManager 由初始化协调器创建并注入到各加载器,确保跨加载器收集违规
类列表
class StrictModeLevel(IntEnum)
严格模式级别
内部方法 内部枚举,对应配置中的 strict_mode 数值
class Violation
单条违规记录
name: 组件名称(entry-point name)
component_type: 组件类型,"module" 或 "adapter"
reason: 违规原因标识,如 "not_base_class", "load_failed",
"register_failed", "init_failed", "invalid_name"
detail: 可选的详细描述
class StrictModeManager
严格模式管理器
统一处理模块/适配器加载过程中的合规性判定与违规收集。
提示 使用方式:
manager = StrictModeManager.from_config() # 未继承基类时判定是否拒绝 if manager.decide(name, "module", "not_base_class"): # 跳过该模块 pass # 异常类失败仅记录(调用方已自行跳过) manager.record_failure(name, "module", "load_failed", detail=str(e)) # 在检查点统一抛出致命错误 manager.raise_if_fatal()
方法列表
__post_init__() -> None
初始化豁免集合,便于快速查找
from_config() -> 'StrictModeManager'(classmethod)
从框架配置创建管理器实例
返回值: 配置好的管理器实例;读取配置失败时回退到默认值
内部方法 由初始化协调器调用,读取 ErisPulse.framework.strict_mode 及豁免清单。 strict_mode 配置值会被严格校验:非法值(非 0/1/2)会明确告警并回退到 默认级别,避免用户以为开了严格模式实际却在宽松模式下运行。
is_exempt(name: str, component_type: str) -> bool
判断组件是否在豁免清单中
- name: 组件名称
- component_type: 组件类型
返回值: 是否豁免
decide(name: str, component_type: str, reason: str) -> bool
报告一次可"容忍或拒绝"的违规,并返回处置决定
主要用于"未继承基类"这类违规:在宽松级别下可容忍继续加载, 在严格级别下应拒绝(跳过)。
- name: 组件名称
- component_type: 组件类型
- reason: 违规原因标识
返回值: True 表示应拒绝(跳过)该组件;False 表示应容忍(继续加载)
内部方法 在致命级别下,非豁免违规会同时被记录,待检查点统一抛出
record_failure(name: str, component_type: str, reason: str, detail: str = '') -> None
记录一次异常类失败
与 decide 不同,此方法假定调用方已自行跳过该组件(例如捕获了异常)。 被拒绝的组件会记入 _rejections(与级别无关,用于摘要展示); 仅在致命级别下额外记入 _violations,以便检查点统一报告并中止。
- name: 组件名称
- component_type: 组件类型
- reason: 违规原因标识
- detail: 详细描述(如异常信息)
内部方法 调用方应同时输出自己的具体错误日志,此方法不重复输出
has_fatal_violations() -> bool
是否存在致命级别的违规
返回值: 当前为致命级别且已收集到违规时返回 True
violations -> list[Violation](property)
已收集的致命违规列表(只读视图)
rejections -> list[Violation](property)
被拒绝/跳过的组件列表(只读视图,与级别无关,用于摘要展示)
tolerated -> list[Violation](property)
宽松模式下被容忍加载的组件列表
raise_if_fatal() -> None
在检查点统一报告并抛出致命错误
当处于致命级别且收集到违规时,先打印完整违规清单,再抛出 StrictModeError 中止启动。无致命违规时直接返回。
异常: StrictModeError - 存在致命违规时抛出