RSpec -編寫規範

在本章中，我們將建立一個新的 Ruby 類，將其儲存在自己的檔案中，並建立一個單獨的規範檔案來測試此類。

首先，在我們的新類中，它被稱為StringAnalyzer。這是一個簡單的類，顧名思義，它分析字串。我們的類只有一個方法has_vowels?，正如其名稱所示，如果字串包含母音則返回 true，否則返回 false。以下是StringAnalyzer的實現：

class StringAnalyzer 
   def has_vowels?(str) 
      !!(str =~ /[aeio]+/i) 
   end 
end

如果您按照 HelloWorld 部分的操作進行操作，則建立了一個名為 C:\rspec_tutorial\spec 的資料夾。

如果您有 hello_world.rb 檔案，請將其刪除，並將上面的 StringAnalyzer 程式碼儲存到 C:\rspec_tutorial\spec 資料夾中名為 string_analyzer.rb 的檔案中。

以下是我們的規範檔案用於測試 StringAnalyzer 的原始碼：

require 'string_analyzer' 

describe StringAnalyzer do 
   context "With valid input" do 
      
      it "should detect when a string contains vowels" do 
         sa = StringAnalyzer.new 
         test_string = 'uuu' 
         expect(sa.has_vowels? test_string).to be true 
      end 
		
      it "should detect when a string doesn't contain vowels" do 
         sa = StringAnalyzer.new 
         test_string = 'bcdfg' 
         expect(sa.has_vowels? test_string).to be false
      end 
      
   end 
end

將其儲存在相同的 spec 目錄中，命名為 string_analyzer_test.rb。

在您的 cmd.exe 視窗中，cd 到 C:\rspec_tutorial 資料夾並執行此命令：dir spec

您應該看到以下內容：

C:\rspec_tutorial\spec 目錄

09/13/2015 08:22 AM  <DIR>    .
09/13/2015 08:22 AM  <DIR>    ..
09/12/2015 11:44 PM                 81 string_analyzer.rb
09/12/2015 11:46 PM              451 string_analyzer_test.rb

現在我們將執行我們的測試，執行此命令：rspec spec

當您將資料夾的名稱傳遞給rspec時，它會執行資料夾內所有規範檔案。您應該看到此結果：

No examples found.

Finished in 0 seconds (files took 0.068 seconds to load)
0 examples, 0 failures

發生這種情況的原因是，預設情況下，rspec 只執行名稱以“_spec.rb”結尾的檔案。將 string_analyzer_test.rb 重新命名為 string_analyzer_spec.rb。您可以透過執行以下命令輕鬆完成此操作：

ren spec\string_analyzer_test.rb string_analyzer_spec.rb

現在，再次執行rspec spec，您應該看到如下所示的輸出：

F.
Failures:

   1) StringAnalyzer With valid input should detect when a string contains vowels
      Failure/Error: expect(sa.has_vowels? test_string).to be true 
         expected true
            got false
      # ./spec/string_analyzer_spec.rb:9:in `block (3 levels) in <top (required)>'

Finished in 0.015 seconds (files took 0.12201 seconds to load)
2 examples, 1 failure

Failed examples:
rspec ./spec/string_analyzer_spec.rb:6 # StringAnalyzer With valid 
   input should detect when a string contains vowels
Do you see what just happened? Our spec failed because we have a bug in 
   StringAnalyzer. The bug is simple to fix, open up string_analyzer.rb
   in a text editor and change this line:
!!(str =~ /[aeio]+/i)
to this:
!!(str =~ /[aeiou]+/i)

現在，儲存您剛剛在 string_analyizer.rb 中所做的更改，並再次執行 rspec spec 命令，您現在應該看到如下所示的輸出：

..
Finished in 0.002 seconds (files took 0.11401 seconds to load)
2 examples, 0 failures

恭喜，規範檔案中的示例（測試）現在通過了。我們修復了包含母音方法的正則表示式中的一個錯誤，但我們的測試遠未完成。

新增更多示例來測試包含母音方法的各種型別的輸入字串是有意義的。

下表顯示了一些可以新增到新示例（it 塊）中的排列。

由您決定將哪些示例新增到您的規範檔案中。有很多條件需要測試，您需要確定哪個條件子集最重要以及最能測試您的程式碼。

rspec 命令提供了許多不同的選項，要檢視所有選項，請鍵入rspec -help。下表列出了最常用的選項並描述了它們的功能。