Midje is a test framework for Clojure that emphasizes mocking and ease of use. It supports three levels of syntactic sugar:
Unprocessed None at all. You work with maps. For the person who hates my style of sugaring and wants to write her own.
Semi-sweet Here's a simple Midje test:
(expect (numerical-reverser 103) => 301)
I use the arrows because I think of tests as examples. When people show snippets of code as examples, they often use an arrow to separate what you type from what you should expect to see. The Midje line above says "After
103, the test should see it return
In that form, Midje does the same thing as clojure.test. (Indeed, it uses clojure.test's reporting mechanism.) If, however, you want
numerical-reverserto use a function that hasn't been coded yet, you can fake out that function like this:
(expect (numerical-reverser 103) => 301 (fake (string-reverser "103") => "301"))
In the second line, the arrow signifies that when
"103", we know its caller will get back
The semi-sweet style does nothing more than add the
fakemacros, which are ways of generating the maps the unprocessed style expects while themselves not being too hard to generate from more ambitious macros.
Sweet The style I like to use. A "little language" for top-down test-driven development, which repaints Freeman and Pryce's Growing Object-Oriented Software, Guided by Tests to the functional landscape. There, I like to think of TDD as building a web of interrelated facts. For example, here's a fact about
(fact (numerical-reverser 103) => 301)
But that fact is only true for this implementation provided something else is true for
(fact (numerical-reverser 103) => 301 (provided (string-reverser "103") => "301"))
You can easily see Midje in action and fiddle with some tests. You don't even need Clojure installed. Here's how:
- Click here.
- In a shell, go to the directory your browser unpacked the example
into. It should be named
- For a sweet example, go to
examples/sweet-examples/basic/. For a semi-sweet example, go to
- Type "./run". (Windows users, see README.html)
- To change the tests, edit
You can download everything to get more examples.
This heavily annotated example of the sweet style is the place to look.
Another example contains complete descriptions of the semi-sweet style.
In the unprocessed style, both calls with their expected results and expectations for calls of faked functions are defined by maps. You can find the format by looking at the definitions of
midje/semi_sweet.clj. The function that does the actual work is
expect*. Its first argument is the map in the
call-being-testedformat, followed by zero or more maps in the
The wiki is growing documentation about such things as Emacs support and details of use.