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