使用 Pydantic 进行复杂数据结构的验证

使用 pydantic 进行复杂数据结构的验证

本文介绍了如何使用 Pydantic 在 Python 中验证复杂的数据结构,特别是包含固定键名和特定类型列表的字典。通过定义 Pydantic 模型,并结合 `conlist` 类型,可以确保输入数据的结构和类型符合预期,从而提高代码的健壮性和可维护性。

Pydantic 是一个强大的 Python 库,用于数据验证和设置管理。它使用 Python 类型提示来定义数据结构,并在运行时强制执行类型约束。本文将重点介绍如何使用 Pydantic 验证具有特定结构的复杂数据,例如包含固定键名和特定长度列表的字典。

定义 Pydantic 模型

要验证复杂的数据结构,首先需要定义一个 Pydantic 模型来描述数据的形状。在给定的示例中,我们需要验证一个包含 filters 键的字典,该键的值是一个包含 simple 和 combined 键的字典。simple 和 combined 的值都是包含三个字符串的列表的列表。

我们可以使用 BaseModel 类来定义 Pydantic 模型。BaseModel 是所有 Pydantic 模型的基类。我们可以使用类型提示来定义模型的字段及其类型。

from pydantic import BaseModel, conlistfrom typing import Listclass SimpleCombine(BaseModel):    simple :  List[conlist(str, min_length=3, max_length=3)]    combined : List[conlist(str, min_length=3, max_length=3)]class Filter(BaseModel):    filters :  SimpleCombine

在上面的代码中,我们定义了两个 Pydantic 模型:SimpleCombine 和 Filter。

SimpleCombine 模型包含两个字段:simple 和 combined。这两个字段的类型都是 List[conlist(str, min_length=3, max_length=3)]。conlist 类型是 Pydantic 提供的类型,用于指定列表的最小和最大长度。在这种情况下,我们指定列表的长度必须为 3,并且列表中的所有元素都必须是字符串。Filter 模型包含一个字段:filters。该字段的类型是 SimpleCombine,也就是我们刚才定义的模型。

使用 Pydantic 模型进行验证

定义了 Pydantic 模型之后,就可以使用它来验证数据了。可以通过创建模型的实例来验证数据。如果数据与模型的定义不匹配,Pydantic 将引发一个 ValidationError 异常。

data = {    "filters": {        "simple": [["a", "b", "c"], ["d", "e", "f"]],        "combined": [["g", "h", "i"], ["j", "k", "l"]]    }}try:    filter_data = Filter(**data)    print("Validation successful!")    print(filter_data)except Exception as e:    print(f"Validation failed: {e}")

在上面的代码中,我们创建了一个 Filter 模型的实例,并将 data 字典作为参数传递给构造函数。如果 data 字典与 Filter 模型的定义匹配,则会成功创建一个 Filter 模型的实例。否则,会引发一个 ValidationError 异常。

在 FastAPI 中使用 Pydantic

Pydantic 与 FastAPI 框架无缝集成。可以在 FastAPI 路由中使用 Pydantic 模型来定义请求体和响应体。

from fastapi import FastAPIfrom pydantic import BaseModel, conlistfrom typing import Listapp = FastAPI()class SimpleCombine(BaseModel):    simple :  List[conlist(str, min_length=3, max_length=3)]    combined : List[conlist(str, min_length=3, max_length=3)]class Filter(BaseModel):    filters :  SimpleCombine@app.post("/validate")async def validate_data(filter_data: Filter):    return {"message": "Data is valid!", "data": filter_data}

在上面的代码中,我们定义了一个 FastAPI 路由 /validate,该路由接受一个 Filter 类型的请求体。FastAPI 会自动使用 Pydantic 来验证请求体。如果请求体与 Filter 模型的定义不匹配,FastAPI 将返回一个 HTTP 422 错误。

注意事项

Pydantic 模型是不可变的。这意味着一旦创建了模型的实例,就不能修改其字段的值。Pydantic 模型可以使用 Python 类型提示来定义字段的类型。Pydantic 支持所有标准的 Python 类型,以及一些额外的类型,例如 conlist。Pydantic 可以自动将数据转换为正确的类型。例如,如果将一个字符串传递给一个整数类型的字段,Pydantic 会自动将该字符串转换为整数。

总结

本文介绍了如何使用 Pydantic 在 Python 中验证复杂的数据结构。通过定义 Pydantic 模型,并结合 conlist 类型,可以确保输入数据的结构和类型符合预期,从而提高代码的健壮性和可维护性。Pydantic 与 FastAPI 框架无缝集成,可以在 FastAPI 路由中使用 Pydantic 模型来定义请求体和响应体。

以上就是使用 Pydantic 进行复杂数据结构的验证的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1377551.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月14日 17:52:34
下一篇 2025年12月14日 17:52:54

相关推荐

  • 从 Excel VBA 在 macOS 上执行 Python 脚本的完整指南

    本文档旨在提供一个清晰、简洁的教程,指导用户如何在 macOS 上的 Excel VBA 环境中直接执行 Python 脚本。通过利用 AppleScript 作为桥梁,我们可以克服 Excel VBA 直接调用 Python 的限制,实现两者的有效集成,并提供示例代码和必要的步骤说明。 概述 在 …

    好文分享 2025年12月14日
    000
  • 解决Python 64位/32位版本冲突,打造干净的开发环境

    本文旨在帮助开发者解决Python 64位和32位版本冲突问题,提供一套完整的清理和重装Python环境的方案。内容涵盖从卸载旧版本、清理环境变量和注册表,到使用`pip`命令管理包,以及清理用户配置文件等步骤,确保你拥有一个干净、可控的Python开发环境。 在Python开发过程中,经常会遇到由…

    2025年12月14日
    000
  • Selenium 中更简洁的元素选择方法

    本文旨在帮助开发者优化 Selenium 脚本中的元素选择方式,避免使用冗长且脆弱的 XPath 表达式。通过利用 CSS 选择器和更精确的 XPath 表达式,可以显著提高脚本的可维护性和稳定性,从而提升自动化测试的效率。文章将提供具体的代码示例,展示如何使用 CSS 选择器和改进的 XPath …

    2025年12月14日
    000
  • # 跨平台处理退格键和Ctrl+退格键的差异:Python终端游戏开发指南

    本文针对python终端游戏开发中遇到的linux和windows系统下退格键(backspace)和ctrl+退格键(ctrl+backspace)产生不同字节码的问题,提供了一种跨平台解决方案。通过分析操作系统层面的差异,建议采用可配置的键盘映射方案,允许用户自定义按键行为,从而避免了硬编码平台…

    2025年12月14日
    000
  • 使用更简洁的方式在 Selenium 中定位元素

    本文旨在帮助开发者在使用 Selenium 进行网页元素定位时,摆脱冗长复杂的 XPath 表达式,转而使用更简洁、高效的 CSS 选择器。通过具体示例,展示如何利用页面结构和元素属性,编写易于维护和理解的定位策略,提升自动化测试脚本的稳定性和可读性。 在使用 Selenium 进行网页自动化操作时…

    2025年12月14日
    000
  • 使用正则表达式匹配特定模式之外的空格

    本文旨在讲解如何使用正则表达式匹配字符串中特定模式之外的所有空格。通过结合捕获组和`re.split`函数,我们可以轻松地将字符串按照指定规则进行分割,从而提取出所需的内容。本文将提供详细的代码示例和解释,帮助读者掌握这一技巧。 在处理字符串时,有时我们需要忽略特定模式内的空格,而只匹配其他位置的空…

    2025年12月14日
    000
  • 如何查看 Python 内置函数 round() 的源代码

    本文介绍了为什么无法直接使用 `inspect` 模块获取 Python 内置函数(如 `round()`)的源代码,并提供了查找这些函数底层实现的方式。核心原因在于这些内置函数通常由 C 语言编写,而非 Python 源代码。 在使用 Python 的 inspect 模块尝试获取内置函数(例如 …

    2025年12月14日
    000
  • 如何在 Excel VBA (Mac) 中直接执行 Python 脚本

    本文档旨在提供一种在 Mac 上的 Excel VBA 环境中直接执行 Python 脚本的解决方案。通过利用 AppleScript 作为桥梁,我们可以在 VBA 代码中调用 Python 解释器,从而实现 VBA 与 Python 的协同工作。本文将详细介绍配置步骤、AppleScript 脚本…

    2025年12月14日
    000
  • 解决 Loguru 无法将 Python 错误输出到日志文件的问题

    本文旨在解决 python 中使用 loguru 库时,程序错误(exception)无法正常输出到日志文件,但能在终端正常显示的问题。我们将深入探讨 `sys.excepthook()` 的工作原理,并介绍如何使用 loguru 提供的 `@logger.catch` 装饰器来捕获和记录未处理的异…

    2025年12月14日
    000
  • Python类型提示:处理特定函数或对象的最佳实践

    本文探讨了在python中如何正确地为接受特定函数或对象作为参数的函数进行类型提示。针对将`np.sin`或`np.cos`这类非字面量对象误用`literal`进行类型提示的问题,文章指出这违反了类型提示的本意。我们分析了两种常见场景:基于对象身份的逻辑判断和函数作为通用接口,并提供了使用`enu…

    2025年12月14日
    000
  • 使用正则表达式忽略特定标签内的空格并分割字符串

    本文旨在提供一个使用正则表达式在字符串中忽略特定标签(例如 “ 和 “)内的空格,并根据剩余空格分割字符串的实用指南。我们将通过Python代码示例,详细解释如何构建合适的正则表达式,并利用 `re.split` 函数实现字符串的分割,最终获得期望的结果。 在处理文本数据时,…

    2025年12月14日
    000
  • Python类型提示:限制函数参数为特定对象而非字面量

    本文探讨如何在Python中为函数参数添加类型提示,以限制其为特定对象(如`np.sin`, `np.cos`),而非字面量。我们将分析为何直接使用`Literal`不适用于此类场景,并提供基于枚举(Enum)或面向对象封装的替代方案,强调类型提示应服务于程序安全性而非业务规则的过度约束。 在Pyt…

    2025年12月14日
    000
  • 跨平台处理退格键和Ctrl+退格键的差异

    本文旨在解决在Linux和Windows环境下,使用`getch()`函数读取退格键和Ctrl+退格键时产生的字节码差异问题。通过深入分析操作系统层面的行为,解释了这种差异的根源,并提供了一种更优雅的解决方案:为程序添加可配置的键盘映射,允许用户自定义按键行为,从而避免了在代码中直接检测操作系统类型…

    2025年12月14日
    000
  • Python 函数类型提示:限制允许的函数对象

    本文探讨了如何在 Python 中使用类型提示来限制函数参数只能接受特定的函数对象,例如 np.sin 或 np.cos。虽然 Literal 类型提示看起来很适合,但它仅适用于字面量。本文将讨论为什么直接使用 Literal 不合适,并提供替代方案,帮助你更好地设计和类型提示你的函数。 在 Pyt…

    2025年12月14日
    000
  • 正则表达式匹配:排除特定标签内的空格

    本文旨在提供一个使用正则表达式匹配字符串中所有空格,但排除特定 XML/HTML 标签(如 “ 和 “)内部空格的解决方案。通过结合正则表达式的捕获组和 Python 的 `re.split` 函数,可以有效地实现这一目标,并最终将字符串按指定空格分割。 在处理文本数据时,经…

    2025年12月14日
    000
  • Python类型提示:非字面量对象限制的策略与最佳实践

    本文探讨了在python中如何为非字面量对象(如函数实例)进行类型提示,特别是当需要限制为特定对象实例时。我们解释了为何typing.literal不适用于此类场景,并提供了基于业务需求和类型安全的不同解决方案,包括使用枚举(enum)和typing.callable,以实现清晰、可维护的代码。 在…

    2025年12月14日
    000
  • 在 Excel VBA (Mac) 中直接执行 Python 脚本的教程

    本文档旨在提供一种在 Mac 上的 Excel VBA 中直接执行 Python 脚本的有效方法。通过利用 AppleScript 作为桥梁,我们展示了如何从 VBA 代码调用 Python 解释器,并传递参数。该方案简化了在 Excel 环境中集成 Python 功能的流程,方便用户利用 Pyth…

    2025年12月14日
    000
  • 深入理解Python类型提示:Literal的界限与可调用对象的策略

    本文探讨了在Python中为函数参数指定特定可调用对象时的类型提示最佳实践。针对将`np.sin`或`np.cos`等非字面量对象误用于`typing.Literal`的问题,文章阐明了类型提示与业务逻辑的区别,并提供了多种替代方案,包括使用`Callable`、枚举(Enum)以及策略模式,旨在提…

    2025年12月14日
    000
  • python实例如何绑定属性

    动态绑定属性:创建实例后可直接添加属性,如p.name = “Alice”,但仅对该实例有效。2. 在__init__方法中绑定:通过构造函数初始化属性,所有实例共享相同属性结构,推荐常规使用。3. 使用@property装饰器:实现属性访问控制,支持验证与逻辑处理,如限制年…

    2025年12月14日
    000
  • python判断两个集合是否相等

    两个集合相等当且仅当它们包含相同元素,使用==运算符判断。示例中set_a == set_b返回True,因元素相同;set_a == set_c返回False,因元素不同;空集比较返回True。注意:集合自动去重,==比较值而非身份,避免使用is。 在 Python 中,判断两个集合是否相等非常简…

    2025年12月14日
    000

发表回复

登录后才能评论
关注微信