変換

docker run -i yousan/swagger-yaml-to-html < petstore.yaml > petstore.html

経緯など

SwaggerHubで作成されるHTMLがいい感じだったんですが、ウェブでファイルを管理するのが大変だなと思っていて、Gitでyamlファイルを管理しつつ、HTMLに生成できないかなと思っていました。

調べてもなかなか情報が出てこなかったんですが、Pythonのスクリプトを発見しました。

原理としてはすごく単純で、SwaggerHubのHTML＋JavaScriptを読ませていて、YAMLの実体をJSONに変換して読み込ませています。

これがPython環境だったので簡単なものですがDocker化してみました。

あとはこれでYAMLを管理しているGitで変換かけるスクリプトを置くと良いです。

というかこういう簡単な変換系でもPythonとかNodeが必要なものって結構あるじゃないですか。そういうのをオンラインでURLベースで変換できるサービス群作りたいですね。