Swagger의 Spec YAML 파일을 HTML로 변환

1579 단어 swagger도커


변환


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

경위 등



SwaggerHub로 작성되는 HTML이 좋은 느낌이었습니다만, 웹으로 파일을 관리하는 것이 힘들 것이라고 생각하고 있어, Git로 yaml 파일을 관리하면서, HTML에 생성할 수 없을까라고 생각하고 있었습니다.

조사해도 좀처럼 정보가 나오지 않았지만 파이썬 스크립트를 발견했습니다.

원리로서는 매우 간단하고, SwaggerHub의 HTML+JavaScript를 읽게 하고 있어, YAML의 실체를 JSON에 변환해 읽히고 있습니다.

이것이 Python 환경이었기 때문에 간단한 것입니다만 Docker화해 보았습니다.

그리고는 이것으로 YAML을 관리하고 있는 Git로 변환하는 스크립트를 두는 것이 좋습니다.

괜찮 았어.



나름대로 구그라고 했을 생각이었지만, 「swagger yaml html」이라고 상당히 있었다…
htps : // 코 m / 흠집 / ms / e d9 ea 462141 네 db6f6
htps : // 코 m / 모코 s / ms / 3dc977b8b231 ddbe df7
htps : // 이 k 타카히로. 하테나 bぉg. 코m/엔트리/2016/11/23/100000

온라인으로 하고 싶은



라고 할까 이런 간단한 변환계에서도 Python라든지 Node가 필요한 것이 상당히 있을까요. 그러한 것을 온라인으로 URL 베이스로 변환할 수 있는 서비스군 만들고 싶네요.

좋은 웹페이지 즐겨찾기