Configure Unit Testing for deps.edn projects

clojure.test namespace is part of the Clojure standard library, so the Clojure library is the only dependency required in the project.

{:deps {org.clojure/clojure {:mvn/version "1.10.3"}}}

Unit tests code should reside under the test directory of a project. The test directory should not be part of the main classpath, otherwise test classes would be included in the project packaging and deployed to production.

Use an alias to add the test directory, either from a user level configuration or the Clojure project deps.edn configuration file.

Adding test path

practicalli/clojure-deps-edn user-level configuration contains several aliases for Clojure and ClojureScript test runners, each alias includes the test directory as an :extra-path.

:env/test alias is also provided, which simply adds the test directory to the class path. The :env/test alias is useful in concert with other aliases or for editors that have their own built in test runners (e.g. CIDER).

Using kaocha test runner

lambdaisland/kaocha is a fast and comprehensive test runner for Clojure and ClojureScript.

:test/run alias runs all tests from the source code files, called with the clojure command in the root of the Clojure project. The alias includes test as an extra path and calls the Kaocha test runner.

clojure -X:test/run

Kaocha can also watch for changes saved to file and re-run the tests.

clojure -X:test/watch

Both kaocha aliases are configured to stop if a test fails. When re-running kaocha, only failed tests and tests that have changed are run (including tests where the code they are testing has changed).

Alias to include the test directory

Add the following aliases to the Clojure CLI tools user wide configuration, (e.g. ~/.clojure/deps.edn), or to the project deps.edn file.

To use a test runners with a deps.edn projects, the test directory should be on the classpath.

practicalli/clojure-deps-edn defines an environment alias to include the test path.

  {:extra-paths ["test"]}

Cognitect labs Clojure test runner

:test/cognitect is a simple to use test runner for Clojure projects.

clojure -X:test/cognitect

Kaocha unit test and clojure spec runner

:test/kaocha alias unit test runner that also supports Clojure Spec functional tests. the kaocha test runner on the current project. Add a test.edn file to configure which tests are run by kaocha.

clojure -X:test/kaocha


results matching ""

    No results matching ""