OpenAPI Specification(旧Swagger)の定義ファイルはドキュメントを生成するのによく使われます。しかし、それだけではなく他にも様々な使い道があります。例えばテストやバリデーションです。 さらにAutoRestを使えば各種プログラミング言語向けにSDKを生成してくれます。これは見逃せない機能でしょう。

AutoRestの使い方

実行例です。C#のコードを生成しました。

さらに指定を追加するだけでRubyのコードも生成できます。

AutoRestが対応するのはC#、Go、Java、node、TypeScript、Python、RubyそしてPHPとなっています。これだけのプログラミング言語に対応していればまずは問題ないでしょう(Swiftも欲しいですが)。SwaggerCodegenという類似プロジェクトもありますが、AutoRestはOpenAPI Specificationに対応しているのが利点です。

AutoRestはnode/JavaScript製のオープンソース・ソフトウェア(MIT License)です。

Azure/autorest: OpenAPI (f.k.a Swagger) Specification code generator. Supports C#, Go, Java, Node.js, TypeScript, Python, Ruby and PHP.