看起来像官方swagger openapi规范V3支持接近发布https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/,并且swagger-codegen开发了3.0.0支持并在 3.0.0
分支上传递了一些级别的测试https://github.com/swagger-api/swagger-codegen
我有一个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容器;我只是希望/猜测有一种支持的方法来做到这一点,而不需要在本地编译,因为我需要在几个地方设置它 .
2 回答
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
Swagger-codegen 3.0.0快照现在包含有限数量的目标,用于从OpenAPI 3.0定义生成代码 . https://github.com/swagger-api/swagger-codegen/issues/6598#issuecomment-333428808
使用原始的swagger-codegen 2.x模板有一个替代的codegen引擎实验实现,用Node.js编写:https://github.com/mermade/openapi-codegen - 如果你的语言还不支持,只需要创建一个配置文件来映射模板文件到输出 .