SuperAPI AI 工具集

pydantic

数据与分析

查看项目

更新于 10-16 05:43

技能介绍

用途:Pydantic 使用 Python 类型注解定义数据架构,对输入数据进行验证与类型转换,并管理配置,适合接口数据校验、配置解析等场景。

主要能力:通过继承 BaseModel 声明字段类型与默认值;支持自动类型转换(如字符串转 int、datetime);提供 model_validate 与 model_validate_json 从字典或 JSON 校验数据;model_dump 与 model_dump_json 序列化;Field 可设置别名、范围、长度、排除等约束;支持 ConfigDict 配置严格模式、不可变、赋值时校验、禁止额外字段等;支持 field_validator、model_validator 自定义验证与跨字段校验;支持嵌套模型、Enum、TypeAdapter 独立校验及生成 JSON Schema;SecretStr 等敏感字段处理。

使用方式:安装 pip install pydantic,可选 pip install pydantic[email] 或 pip install pydantic[url] 获得 EmailStr、HttpUrl。定义模型后传入数据即可完成验证,验证失败抛出 ValidationError,可通过 e.errors() 获取错误位置与信息。

适用场景:API 请求与响应数据校验、配置文件加载、数据管道中的结构化校验、序列化输出控制。

限制:资料要求 Python 3.8+ 并使用 Pydantic v2.x;未提供收费、价格与平台信息。