swagger-codegen-cli конвертировать v3 openapi. json в статус c html

Question

У меня есть файл openapi. json (сгенерированный во время сборки), формат v3. Могу ли я использовать swagger-codegen-cli для создания веб-сайта stati c для документов swagger?

Цель - сгенерировать apido c. json и html во время сборки.

Пример команды CLI?

Следующие ошибки команды говорят, что у меня нет ввода чванства:

java -jar ./lib/swagger-codegen-cli-2.2.1.jar generate -i src/main/resources/static/apidoc/openapi.json -l html2 -o target/generated-sources/swagger
[main] INFO io.swagger.parser.Swagger20Parser - reading from src/main/resources/static/apidoc/openapi.json
[main] INFO io.swagger.parser.Swagger20Parser - reading from src/main/resources/static/apidoc/openapi.json
Exception in thread "main" java.lang.RuntimeException: missing swagger input or config!
        at io.swagger.codegen.DefaultGenerator.generate(DefaultGenerator.java:132)
        at io.swagger.codegen.cmd.Generate.run(Generate.java:223)
        at io.swagger.codegen.SwaggerCodegen.main(SwaggerCodegen.java:36)

Файл openapi. json не начинается с «развязность». Нужно ли конвертировать это? Вот его открытие:

{"openapi":"3.0.1","info":{"title"

Answer 1

Swagger Codegen v. 2 не поддерживает OpenAPI 3.0. Вам необходимо использовать Codegen версии 3.x .

. Вы можете загрузить последнюю версию 3.x CLI JAR из Maven Central:
https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen-cli