clojure.test/use-fixtures

View this page on ClojureDocs

Type: var Added: Clojure 1.1 Examples: 3 Runnable: 0

()

Wrap test runs in a fixture function to perform setup and teardown. Using a fixture-type of :each wraps every test individually, while :once wraps the whole run in a single function.

Examples

by benkay on 2013-08-01 . May have evaluation errors. ▶

; See https://clojure.github.io/clojure/clojure.test-api.html for details ; my-test-fixture will be passed a fn that will call all your tests ; (e.g. test-using-db). Here you perform any required setup ; (e.g. create-db), then call the passed function f, then perform ; any required teardown (e.g. destroy-db). (defn my-test-fixture [f] (create-db) (f) (destroy-db)) ; Here we register my-test-fixture to be called once, wrapping ALL tests ; in the namespace (use-fixtures :once my-test-fixture) ; This is a regular test function, which is to be wrapped using my-test-fixture (deftest test-using-db (is ... ))

by cloojure on 2014-07-11 . May have evaluation errors. ▶

; This fixture is intended to perform setup/teardown for each individual test in the namespace. Note that it assumes the :once fixture will handle creating/destroying the DB, while we only create/drop tables within the DB. (defn another-fixture [f] (create-db-table) (f) (drop-db-table)) ; Here we register another-fixture to wrap each test in the namespace (use-fixtures :each another-fixture)

by charlespwd on 2016-02-21 . May have evaluation errors. ▶

;; `use-fixtures` supports multiples arguments. ;; They wrap the tests in order (left-to-right). ;; We define some fixtures that are to be run in order (defn with-db [f] (start-db) (f) (stop-db)) (defn with-data [f] (fill-db) (f) (empty-db)) ;; Here we register them (use-fixtures :once with-db with-data)

See also

• clojure.test/join-fixtures
• clojure.test/compose-fixtures

---

Content from the matching ClojureDocs page, with authors credited on each contribution.