SuperAPI AI 工具集

python-error-handling

编程与开发

查看项目

更新于 10-16 09:33

技能介绍

用途:该技能面向 Python 应用的健壮性建设,提供输入校验、异常层级设计与部分失败处理的模式,适用于校验用户输入和 API 参数、设计应用异常层级、处理批操作中的部分失败、把外部数据转换为领域类型、构建用户友好的错误消息以及实现快速失败式校验。

主要能力:包括早期输入校验(处理前先检查全部输入并在可能时一次性报告所有校验错误)、快速失败;在系统边界把字符串和外部数据解析为枚举等领域类型;使用 Pydantic 模型进行结构化输入校验并自动生成错误消息;将错误映射到标准内置异常,如 ValueError、TypeError、KeyError、RuntimeError、TimeoutError、FileNotFoundError、PermissionError;通过异常链(raise ... from e)保留完整错误轨迹;批处理中单独记录成功与失败而不因单项失败中止全部操作。

使用方式:在 API 边界处调用校验代码,例如 def fetch_page(url: str, page_size: int) -> Page 中,若 url 为空则 raise ValueError("'url' is required"),若 page_size 不在 1 到 100 之间则 raise ValueError(f"'page_size' must be 1-100, got {page_size}")。可参考资料中给出的 process_order、parse_output_format、CreateUserInput 等示例写法。更详细的进阶模式位于 references/details.md,导航摘要不足时可查阅该文件。

适用场景:需要校验用户输入与 API 参数、设计异常层级、处理批操作部分失败、转换外部数据、输出友好错误消息的 Python 项目。

限制:资料未提供该技能支持的具体 Python 版本、依赖安装方式、是否收费、平台与运行环境等事实,均暂未提供;相关细节需以技能源页面为准。