diaryこの広告は、90日以上更新していないブログに表示しています。Rails最近、スマホからRESTでアクセスしてデータ取ってくるシステムのサーバーサイドを作ることが多いのですが、API仕様書書いてくれと言われて面倒になったので、なんとかしたかった。そこで、そもそもRESTの入力と出力の仕様って、controllerのspecを書いていればそこに書いてあって出力も取れるので、それを整形してmarkdownにすりゃ大体OKじゃないかと思ったので、controllerのspecを流すついでに自動生成するようなGemを作りました。Rubyistでない人にソース読んでくれ、とは言えないし。GitHubなんかGemっぽいキラキラネームにしようと思って、それっぽい名前を付けましたが、相変わらず中身はしょぼいです。出力周りがw後、rpsec-railsに依存しているので、railsじゃないと使えない。使い方は、こんな感じ。endendただ、これだけだと出力されない。出力がテストデータに依存しているため、idのように実行時にころころ変わるような値が出力にも影響してしまうので、rspec実行時に環境変数を渡さないと出力されないようになってます。spec元々は、formatterでやれるかと思ったんですが、rspecのソース読んだ所、exampleを実行したらexample_group_instanceがクリアされて、メタデータとかテストケース内で使ったデータとかにアクセスできなかったりで、こんな形に。なんか、専用のcliインターフェース作って、ドキュメント生成っぽくした方がいいかもしれない。今の所、markdownで出力するだけだが、出力フォーマットを多少選べるようにするのもありかもしれない。相変わらず、テストコード書くのが辛かった・・・。rspec-coreとrspec-railsのテストコードを参考にspec内でspec流すテストを調べたりとか。2018に登壇するためにL.Aまで行ってきた本番環境でcassandraの運用を開始してみた月別アーカイブはてなブログをはじめよう!joker1007さんは、はてなブログを使っています。ブログを報告するスターをつけました引用をストックしましたストック一覧を見る閉じる引用するにはまずログインしてくださいログイン閉じる引用をストックできませんでした。再度お試しください閉じる限定公開記事のため引用できません。