Ruby單元測試框架實例分析

Ruby單元測試框架實例分析.剛開始寫一個單元測試框架的時候代碼是很少的，但當我想給它加入一些特性時就變得沒有那么精煉了:) 幸運的是重寫是很容易的。我們真正需要做的是執行下面的代碼：

 describe "some test" do it "should be true" do  true.should == true end    it "should show that an expression can be true" do  (5 == 5).should == true end    it "should be failing deliberately" do  5.should == 6 endend 

正如你看到的，它很像是一個基本的Rspec測試。讓我們寫一些代碼來執行它。

譯注：RSpec 工具是一個 Ruby 軟件包，可以用它構建有關您的軟件的規范。該規范實際上是一個描述系統行為的測試。

構建一個簡單的框架

首先要做的是使用“describe”來定義一個新的測試。既然我們想要把”describe” block放在任何地方（例如，文件本身），我們需要對Ruby做一點擴展。“puts”函數在Kernel block中，因此可以在任何地方使用（因為Object類包含了Kernel并且Ruby中的每個對象都繼承自Object類），同樣的我們會把describe放到Kernel block中以賦予同樣的能力）：

 module Kernel  def describe(description, &block)   tests = Dsl.new.parse(description, block)   tests.execute  endend 

譯注：Ruby block：Ruby語言的block功能類似回調函數。

正如codego.net上面寫的的，”describe”接收一個用來描述測試的字符串和包含了測試代碼的block。在這里，我們將測試的代碼和”describe”分開講解（例如，”it” block）。因此我們創建了Dsl類，用它的parse函數處理待測試的block，結果會產生一個可以執行我們所有測試的對象，但是不要高興得太早。Dsl類看上去是這樣的：

 class Dsl  def initialize   @tests = {}  end def parse(description, block)   self.instance_eval(&block)   Executor.new(description, @tests)  end def it(description, &block)   @tests[description] = block  endend 

這里要做的是在Dsl對象的上下文里對block求值：

?1 self.instance_eval(&block) 

我們的Dsl對象有一個”it”函數，同樣也接收一個描述和一個block，這里和describe block包含的內容完全一致，一切都運行得很好（例如，我們基本上會在幾個函數調用時使用”it”函數，每次都傳入一個描述和一個block）。我們還可以在Dsl對象中定義其他的函數，并且這些函數會成為允許在”describe” block中使用的“語言”的一部分）。

在describe block中，”it”函數會為每個”it” block調用一次。每次調用時，會把輸入的block以測試描述作為鍵值存儲在哈希表中。完成這些以后，我們只要創建一個Executor對象，可以對我們所有的測試block進行迭代，調用它們并產生執行結果。Executor代碼如下：

 class Executor  def initialize(description, tests)   @description = description   @tests = tests   @success_count = 0  @failure_count = 0 end def execute   puts "#{@description}"  @tests.each_pair do |name, block|    print " - #{name}"   result = self.instance_eval(&block)    result ? @success_count += 1 : @failure_count += 1   puts result ? " SUCCESS" : " FAILURE"  end  summary  end def summary   puts "\n#{@tests.keys.size} tests, #{@success_count} success, #{@failure_count} failure" endend 

我們的executor代碼非常簡單。輸出”describe” block的描述，然后遍歷所有存儲的”it” block并且在executor對象中執行它們。這么處理沒有什么特別原因，但這意味著executor對象同樣也可以包含其他函數，并且可以在”it” block中作為一種“語言”來使用（比如，我們dsl的一部分可以定義為executor的一個函數）。譬如，我們可以在executor上定義下列函數：

 def should_be_five(x)  5 == x end 

這個函數同樣可以在”it” block內部使用，但對于我們這個簡單的測試沒有這個必要。

所以，”it” block會計算并存儲結果，通常結果只是”it” block最后一個語句的返回值（按照常規的Ruby）。這里，我們希望確保最后一個語句總是返回一個布爾值（標明測試通過或失敗），通過它我們可以輸出一些有意義提示。

我們還差最后一步，”should”函數代碼如下：

  true.should == true5.should == 5 

每個對象都應當提供自己”should”函數，代碼如下：

class Object def should   self endend 

這個函數并沒有真正做什么工作（僅僅是返回對象本身）；它僅僅是一個讓測試讀起來更好的語法。

在這個階段，我們只是將測試計算的結構轉換成一個字符串，表明測試結果通過或失敗并輸出。在這個過程中，我們會統計通過或失敗的測試數量，所以可以在最后給出一個總結報告。這就是我們所需要的所有的代碼，如果我們將他們放到一起，就是下面的44行代碼：

 module Kernel  def describe(description, &block)   tests = Dsl.new.parse(description, block)   tests.execute  endendclass Object def should   self endendclass Dsl  def initialize   @tests = {}  end def parse(description, block)   self.instance_eval(&block)   Executor.new(description, @tests)  end def it(description, &block)   @tests[description] = block  endendclass Executor  def initialize(description, tests)   @description = description   @tests = tests   @success_count = 0  @failure_count = 0 end def execute   puts "#{@description}"  @tests.each_pair do |name, block|    print " - #{name}"   result = self.instance_eval(&block)    result ? @success_count += 1 : @failure_count += 1   puts result ? " SUCCESS" : " FAILURE"  end  summary  end def summary   puts "\n#{@tests.keys.size} tests, #{@success_count} success, #{@failure_count} failure" endend 

如果我們“需要”使用這個框架執行最初的那個測試，我們會得到下面輸出結果：

    some test

    - should be true SUCCESS

    - should show that an expression can be true SUCCESS

    - should be failing deliberately FAILURE

    3 tests, 2 success, 1 failure

太好了！現在，如果你因沒有一個單元測試框架而煩惱并且不想莽撞地寫代碼，只要花上5分鐘你就可以得到一個能夠助你一臂之力的測試框架。當然，這里有一些略微夸大；你很快就會想到這里缺少額外的驗證API、更好的輸出、對象仿真和測試樁等等。然而，我們可以很容易的在精簡的框架上擴展其中的一些功能（例如，增加額外的DSL元素）——只消花費很小的努力。如果你不相信我，可以看看bacon ，它只用了幾百行代碼就完成了Rspec一個精簡版。我編寫的Attest測試框架是另一個很好的例子（這么說有自賣自夸的嫌疑:P）。這兩者都缺少任何內建的test double 支持，我會在另外一個時間討論如何添加test double支持。

譯注：Test Double：在對象編程中“自動化單元測試”的專業術語，涵蓋的類型有Test Stub（測試樁）、Mock Object、Test Spy、Fake Object和Dummy Object。