如何为OpenAPI 3.0.0运行swagger-codegen

Question

貌似官方招摇的OpenAPI的规范V3支持接近释放https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/和招摇,代码生成了3.0.0支持开发并在分支上传递一定程度的测试https://github.com/swagger-api/swagger-codegen3.0.0

我有一个swagger规范(从我现有的2.0规范通过https://github.com/mermade/swagger2openapi生成,输出看起来不错)

是否有一种简单的方法来运行swagger-codegen而无需自己打包jar？

• 这是我发现的单一结果:https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/3.0.0-SNAPSHOT/但运行似乎已被打破(来自输出,可能实际运行2​​.0而不是3.0.0？):

[main] INFO io.swagger.parser.Swagger20Parser - 从/input/myspec.openapi3.json读取[main] INFO io.swagger.codegen.ignore.CodegenIgnoreProcessor - 找不到.swagger-codegen-ignore文件.线程"main"中的异常java.lang.RuntimeException:缺少swagger输入或配置!at io.swagger.codegen.DefaultGenerator.generate(DefaultGenerator.java:685)at io.swagger.codegen.cmd.Generate.run(Generate.java:285)at io.swagger.codegen.SwaggerCodegen.main(SwaggerCodegen.java) :35)

看起来swagger-codegen repo 在你构建之后运行一个docker容器有一些支持的方式; 我只是希望/猜测有一种支持的方法来做到这一点,而不需要在本地编译,因为我需要在几个地方设置它.

Answer 1

OpenAPI Generator(由Swagger Codegen的顶级贡献者发现)支持OpenAPI规范v2和v3.

您可以使用docker镜像或Java JAR(SNAPSHOT)试一试.

有关OpenAPI Generator的更多信息,请参阅项目的自述文件

如果您需要任何帮助,请打开一个问题,我们会对此进行调查.

更新:第一个稳定版本3.0.0已发布:https://github.com/OpenAPITools/openapi-generator/releases/tag/v3.0.0

Answer 2

Swagger-codegen 3.0.0 快照现在包含从 OpenAPI 3.0 定义生成代码的有限数量的目标。https://github.com/swagger-api/swagger-codegen/issues/6598#issuecomment-333428808

codegen 引擎有一个替代的实验性实现，使用原始的 swagger-codegen 2.x 模板，用 Node.js 编写：https: //github.com/mermade/openapi-codegen - 如果您的语言尚不受支持，只需创建一个配置文件即可将模板文件映射到输出。