单元测试也是一个开发中最常见的需求,在Java里我们用JUnit或者TestNG,在clojure里也内置了单元测试的库。标准库的
clojure.test,以及第三方框架
midje。这里我将主要介绍clojure.test这个标准库,midje是个更加强大的测试框架,广告下,midje的介绍在第二次cn-clojure聚会上将有个Topic,我就不画蛇添足了。通常来说,clojure.test足够让你对付日常的测试。
首先看一个最简单的例子,定义一个函数square来计算平方,然后我们测试这个函数:
;;引用clojure.test
(ns example
(:use [clojure.test :only [deftest is run-tests]]))
;;定义函数
(defn square [x]
(* x x))
;;测试函数
(deftest test-square
(is (= 4 (square 2)))
(is (= 9 (square -3))))
;;运行测试
(run-tests 'example)
执行输出:
Testing example
Ran 1 tests containing 2 assertions.
0 failures, 0 errors.
这个小例子基本说明了clojure.test的主要功能。
首先是断言is,类似JUnit里的assertTrue,用来判断form是否为true,它还可以接受一个额外的msg参数来描述断言:
(is (= 4 (square 2)) "a test")
它还有两种变形,专门用来判断测试是否抛出异常:
(is (thrown? RuntimeException (square "a")))
(is (thrown-with-msg? RuntimeException #"java.lang.String cannot be cast to java.lang.Number" (square "a")))
上面的例子故意求"a"的平方,这会抛出一个java.lang.ClassCastException,一个运行时异常,并且异常信息为java.lang.String cannot be cast to java.lang.Number。我们可以通过上面的方式来测试这种意外情况。clojure.test还提供了另一个
断言are,用来判断多个form:
(testing "test zero or one"
(are
(= 0 (square 0))
(= 1 (square 1))))
are接受多个form并判断是否正确。这里还用了testing这个宏来添加一段字符串来描述测试的内容。
其次,我们用deftest宏定义了一个测试用例,deftest定义的测试用例也可以组合起来:
(deftest addition
(is (= 4 (+ 2 2)))
(is (= 7 (+ 3 4))))
(deftest subtraction
(is (= 1 (- 4 3)))
(is (= 3 (- 7 4))))
(deftest arithmetic
(addition)
(subtraction))
但是组合后的tests运行就不能简单地传入一个ns,而需要定义一个test-ns-hook指定要跑的测试用例,否则组合的用例如上面的addition和subtraction会运行两次。我们马上谈到。
定义完用例后是运行测试,运行测试使用run-tests,可以指定要跑测试的ns,run-tests接受可变参数个的ns。刚才提到,组合tests的时候会有重复运行的问题,要防止重复运行,可以定义一个
test-ns-hook的函数:
(defn test-ns-hook []
(test-square)
(arithmetic))
这样run-tests就会调用test-ns-hook按照给定的顺序执行指定的用例,避免了重复执行。
在你的测试代码里明确调用run-tests执行测试是一种方式,不过我们在开发中更经常使用的是
lein来管理project,
lein会将src和test分开,将你的测试代码组织在专门的test目录,类似使用maven的时候我们将main和test分开一样。这时候就可以简单地调用:
lein test
命令来执行单元测试,而不需要明确地在测试代码里调用run-tests并指定ns。更实用的使用例子可以看一些开源项目的组织。
单元测试里做mock也是比较常见的需求,在clojure里做mock很容易,原来clojure.contrib有个mock库,基本的原理都是利用binding来动态改变被mock对象的功能,但是在clojure 1.3里,binding只能改变标注为dynamic的变量,并且clojure.contrib被废弃,部分被合并到core里面,Allen Rohner编译了一个可以用于clojure 1.3的clojure.contrib,不过需要你自己install到本地仓库,具体看
这里。不过clojure.contrib.mock哪怕使用1.2的编译版本其实也是可以的。
clojure.contrib最重要的是expect宏,它类似EasyMock里的expect方法,看一个例子:
(use [clojure.contrib.mock :only [times returns has-args expect]])
(deftest test-square2
(expect [square (has-args [number?] (times 2 (returns 9)))]
(is (= 9 (square 4)))))
has-args用来检测square的参数是不是number,times用来指定预期调用的次数,而returns用来返回mock值,是不是很像EasyMock?因为我们这个测试只调用了square一次,所以这个用例将失败:
Testing example
"Unexpected invocation count. Function name: square expected: 2 actual: 1"
这个例子要在Clojure 1.3里运行,需要将square定义成dynamic:
(defn ^:dynamic square [x]
(* x x))
否则会告诉你没办法绑定square:
actual: java.lang.IllegalStateException: Can't dynamically bind non-dynamic var: example/square
额外提下,还有个轻量级的测试框架
expections可以看一下,类似Ruby Facker的
facker库提供一些常见的模拟数据,如名称地址等。
转载请注明出处:
http://www.blogjava.net/killme2008/archive/2012/02/15/370040.html