Clojure UI testing with Chrome. Special thanks to Timo L. for the awesome logo!
I needed a library for writing robust and maintainable UI tests for my work
and hobby Clojure(Script) projects. The library had to run on top of the
JVM to simplify test setups and enable code sharing, but without the
annoying WebDriver version hassle. cuic
is a response to fill that gap.
The design of the current version of cuic
is the result of countless
(re)written tests, hours after hours of CI test runs and endless debugging
sessions, driven by the following core principles:
clojure.test
and the tooling around itHere's a small snippet showing how to test the classic
TodoMVC app with cuic
(ns example-todomvc-tests
(:require [clojure.test :refer :all]
[cuic.core :as c]
[cuic.test :refer [deftest* is* browser-test-fixture]]))
(use-fixtures
:once
(browser-test-fixture))
(defn todos []
(->> (c/query ".todo-list li")
(map c/text-content)))
(defn add-todo [text]
(doto (c/find ".new-todo")
(c/fill text))
(c/press 'Enter))
(deftest* creating-new-todos
(c/goto "http://todomvc.com/examples/react")
(is* (= [] (todos)))
(add-todo "Hello world!")
(is* (= ["Hello world!"] (todos)))
(add-todo "Tsers!")
(is* (= ["Hello world!" "Tsers!"] (todos))))
Each cuic
function has a Clojure doc-string describing its behaviour and usage.
Generated API docs and guides are also available in cljdoc.org.
MIT
Can you improve this documentation?Edit on GitHub
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close