如何为OpenAPI 3.0.0运行swagger-codegen

Question

看起来像swagger规范V3支持的官方openapi接近发布https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/，并且swagger-codegen开发了3.0.0支持并通过了某种级别的测试{{3} } 3.0.0分支

我有一个swagger规范（从我现有的2.0规范通过https://github.com/swagger-api/swagger-codegen生成，输出看起来不错）

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

• 这是我找到的单个结果：https://github.com/mermade/swagger2openapi但是运行时似乎已经打破了（从输出中，可能实际上运行的是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文件。       线程＆＃34; main＆＃34;中的例外情况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 images或Java JAR (SNAPSHOT)试一试。

有关OpenAPI Generator的更多信息，请参阅项目README

如果您需要任何帮助，请open an issue，我们会对此进行调查。

更新：第一个稳定版本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 - 如果您的语言尚不支持，配置文件只需要创建它以将模板文件映射到输出。