Liking cljdoc? Tell your friends :D

fulcro-spec

1. CHANGE OF SCOPE NOTICE

BREAKING CHANGES as of 3.0. Do NOT upgrade without being prepared to port your test runners.

This library no longer contains browser-based runners.

I recommend the following alternatives:

Clojure Tests

I recommend IntelliJ/Emacs/Vim in-editor testing, or perhaps Clojure Tools Deps with kaocha. The latter renders into a terminal, but can use fulcro-spec’s macros. Here is a sample config file that will use Fulcro spec’s terminal reporting:

#kaocha/v1
    {:tests    [{:id           :unit
                 :ns-patterns  ["-test$" "-spec$"]
                 :test-paths   ["src/test"]
                 :skip-meta    [:integration]
                 :source-paths ["src/main"]}]
     :reporter [fulcro-spec.reporters.terminal/fulcro-report]
     :plugins  [:kaocha.plugin/randomize
                :kaocha.plugin/filter
                :kaocha.plugin/capture-output]}
Clojurescript Tests

I highly recommend using Nubank’s Workspaces. I’ve contributed a shadow-cljs target that can auto-scan for tests if you use their deftest macro. Again, things like the provided macro work within Workspaces. I recommend using shadow-cljs :karma target for running CI tests.

See the docs for more details.

2. Description

A Clojure(scipt) testing library to augment the standard clojure.test.

fulcro spec

Release: CircleCI Snapshot: CircleCI

3. Usage

(ns my-test
  (:require
    [fulcro-spec.core :refer [when-mocking provided assertions]
    [clojure.test :refer [deftest]]
    ...))

(defn f [x] 900)
(defn g [y] (f y))

(deftest my-test
  (when-mocking
    (f x) => 22

    (assertions
      "mocking works"
      (g 9) => 31)))

See the full documentation for complete details.

Can you improve this documentation?Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close