"""MIL SDK 自定义异常模块

约定：
- 所有 SDK 主动抛出的异常均继承自 MILSDKError，便于上层统一捕获；
- 异常命名体现"出错阶段"（读取 / 格式 / 用例数据 / 写入），
  调用方只需按需捕获细分异常，或在外层兜底捕获 MILSDKError。
"""


class MILSDKError(Exception):
    """MIL SDK 所有自定义异常的根类，UI 层可针对此类型统一兜底。"""
    pass


class ExcelReadError(MILSDKError):
    """Excel 读取阶段错误：文件不存在、权限不足、被占用、底层解析失败等。"""
    pass


class ExcelFormatError(MILSDKError):
    """Excel 内容格式错误：缺少约定的工作表、缺少 'Source: Input' 标记、
    模板版本号缺失等结构性异常。"""
    pass


class CaseDataError(MILSDKError):
    """用例数据语义错误：信号名未在数据字典中找到、步骤时间非数值等。"""
    pass


class ExcelWriteError(MILSDKError):
    """Excel 写入阶段错误：磁盘权限、文件被占用、保存失败等。"""
    pass