Clojure相当于Python doctest？

Question

Python文档测试将简单测试与源代码相关联(在Python中,它们在函数文档中). 更多信息和示例在这里.

Clojure有类似的东西吗？

我知道单元测试clojure.test,但寻找与源更紧密集成的东西(通常单元测试在不同的文件中;这里我想让测试"在里面" defn).

在我周围搜索我发现了这个,但它看起来非常不l(测试是在实际文本中,就像Python一样 - 当然,扩展的宏defn会更好吗？).

或者也许有其他方法可以解决一般问题,即我有一些测试(通常是简单的事情,演示函数的基本属性),这些测试将更好地包含在文档中(我使用的是边缘)而不是单独的单元测试文件.

更新 这是一个例子:我有一个函数来计算从像素矩形到图像中心的(曼哈顿)距离(以像素为单位).这听起来很简单,但是由于边缘上有奇数或偶数像素的图像的"中心"含义不同,或者你测量的块的哪个部分,这种情况很复杂.所以我不得不写一些测试来直接获得代码.现在我看看文档,如果文档包含那些测试,那将是最好的,因为它们比函数更好地解释函数的功能......

Answer 1

以及元数据中的测试标志,http://clojure.org/special_forms

(defn
 ^{:doc "mymax [xs+] gets the maximum value in xs using > "
   :test (fn []
             (assert (= 42  (mymax 2 42 5 4))))
   :user/comment "this is the best fn ever!"}
  mymax
  ([x] x)
  ([x y] (if (> x y) x y))
  ([x y & more]
   (reduce mymax (mymax x y) more)))

user=> (test #'mymax)
:ok
user=> (doc test)
-------------------------
clojure.core/test
([v])
  test [v] finds fn at key :test in var metadata and calls it,
  presuming failure will throw exception
nil