openapi2aspida
Convert OpenAPI 3.0 or Swagger 2.0 definitions into aspida
https://github.com/aspida/openapi2aspida
試行
https://github.com/kii-playground/openapi2aspida-tutorial
公式チュートリアルに沿って試した。
技術
OpenAPI,aspida,axios
確かに便利~
OpenAPI仕様さえあれば、コマンド一発で、aspida用の型とか作れてHappy
簡単にschema driven development スキーマ駆動開発出来る
Q
openapiがprivateな場合どうアクセスするんだろう?
axiosじゃなくて、React Query TanStack Query、Fetch APIで書き換えたい
https://github.com/aspida/aspida/tree/master/packages/aspida-react-query
これ参考にaxiosをFetch APIで書き換える(fetchについても言及されてる)
各種aspida依存になるのが心配かも?
生成された@typesがindex.ts1つにまとまっているけど、分けるのどうするの?
OpenAPI のcomponentsを利用すれば大丈夫そう?
実際
ここで書いたようにバグがあったりする。
このバグは、対処できるんだけど、他あった時困りそう。
便利なんだけど、メンテが遅かったりすると困るので、多数派を探すのが良いかもしれないね。
aspidaもメンテ止まっているし、使えないかもなぁ。
OpenAPI Generator
参考
公式
openapi2aspida を用いた快適スキーマ駆動開発
https://zenn.dev/dyoshikawa/articles/ed61d6bf0e8ef1