重拾Rspec

本文所使用的开发环境：

rvm      1.8.3
ruby     1.9.2p290
Rails    3.0.3
Rspec    2.11.0
DB       sqlite3

 

Rspec是什么

　　Rspec是基于ruby的测试工具，产生于BDD思想。它的代码比Test::Unit更好阅读，开发人员更容易描述测试目的，类似于可执行的规则文件。

　　Rspec在Rails中的测试分为Model测试、Controller测试、View测试、Helper测试和Route测试。

准备

创建测试项目，因为是学习，强烈建议不要在现有商业项目中做学习。 

$ rails new rspec_study 

安装

在Gemfile文件中添加如下代码：

group :test, :development do
  gem "rspec", "~> 2.0"
  gem "rspec-rails", "~> 2.0"
end

 安装gem文件：

$ bundle install

在项目中安装rspec：

$ rails generate rspec:install

如果打印如下结果，则安装成功：

create  .rspec
create  spec
create  spec/spec_helper.rb

执行测试（执行前请确认config/database.yml中的test数据库与其它两个数据库不同）：

$ bundle exec rake spec

注意：rake spec会先执行一次 rake db:test:prepare 以创建测试数据库，而创建测试数据库时需要db/schema.rb，所以对于新项目，一定要执行 rake db:migrate 以生成 schema.rb文件。否则，在执行测试命令时会有如下提示：

rspec_study/db/schema.rb doesn't exist yet. Run "rake db:migrate" to create it then try again.

基本语法

先上代码，如下：

require 'spec_helper'

describe User do

  before(:all) do
  end

  def happy_test # 这是一个帮助方法
  end

  it "should be very happy if you love your job" do
  end

  it "should be very happy if you don't love your job" do
    pending("bug 0001") do
    end
  end

  after(:each) do
  end

end

describe方法

describe方法用于定义一组测试用例，其参数可以是测试的类对象（例如User），也可以是字符串。describe方法可以嵌套。

it方法

it方法用于定义一个具体的测试用例（在Rspec中，一个测试用例称为一个example）。

before和after方法

很多测试框架都支持这两个方法，它们的参数作如下说明：

before(:all)     每段describe之前只执行一次

before(:each) 每段it之前执行一次

after(:all)        每段describe之后只执行一次

after(:each)    每段it之后执行一次

帮助方法：

将多个测试用例所使用的共同方法抽取成为一个公用的方法，提高代码重用。如例子中的happy_test()方法。

Model测试

首先生成一个Model

$ rails generate model user name:string age:integer gender:boolean card_id:string mail:string

 

可以看到，自动生成一个测试文件“spec/models/user_spec.rb”：

      invoke  active_record
      create    db/migrate/20120708033206_create_users.rb
      create    app/models/user.rb
      invoke    rspec
      create      spec/models/user_spec.rb

 

执行Model测试

$ bundle exec rspec spec/models/user_spec.rb

 

测试执行结果如下：

*

Pending:
  User add some examples to (or delete) rspec_study/spec/models/user_spec.rb
    # No reason given
    # ./spec/models/user_spec.rb:4

Finished in 0.00718 seconds
1 example, 0 failures, 1 pending

Randomized with seed 60625

一个完整的测试故事

# encoding: UTF-8
require 'spec_helper'

describe Order do

  context "with validates" do
    it "should be false if name is null" do
      @order = Order.new
      @order.valid?.should be_false
    end

    pending "should be false if total is null or less than zero"
  end

  it "should discount 5 percent if no billing" do # 如果未开发票少付费5%
    @order = Order.new(:total => 100, :billing => true)
    @order.payables.should == 95
  end

  it "should discount 20 percent if member" do # 如果是会员少付费20%
    @order = Order.new(:total => 100, :is_member => true)
    @order.payables.should == 80
  end

  it "should discount 22 percent if member and no billing" do # 如果是会员且未开发票则少付费22%
    pending "bug #001 from redmine"
  end

end

Controller测试

 

不再痛苦

以下提供一些可以提高测试开发效率的工具：

Watchr是一种Continuous Testing的工具。程序修改完成保存后，自动跑对应的测试。可以大大节省时间。

Shoulda提供了更多Rails专用的Matchers。

RCov用来统计测试覆盖率。有些团队会追求100%测试覆盖率，虽然很好，但是记得Coverage只是手段，不是测试的目的。

提示

　　本文的ruby环境是基于rvm的，所以编译安装的需要修改为ruby默认命令。

参考

　　http://rspec.info/

　　https://github.com/rspec/rspec

　　《The Rspec Book》，目前貌似只有英文版的。