はじめに

リーダブルRspecというタイトルつけましたが、そんな大それたものではないです
テスト書くときでも名前付け重要だからちゃんとしよう!っていうだけの内容です

RspecがBDDのためのツールであることを意識しつつ、
Rspecの流儀に則って適切に名前付けをして書くと読みやすいテストがかけるはずです

describe/context/exampleのメッセージに適切に名前つける

これが出来るだけで当然読みやすいテストになる

describe->テスト対象
context->テストする状況
example->テスト(itやspecify)
なので、
『aaaはbbbの時cccになる』
というテストを書くときは次のようになる

describe 'aaa' do
  context 'when bbb' do
    it 'should eq ccc'
  end
end

重要なのは

describe/context/exampleだけでテストの概要を説明すること
- 理解しやすい状態になっていないと、負債になってしまう
1つのdescribe/context/exampleの中で複数のことをテストは避ける
- 複数のことをテストするようになると、describe/context/exampleのメッセージが曖昧になって理解しづらくなる可能性がある
そのためにdescribe/context/exampleをきちんと分けること

とりあえず日本語で書いてみよう

英語得意でない人はdecribe/context/exampleを日本語で書き出してみてから英語に直すと良い

describe 'aaa' do
  context 'bbbの時' do
    it 'はCCCになる'
  end
end

decribe/context/exampleを日本語でまず全部書き出してみる
- この時にexampleの中身やletなどは書かない
全部書き出し終わって違和感がなくなったら、英語に直しつつexampleの中身などを書いて埋めていく
はじめに書いたdecribe/context/exampleに固辞せず臨機応変に変える
- はじめに書いたdecribe/context/exampleでは書きづらかったり過不足があったりすることがあるので

shared_context, shared_examples_for

DRYということばを盾に使われることがあるが、その殆どが読みづらさにつながることが多い
テストを書くときはDRYよりも読みやすさを重視したほうが良いというのはよく言われる
ので、shared_xxxはあまり使わないほうが良いし使うとしても節度を持って使うこと

shared_contextはcontextをshareするもの

いろんな使われ方をするが、
基本的な使い方としては文字通りcontextをshareするもの、というのを意識する

aaaはxxxの時cccになる
dddはxxxの時eeeになる

というテストをshared_contextを使って書くと次のようなテストになる

shared_context "xxx"

describe 'aaa' do
  context 'when xxx' do
    include_context "xxx"
    it 'should eq ccc'
  end
end

describe 'ddd' do
  context 'when xxx' do
    include_context "xxx"
    it 'should eq eee'
  end
end

この使い方が一番ベーシック

ほかにも色々な使い方があると思うけど、
どういうcontextをshareしてるのかわかるようなメッセージを書くこと

shared_examples_forはit_behaves_likeでメッセージ決める

shared_examples_for 'hoge'でメッセージを考えるよりも
it_behaves_like 'hoge'で考えるほうが良い名前がつけやすい

describe 'aaa' do
  context 'when bbb' do
    it_behaves_like 'hoge'
  end
end

例えばこういうテストがあった時に
『aaaはbbbの時にhogeのように振る舞う』と読める
これが違和感無いようにメッセージを決めると良い

『hogeのように振る舞う』なので

it_behaves_like 'a collection'
it_behaves_like 'a listable resource'
it_behaves_like 'a joinable room'

のように名詞が入るのが普通(のはず。英語・国語苦手...)

まとめ

名前付けちゃんとして、読む人のために読みやすいテストを書きましょう
英語苦手なら日本語でまず書いてみましょう
あとbetterspecs読みましょう
- ほかにもリーダブルなテストを書く方法は色々あるので常に模索しましょう