Small test tool, RSpec based, for Clojure
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



What is

{revdate}: AsciiDoc {revnumber} Released

North is a small test tool based on Dan North and Dave Chelimsky work with JBehave and RSpec.

It’s written in Clojure and is intended to be a simple way and expressive way to write tests using most of RSpec conventions.


The standard Clojure test tool is test-is and sometimes it looks quite incomplete.

Even knowing that Functional Programming should rely on immutability and absence of side effects, in the real world the things don’t work so clean and smooth.

The most important thing I missed is the classic Setup/Teardown approach (before/after from RSpec), because I need to set the environment before the test execution and then clean up the mess (as I said, side effects do exist in real world)



  • clone the git repository:

    git clone
    cd north
    lein install
  • add in your project.clj:

    (def project ...
      :dev-dependencies [[north "0.1.0-SNAPSHOT"] ...]
  • run

    lein north

    and see no evil.

Writing your first test - (in progress) ~~~~~~~~~~~~~

  1. write a test

  2. see it fail

  3. write code to make the test pass

  4. back to step 1

Extending North

(in progress)

Distributed under the Eclipse Public License, the same as Clojure.

Copyright © 2012 Plinio Balduino