search

in-house-swagger / in-house-swagger

in-house swagger-tools server
https://in-house-swagger.github.io/in-house-swagger/index.html
Apache License 2.0
1 stars 0 forks source link

OAS3 に対応したい #27

Open suwa-sh opened 6 years ago

suwa-sh commented 6 years ago

ストーリー

利用者 として 最新のOAS使用を利用 するために、 OAS2 / 3 を使い分けできる。

背景・経緯

OAS3 がリリースされたが、codegenが正式対応されていない。 codegenが正式リリースされ次第で、対応を載せたい。

受け入れ条件

  1. OAS2 / 3 を設定で切り替え できること
    • 可能であれば、動的に切り替えたい。最低限設定で切り替えられること。
  2. workflow全体で OAS3 を利用 できること
    • 対応済み
      • swagger-ui: 導入済み
      • swagger-editor: 導入済み
    • 未対応
      • swagger-codegen-cli
      • swagger-generator
    • 動向を確認中
      • swagger2markup
      • swagger-spec-mgr

対応詳細

  1. swagger-spec-mgr対応メモ 多分、分割設定を切り替えるだけで済むはず。
suwa-sh commented 6 years ago

codegen-cli, generatorは、OpenAPITools/openapi-generator でコミュニティ運営版としてフォークされた様子。 SmartBear版は多数のコントリビュータが離れてしまったので、一旦忘れます。。。 https://github.com/OpenAPITools/openapi-generator

suwa-sh commented 6 years ago

openapi-generator-online は、SpringBootのfatjarで公開されるようになった。 この関連で課題が2つ。どうしたものか。。。