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

将其保存在同一规范目录中，并命名为 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

恭喜，您的规范文件中的示例（测试）现已通过。我们修复了具有元音方法的正则表达式中的错误，但我们的测试远未完成。

添加更多示例以使用 has 元音方法测试各种类型的输入字符串是有意义的。

下表显示了一些可以添加到新示例中的排列（它阻止）

由您决定将哪些示例添加到您的规范文件中。有许多条件需要测试，您需要确定哪些条件子集最重要并最好地测试您的代码。

在rspec的命令提供了许多不同的选择，一饱眼福，键入rspec的-help。下表列出了最流行的选项并描述了它们的作用。