web-dev-qa-db-ja.com

OpenAPI 3.0.0でswagger-codegenを実行する方法

公式のように見えます swagger for 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 on 3.0.0 ブランチ

Swagger仕様があります(既存の2.0仕様から https://github.com/mermade/swagger2openapi で生成されます。出力は良好です)

Jarを自分でパッケージ化せずにswagger-codegenを実行する簡単な方法はありますか?

[メイン]情報io.swagger.parser.Swagger20Parser-/input/myspec.openapi3.jsonからの読み取り[メイン]情報io.swagger.codegen.ignore.CodegenIgnoreProcessor-.swagger-codegen-ignoreファイルが見つかりません。スレッド「メイン」Java.lang.RuntimeExceptionの例外:swagger入力または構成がありません! 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コンテナafterを実行する方法が多少サポートされているようです。私はこれをいくつかの場所でセットアップする必要があるので、ローカルでコンパイルする必要なしにこれを行うためのサポートされた方法があることを望んでいます/推測しています。

10
mike

OpenAPI Generator (Swagger Codegenのトップコントリビューターが発見)は、OpenAPI仕様v2とv3の両方をサポートしています。

docker imagesJava JAR(SNAPSHOT)Brew または npm を使用して試してください。

OpenAPI Generatorの詳細については、プロジェクトの [〜#〜] readme [〜#〜] を参照してください。

ヘルプが必要な場合は、 問題を開く をご覧ください。調査します。

更新:第1安定バージョン3.0.0がリリースされました: https://github.com/OpenAPITools/openapi-generator/releases/tag/v3.0.

10
William Cheng

Swagger-codegen 3.0.0スナップショットには、OpenAPI 3.0定義からのコード生成用の限られた数のターゲットが含まれるようになりました。 https://github.com/swagger-api/swagger-codegen/issues/6598#issuecomment-333428808

Node.jsで書かれた元のswagger-codegen 2.xテンプレートを使用したcodegenエンジンの代替実験的実装があります: https://github.com/mermade/openapi-codegen -if言語はまだサポートされていません。設定ファイルを作成するだけで、テンプレートファイルを出力にマッピングできます。

2
MikeRalphson