Codex Python 输入建模技能:用 Pydantic 和 pytest 校验字段
EnglishCodex 安装步骤
- 从固定 GitHub 提交复制 `skills/python/` 完整目录到项目 `.agents/skills/python/`。
- 在 Codex 读取 `pyproject.toml`,指定输入模型和已有异常处理风格。
中文摘要
在 Python 服务边界把外部映射校验成类型模型,并为有效、缺失和无效输入补测试。
SKILL.md 中文导读
可复现示例
为本地报告请求设计 `report_name` 字符串和 `max_rows` 正整数。验证 15、0 和缺字段三种输入,说明哪些应被拒绝。工作步骤
- 将输入字段与内部数据结构分开,先写清接受哪些值。
- 用 pytest 参数化覆盖合法、缺字段和超范围三种情况。
验收方法
模型接受有效对象,另外两种按字段返回可测试的校验错误,测试入口可复跑。
GitHub 原文 · 更新日期
适用环境
需要本地 Python 项目、项目指定的 Pydantic 和 pytest 版本。
常见问题
内部对象也一定要用 Pydantic 吗?
外部边界适合运行时校验。已受控的内部对象可根据需要使用 dataclass 或类型化映射。