基于OpenAPI 3规范生成Python通用存根代码的工具咨询

针对Pydantic的工具 #

• openapi-python-client：能直接从OpenAPI 3.x规范生成基于Pydantic的DTO模型，附带的客户端请求代码可按需取舍，核心的Pydantic类完全独立于Web框架，服务端也能直接复用这些模型完成序列化/反序列化。生成的代码结构清晰，支持自定义模板，适配客户端和服务端双向使用场景。
• datamodel-code-generator：支持从OpenAPI 3规范生成多种Python数据模型，包括Pydantic v1/v2、Marshmallow等。它生成的Pydantic类无Web框架依赖，可直接作为DTO使用，序列化/反序列化逻辑由Pydantic原生提供，客户端和服务端都能无缝集成。

针对Marshmallow的工具 #

• marshmallow-codegen：专门用于从OpenAPI规范生成Marshmallow Schema，还能结合dataclasses生成对应的DTO类。生成的代码仅依赖Marshmallow和dataclasses，与Web框架解耦，客户端和服务端均可用于数据校验、序列化及反序列化。
• 自定义模板方案：先用openapi-spec-validator验证OpenAPI规范的合法性，再结合Jinja2模板自行生成Marshmallow dataclasses代码。这种方式灵活性极强，能完全控制生成代码的结构，精准匹配业务需求。

实用提示 #

• 选工具时重点关注对OpenAPI 3复杂特性（如oneOf、anyOf、枚举等）的支持，避免出现规范兼容问题。
• 生成代码后建议做少量适配调整，比如补充注释、统一命名风格，确保在客户端和服务端都能顺畅使用。

内容的提问来源于stack exchange，提问作者saabeilin