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。下表列出了最常用的选项并描述了它们的功能。