REST APIを実装して遊ぶ

はじめに

最近Goしている。
RESTで遊んでいる。
OpenAPIで自動生成でやる。
書いてられない......
さて、どうしよう......

解決案

ざっくり案だけど、JavaのSpringdocみたいに自動で仕様書書くのはどうだろう。
Goだと割と楽にコード解析ができる。
そこで、go自体でIDLっぽく、インタフェースを書いて、自動生成する。

package idl

// 適当に構造体を宣言→componentsに入れる。
type NewPet struct {
    Name string
    Tag  string `idl:"制約条件"`
}

type Pet interface {
    // (GET /pets)→pathとmethodに使う。
    Find(params FindPetsParams) Pet
    // -> paramsクエリの情報。Pet 200の応答。
}

こんな感じで、定義書いておいて、go:generateでキックして、OpenAPI spec＆コード生成できるといいんかなと。