rspec 范例

 原帖：http://elite28.github.com/2010/09/05/rspec%E6%A0%B7%E4%BE%8B.html

下面是一个ruby代码使用rspec进行行为驱动开发的样例：

mkdir rspec_tutorial cd rspec_tutorial mate .

新建一个测试驱动文件

touch user_spec.rb

编辑内容：

describe User do end     

这段测试代码的意思是，描述用户行为 在终端运行

spec user_spec.rb

这样会发生一个错误

./user_spec.rb:1: uninitialized constant User (NameError)

这个错误提示的意思是说没有初始化user对象，原因是我们还没有User类，所以现在要创建一个User类： 新建一个user.rb文件，内容：

class User end

并且得包含到测试文件中(user_spec.rb)

require 'user' describe User do end

这次我们运行命令：

$ spec user_spec.rb . Finished in 0.010015 seconds 0 examples, 0 failures

这个输出告诉我们，现在还没有样例，所以我们可以这样在测试文件中定义：(user_spec.rb)

describe User do   it "should be in any roles assigned to it" do   end end

it方法会返回一个example实例，因此it可以理解成“用户行为的一个样例” 这次我们在执行spec命令的时候加-f 参数，让结果按照某种格式来输出：

spec user_spec.rb -f specdoc     User - should be in any roles assigned to it Finished in 0.022585 seconds 1 example, 0 failures

现在已经有了example了，然后是添加行为（user_spec.rb）

require 'user' describe User do   it "should be in any roles assigned to it" do     user.should be_in_role("assigned role")   end end

加入的这行代码的意思是user应该能够胜任所有分配给他的角色。运行测试： $ spec user_spec.rb -f specdoc

User - should be in any roles assigned to it (FAILED - 1) 1) NameError in 'User should be in any roles assigned to it' undefined local variable or method `user' for #<Spec::Example::ExampleGroup::Subclass_1:0x101547c28> ./user_spec.rb:4: Finished in 0.008971 seconds 1 example, 1 failure

又出错了，是的，但在继续之前，让我们先仔细看看这段出错信息：

• “ERROR -1)”告诉我们”should be in any roles assigned to it”这个样例出错了 * “1)”则为我们详细描述了这个错误，当样例很多时，你就会发现这个编号非常有用

还有一点需要注意：这段信息没有给出RSpec代码的backtrace，如果你需要它，可以通过–b选项来获取。

下面我们得在user_spec.rb中新建一个User对象：

require 'user' describe User do   it "should be in any roles assigned to it" do     user = User.new     user.should be_in_role("assigned role")   end end

再次执行测试： $ spec user_spec.rb -f specdoc

User - should be in any roles assigned to it (FAILED - 1) 1) NoMethodError in 'User should be in any roles assigned to it' undefined method `in_role?' for #<User:0x101547778> ./user_spec.rb:5: Finished in 0.008906 seconds 1 example, 1 failure

这次是因为User对象没有role_in?方法，修改user.rb：

class User   def in_role?(role)   end end

再次执行测试： $ spec user_spec.rb -f specdoc

User - should be in any roles assigned to it (FAILED - 1) 1) 'User should be in any roles assigned to it' FAILED expected in_role?("assigned role") to return true, got nil ./user_spec.rb:5: Finished in 0.008822 seconds 1 example, 1 failure

这段代码意思是调用in_role?方法返回nil，而不是true.所以通过测试很简单，直接在方法里面返回true即可：

class User   def in_role?(role)     true   end end

执行测试：

$ spec user_spec.rb -f specdoc User - should be in any roles assigned to it Finished in 0.008493 seconds 1 example, 0 failures

但是到目前为止，我们在测试代码中还没分配给user对象角色，就对他进行了判断，所以应该在测试中加入（user_spec.rb）：

require 'user' describe User do   it "should be in any roles assigned to it" do     user = User.new     user.assign_role("assigned role")     user.should be_in_role("assigned role")   end end

再次执行测试代码不出意外会有下面的提示：

1) NoMethodError in 'User should be in any roles assigned to it' undefined method `assign_role' for #<User:0x101547408> ./user_spec.rb:5:

user.rb中没有assign_role的方法，所以添加一个(user.rb)：

class User   def assign_role(role)   end   def in_role?(role)     true   end end

这次再执行测试，就可以通过了。 但是，现在，我们只是解决了“用户必须接受所有分配给他的角色”，但是还有一个问题就是”用户不应该接受没有分配给他的角色“。所以我们需要为用户行为再增加一个样例：

require 'user' describe User do   it "should be in any roles assigned to it" do     user = User.new     user.assign_role("assigned role")     user.should be_in_role("assigned role")   end   it "不该属于没有分配给他的角色" do     user = User.new     user.should_not be_in_role("unassigned role")   end end

执行测试：

$ spec user_spec.rb -f specdoc User - should be in any roles assigned to it - 不该属于没有分配给他的角色 (FAILED - 1) 1) 'User 不该属于没有分配给他的角色' FAILED expected in_role?("unassigned role") to return false, got true ./user_spec.rb:11: Finished in 0.009124 seconds 2 examples, 1 failure

失败，用户接受了没有分配给他的角色，这时，我们需要对User.rb代码进行改动：

class User   def assign_role(role)   end   def in_role?(role)     role == "assigned role"   end end

再次执行代码，没错了。 但是user.rb中有些重复，都是用了assigned role，因此要对user.rb的代码进行重构：

class User   def assign_role(role)     @role = role   end   def in_role?(role)     role == @role   end end

再来测试一下：

$ spec user_spec.rb -f specdoc User - should be in any roles assigned to it - 不该属于没有分配给他的角色 Finished in 0.008864 seconds 2 examples, 0 failures