Skip to content

milankinen/cuic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CUIC

Clojure UI testing with Chrome. Special thanks to Timo L. for the awesome logo!

Build status Clojars Project cljdoc

Motivation

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:

  • Prefer Clojure core data structures and language features to custom macros and DSLs
  • Minimal and unambiguous but easily extendable API
  • Seamless integration with clojure.test and the tooling around it
  • First class REPL usage

Show me the code!

Here'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))))

Documentation

Each cuic function has a Clojure doc-string describing its behaviour and usage. Generated API docs and guides are also available in cljdoc.org.

Similar projects

License

MIT