openapi 工具生成器 vs swagger codegen

openapi tools generator vs swagger codegen

我迷失在依赖项和工具中: 我以前使用以下工具为我的 swagger 网络服务生成代码。

swagger-codegen-cli

然后我注意到了以下工具,并认为这是继任者:

openapi 工具生成器

但是生成的代码使用了不同的注释并且看起来比较旧。

有人能告诉我,这两个工具彼此相关吗?哪个是最新版本?

来自OpenAPI Generator FAQs

What is the difference between Swagger Codegen and OpenAPI Generator?

Swagger Codegen is driven by SmartBear while OpenAPI Generator is driven by the community. More than 40 top contributors and template creators of Swagger Codegen have joined OpenAPI Generator as the founding team members. For more details, see the Fork Q&A.

Swagger is a trademark owned by SmartBear and the use of the term "Swagger" in this project is for demo (reference) purposes only.

了解差异的最简单方法是:

OpenAPI = 规范。

Swagger = 实现规范的工具。

OpenAPI 和 Swagger 都有开源社区,欢迎所有贡献者加入分享想法和参与。

目前openapi似乎处于混乱状态。我也对使用哪个生成器感到困惑...我想编写一个自定义生成器。

GRPC 的状态好多了。每个生成器都是一个插件,核心维护得很好,社区没有分叉。

更新:

我们公司同意继续使用 OpenAPI。我们现在使用 OpenAPI 的新开源变体:openapi-generator.tech/

我们扩展了 python 生成器来调整生成的代码。 我们还在 TypeScript 中使用客户端生成器,并考虑将 Kotlin 和 Swift 用于我们的移动应用程序。

最后效果不错。如果您还没有准备好使用 GRPC 进行二进制处理,OpenAPI 是一个不错的选择。它确实需要更多,我对 GRPC 的经验是它是一个无需动脑的解决方案。 “它很管用”。

但您的里程数可能会有所不同。

比较开源项目的一种方法是使用 https://openhub.net

例如OpenAPI Generator vs Swagger Codegen.

从 activity 和社区图表来看,openapi-generator 似乎更加活跃。