Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Open API + Railsでテストをいい感じにした話
Search
syumai
July 18, 2019
1
110
Open API + Railsでテストをいい感じにした話
WIPです
syumai
July 18, 2019
Tweet
Share
More Decks by syumai
See All by syumai
Goのmultiple errorsについて (2024年4月版)
syumai
4
1.3k
ECMAScript仕様の読み方ガイド 〜比較演算子編〜
syumai
5
570
Go言語で始めるCloudflare Workers
syumai
5
1.5k
Goのジェネリクスを活用する
syumai
2
2.7k
Goでスタックトレースを扱う方法がややこしい件について
syumai
2
4.7k
What's new in Go 1.20?
syumai
2
1.7k
Cloudflare WorkersでGoを動かすライブラリを作っている話
syumai
1
1.2k
Cloudflare WorkersでGoのHTTPサーバーを動かすライブラリを作った話
syumai
0
680
Go言語仕様輪読会の開催を通じた振り返り
syumai
1
480
Featured
See All Featured
Designing Experiences People Love
moore
136
23k
Dealing with People You Can't Stand - Big Design 2015
cassininazir
358
22k
Rebuilding a faster, lazier Slack
samanthasiow
74
8.3k
The Brand Is Dead. Long Live the Brand.
mthomps
49
30k
The Success of Rails: Ensuring Growth for the Next 100 Years
eileencodes
34
6.1k
Unsuck your backbone
ammeep
664
57k
Java REST API Framework Comparison - PWX 2021
mraible
PRO
18
7k
Building Better People: How to give real-time feedback that sticks.
wjessup
356
18k
Imperfection Machines: The Place of Print at Facebook
scottboms
261
12k
Clear Off the Table
cherdarchuk
86
310k
How to Ace a Technical Interview
jacobian
273
22k
Cheating the UX When There Is Nothing More to Optimize - PixelPioneers
stephaniewalter
275
13k
Transcript
Open API + Railsでテストをいい感じにした 話 平成.rb 2019/7/18 @__syumai
自己紹介 syumai 平成4年生まれ 前職: 株式会社maricuruにてRailsを使ったAPI開発、React / Vue を使ったフロントエンド開発等を行っていました 現職: 決済系の会社でGoのマイクロサービスを開発しています
はじめに
めっちゃWIPです!
本日のテーマ Open API
Open API or Swagger使ってますか?
Open APIとは? YAML / JSONでAPI Specを書ける Swagger 3.0がそのままOpen API 3.0と呼ばれています
書いたAPI Specから色々生成出来る
生成できるものその1 HTMLのいい感じのドキュメント フォームの送信とかも試せる! (Postman的なやつ)
生成できるものその2 サーバー / クライアントの生成 サーバーのinterfaceや、クライアントライブラリ (言語めっちゃ ある) を自動生成出来る 多言語のクライアントを生成したい時にめちゃくちゃ便利
クライアント生成できる言語 https://github.com/OpenAPITools/openapi-generator Ruby / Node.js / TypeScript / Javaなど色々あります
Open APIのSpecのサンプル
Open APIのドキュメントのサンプル
Open APIを使っている人からよく聞く課題 APIの実装とドキュメントがズレてくる ドキュメントがズレてるから、誰もメンテしなくなる 実装とドキュメントがズレると、自動生成したクライアントが使えなく なる
ドキュメントがズレる理由 APIの実装を行う作業と、ドキュメントを書く作業が分離してしまって いるため これを統合できたら解決するはず!
どう解決したか? テストでRailsのAPIを起動する テストに Open APIで生成したClient を使う
このやり方の良い点 同じSpecから生成したClientをJSで使うとして、 Testさえ通っていれば、Client側から使えるのが保証される!
具体的なやり方 Makefileでテスト起動周りをいい感じに書いていく Railsサーバーの起動 Rspecの実行
デモします!!
ポイント テスト用のRailsサーバーと、Rspecで使うDBを共通にする
つらみ エラーが出た箇所のログ追うのがつらい
ご清聴ありがとうございました!!