Clojure Core

Namespaces

clojure
- core
  - protocols
- data
- inspector
- java
  - browse
  - browse-ui
  - io
  - javadoc
  - shell
- main
- pprint
- reflect
- repl
- set
- stacktrace
- string
- template
- test
  - junit
  - tap
- walk
- xml
- zip

1.3.0 permalink

1.2.0
1.3.0

is

Generic assertion macro. 'form' is any predicate test.
'msg' is an optional message to attach to the assertion.

Example: (is (= 4 (+ 2 2)) "Two plus two should be 4")

Special forms:

(is (thrown? c body)) checks that an instance of c is thrown from
body, fails if not; then returns the thing thrown.

(is (thrown-with-msg? c re body)) checks that an instance of c is
thrown AND that the message on the exception matches (with
re-find) the regular expression re.

1 Example top

link | changes
```
(use '[clojure.test :only [is]])

user=> (is (true? true))
true

;; false assertions print a message and evaluate to false

user=> (is (true? false))
FAIL in clojure.lang.PersistentList$EmptyList@1 (NO_SOURCE_FILE:1)
expected: (true? false)
  actual: (not (true? false))
false
```
(use '[clojure.test :only [is]]) user=> (is (true? true)) true ;; false assertions print a message and evaluate to false user=> (is (true? false)) FAIL in clojure.lang.PersistentList$EmptyList@1 (NO_SOURCE_FILE:1) expected: (true? false) actual: (not (true? false)) false

Source clojure/test.clj:538 top

(defmacro is
  "Generic assertion macro.  'form' is any predicate test.
  'msg' is an optional message to attach to the assertion.
  
  Example: (is (= 4 (+ 2 2)) \"Two plus two should be 4\")

  Special forms:

  (is (thrown? c body)) checks that an instance of c is thrown from
  body, fails if not; then returns the thing thrown.

  (is (thrown-with-msg? c re body)) checks that an instance of c is
  thrown AND that the message on the exception matches (with
  re-find) the regular expression re."
  {:added "1.1"} 
  ([form] `(is ~form nil))
  ([form msg] `(try-expr ~msg ~form)))

Vars in clojure.test/is:

Used in 0 other vars

ClojureDocs(beta)

Clojure Core

Namespaces

is

clojure.test

1 Example top

See Also top

Source clojure/test.clj:538 top

Comments top

No comments for is. Log in to add a comment.