WebappsのRSpecサンプルグループの命名

Question

この質問はRSpecサンプルグループと英語の例をどのようにして最適な名前にするかについてです。

は、私は（functionally equivalentある）とit RSpecの、describe、contextであなたに完全な文を与えることになっていることを理解しています。たとえば、

describe "Log-in controller" do 
    context "with logged-in user" do 
    it "redirects to root" do 
     ... 
    end 
    end 
end 

読み込みLog-in controller with logged-in user redirects to rootです。驚くばかり。

しかし、私は（カピバラを使用して）ajaxyページ上のすべてのコンポーネントをテストする必要があります私のアプリケーションで、私はこのような例のグループを持っている傾向がある：

describe "blog post" do 
    describe "content" do 
    it "is displayed" 
    end 
    describe "comment" do 
    it "is displayed" 
    describe "editing" do 
     it "works" # successful comment editing 
     it "requires logged-in user" # error case 1 
     it "requires non-empty body" # error case 2 
    end 
    end 
    describe "comment form" do 
    it "works" # successful comment submission 
    it "requires valid email address" # error case 1 
    it "requires non-empty body" # error case 2 
    end 
end 

私はここ2アンチパターンを参照してください。

1. ネストされた説明は、文章として読み込まれません。もちろん、誰かが "blog post："の後にコロンを置くこともできます：

   describe "blog post" do 
       describe "'s content" do 
       it "is displayed" 
       end 
   end 
   

   または理想的に、私は

   describe "blog post" do 
       its "content" do 
       it "is displayed" 
       end 
   end 
   

   を書くだろうが、itsは属性アクセスについてです、と私はちょうどここに文字列を持っているので、それは不可能です。

   「ページコンポーネント」の問題を処理するには、より良い方法がありますか？

2. 機能のために、成功したケース（コメント提出のような機能）は、単にit "works"とマークされています。少なくとも簡潔でシンプルです - it "can be submitted and causes a comment to be added"よりやや好ましいと思います。それは明らかに何かのために言葉遣いを構成するためです。しかし、これを行うにはより良い、より自然な方法がありますか？

上記のexample-group;を再構成する方法についての提案を参照してください。

Answer 1

例が文法的に正しいと考えるべきではありません。あなたのテストで 'blog post content is'が表示されていなければそれはいいです。このテストは読みやすく簡単です。あなたが本当に望むのは、テストがうまくいかないときに何が失敗しているのかを理解できることです。

2つ目のポイントに関しては、「それはうまく機能しています」とは十分に説明できません。それは他人にあなたが「作品」の意味を知らせることはありません。実際に多くのことをテストしている場合は、例を分割することをお勧めします。

 
describe 'blog post' do 
    context 'creating a comment' do 
    it 'should require a logged-in user' 
    it 'should require a non-empty body' 
    it 'should require a valid email address' 
    it 'should create a new comment' 
    it 'should be submittable' 
    end 
end