Clojure test coverage tool - now moved to the LShift organization
Clojure CSS
Pull request Compare This branch is 171 commits ahead of mdelaurentis:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cloverage
lein-cloverage
.gitignore
.travis.yml
README.md
TODO.md
epl-v10.html

README.md

cloverage

Simple clojure coverage tool. Currently requires clojure 1.4.

Build Status

Installation

Simply add [lein-cloverage "1.0.2"] to :plugins in your .lein/profiles.clj

Testing frameworks support

This library currently only supports clojure.test. You can get midje to work by wrapping facts in deftest declarations.

Usage

lein

Run lein cloverage in your project. See cloverage/coverage.clj for more options.

mvn

There is no maven plugin right now. A workaround is to import this library in the project being tested, then run: mvn exec:java -Dexec.classpathScope=test -Dexec.mainClass='clojure.main' -Dexec.args='--main cloverage.coverage *args-to-coverage*'

Where args-to-coverage will usually be something like "-n 'ns.regex.' -t 'text.ns.regex.'"

Troubleshooting

IllegalArgumentException No matching field found: foo for class user.Bar  clojure.lang.Reflector.getInstanceField (Reflector.java:271)

This is usually caused by protocols with methods starting with -. Before clojure 1.6:

user=> (defprotocol Foo (-foo [x] x))
Foo
user=> (deftype Bar [] Foo (-foo [_] "foo"))
user.Bar
user=> (-foo (Bar.))
"foo"
user=> ((do -foo) (Bar.))

IllegalArgumentException No matching field found: foo for class user.Bar  clojure.lang.Reflector.getInstanceField (Reflector.java:271)

Since cloverage will wrap the -foo symbol to track whether it's accessed, you will get this error. Upgrade to clojure 1.6.

Changelog

1.0.4-SNAPSHOT:

  • Features:
    • Minimal EMMA XML output format support.
    • Coveralls output format.
    • Cloverage now exits with non-zero exit code when your tests fail
  • Bugfixes:
    • Better instrumentation logic is no longer confused by macro/symbol shadowing
    • Support for (:require [(namespace.prefix (suffix :as rename))]) ns forms
    • Cloverage jars no longer include all dependencies

1.0.3:

  • fix empty list crash
  • add letfn support
  • print html report URL after testing

License

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

Contributors

  • 2012 LShift, Jacek Lach, Alexander Schmolck, Frank Shearar
  • 2010 Michael Delaurentis

Mentions

Some code was taken from

  • Java IO interop (clojure-contrib/duck-streams) by Stuart Sierra (see cloverage/source.clj)
  • Topological sort (https://gist.github.com/1263783) by Alan Dipert (see cloverage/kahn.clj)