OpenAPI

openapi-generator-cli を使ってコードを生成するコマンド。

$ GENERATOR=ruby-on-rails
$ docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli generate -i /local/petstore.yaml -g ${GENERATOR} -o /local/out/${GENERATOR}

生成してみた

公開されている brightcove の OpenAPI spec をもとに生成してみた。

toshimaru/brightcove-analytics-api-ruby

自動生成コードはやはり複雑すぎてまともに使えるもんじゃなかった。

ただ、ドキュメントとして参照したり、コード片として一部分をコピペしてり、コードを書く上で参考情報にはできそう。

Repository

OpenAPITools/openapi-generator: OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)

参考スライド

参考になるスライド。

• APIのコードを自動生成させたいだけならgRPCでなくてもよくない? - エムスリーテックブログ

RubyKaigi 参加

スポンサー枠で参加した。

業務やっててほとんどリアルタイムで見ることができなかったが、下記のスケジュールからアーカイブは残っている。

Schedule - RubyKaigi Takeout 2021