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

您应该看到以下内容 −

Directory of 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 Voels 方法测试各种类型的输入字符串是有意义的。

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

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

rspec 命令提供了许多不同的选项，要查看所有选项，请输入 rspec -help。 下表列出了最流行的选项并描述了它们的用途。