(rontolisp) docs
← Reference

Tests (clojure.test)

clojure.test resolves like clojure.string: (:require [clojure.test :refer :all]), (:use clojure.test) or an alias. A test is a zero-argument function registered per namespace; reports follow the oracle's layout (FAIL in (test) (file:line), the contexts, the message, expected:/actual:) and go to the stream *out* was when the program started, so with-out-str never captures one. use-fixtures is refused by name.

A result map counts and prints through do-report (:pass counts silently, :fail and :error print the block, anything else answers nil); report is the :type multimethod over the same arms. *testing-vars* holds one :name map per running test (nil outside a run). A defn whose name carries a :test function in its metadata registers it like a deftest (test.check's defspec relies on this), and a defmethod on assert-expr extends is at lower time, like the oracle's macro consulting the multimethod while compiling.

NameExampleResult
deftest(deftest t (is (= 1 1)))defines t
is(is (= 2 (+ 1 1)))true
are(are [x] (pos? x) 1 2)true
testing(testing "ctx" (is true))true
run-tests(:test (run-tests))the test count
run-all-tests(run-all-tests #"demo.*")the summary map
successful?(successful? (run-tests))true
report(report {:type :pass})nil
do-report(do-report {:type :fail :expected 1 :actual 2})nil
*testing-vars*(count *testing-vars*)the running test count
testing-vars-str(testing-vars-str {:file "t.clj" :line 1})" (t.clj:1)"
with-test-out(with-test-out (println :hi))nil