undercover

https://github.com/sviridov/undercover.el.git

git clone 'git://github.com/sviridov/undercover.el.git'


---

undercover.el

A test coverage library for Emacs Lisp.

Notes

undercover.el is on earlier stage of development and has some important issues:

• it assumes a certain development cycle of your package (using Cask, Travis CI and Coveralls);
• it based on edebug and can have some issues with macros coverage.

Installation

• Add undercover.el to your Cask file:

```lisp (source gnu) (source melpa)

(package-file “awesome-package.el”)

(development (depends-on “undercover”)) ```

• Before load or require your package in test/test-helper.el or features/support/env.el (or analogue), call undercover with wildcards that will match package files:

```lisp (require 'undercover)

(undercover “.el“ ”awesome-extensions/.el” (:exclude “*-test.el”)) (require 'awesome-package) ```

• Add your repository to Coveralls.

Configuration

• If you don't use Travis CI you need to set COVERALLS_REPO_TOKEN environment variable before running tests, for example:

sh $ COVERALLS_REPO_TOKEN=<your-coveralls-repo-token> cask exec ert-runner

• Set report-file option if you want to change report location:

lisp (undercover "*.el" (:report-file "/tmp/local-report.json"))

undercover.el will try to merge new report with existing one.

• Set send-report option to nil if you don't want to send coverage report:

lisp (undercover "*.el" (:report-file "/tmp/local-report.json") (:send-report nil))