季節の変わり目に心まで震えてます。chotaroです。 ICPチームでは日々、OpenAPI V3に即してAPIの設計を行なっています。gitlabでは、GUIでSpecを閲覧することができるため、大変便利です。 ですが、この閲覧機能lintまではやってくれないため、気づいたらエラー出るようになってるじゃん!ということであったり、細かい部分の表記揺れはどうしても出てきます。typeはstringで記載されているのに、exampleは数字じゃん!ということもままあります。 致命的な問題には今の所なっていないのですが、後から検知して直すというのも面倒だし、何か起きたら嫌なのでlintするツールないのかな?というのが今回の動機です。 Spectralを使ってみよう spactralは、JSONやymlファイルをlintすることに特化したツールです。 与えられたルールをもとに、各ファイルの文法や記
![SpectralでOpenAPI Specをlintしたい! - astamuse Lab](https://cdn-ak-scissors.b.st-hatena.com/image/square/b159a1c70886c1b19a7f0c320dcb4cfcd5b6fffc/height=288;version=1;width=512/https%3A%2F%2Fcdn-ak.f.st-hatena.com%2Fimages%2Ffotolife%2Fa%2Fastamuse%2F20211027%2F20211027105522.png)