Как запустить swagger-codegen для OpenAPI 3.0.0

Question

Похоже, официальное сваггер для спецификации OpenAPI. Поддержка V3 близка к выпуску https://blog.readme.io/an-example-filled-guide-to-swagger-3-2/, а у swagger-codegen разработана поддержка 3.0.0. и прохождение некоторого уровня тестирования https://github.com/swagger-api/swagger-codegen на 3.0.0 ветка

У меня есть спецификации Swagger (сгенерированный из моей существующей спецификации 2.0 через https://github.com/mermade/swagger2openapi, вывод выглядит хорошо)

Есть ли простой способ запустить swagger-codegen без необходимости самостоятельно упаковывать банку?

• это единственный результат, который я нашел: https://oss.sonatype.org/content/repositories/snapshots/io/swagger/swagger-codegen-cli/3.0.0-SNAPSHOT/ но, похоже, он не работает (из вывод, возможно, на самом деле работает 2.0, а не 3.0.0?):

[main] ИНФОРМАЦИЯ io.swagger.parser.Swagger20Parser - чтение из /input/myspec.openapi3.json [main] ИНФОРМАЦИЯ io.swagger.codegen.ignore.CodegenIgnoreProcessor - файл.swagger-codegen-ignore не найден. Исключение в потоке "основной" java.lang.RuntimeException: отсутствует ввод чванства или конфигурации! в io.swagger.codegen.DefaultGenerator.generate(DefaultGenerator.java:685) в io.swagger.codegen.cmd.Generate.run(Generate.java:285) в io.swagger.codegen.SwaggerCodegen.main(SwaggerCodegen.java):35)

Похоже, что у репозитория swagger-codegen есть несколько поддерживаемый способ запуска Docker-контейнера после сборки; Я просто надеюсь / думаю, что есть поддерживаемый способ сделать это без необходимости локальной компиляции, так как мне нужно установить это в нескольких местах.

Answer 1

Генератор OpenAPI (найденный ведущими участниками Swagger Codegen) поддерживает спецификации OpenAPI v2 и v3.

Вы можете использовать образы Docker или Java JAR (SNAPSHOT), чтобы попробовать.

Для получения дополнительной информации о OpenAPI Generator, пожалуйста, обратитесь к README проекта

Если вам нужна помощь, пожалуйста, откройте вопрос, и мы рассмотрим его.

ОБНОВЛЕНИЕ: выпущена 1-ая стабильная версия 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

Существует альтернативная экспериментальная реализация движка codegen с использованием оригинальных шаблонов swagger-codegen 2.x, написанных на Node.js: https://github.com/mermade/openapi-codegen - если ваш язык еще не поддерживается, файл конфигурации просто должен быть создан для сопоставления файлов шаблона с выходными данными.