THIS IS EXPERIMENTAL STUFF! USE AT YOUR OWN RISK!

先生 (rōmaji: sensei)

In it's simplest form, you run sensei with the Main module of your test suite as an argument:

sensei test/Spec.hs

Note that sensei picks up options from .ghci-files. You can provide additional GHC options on the command line:

sensei -isrc -itest test/Spec.hs

Command-line arguments that look like Hspec options are passed to Hspec. To avoid ambiguity, GHC options have to be given before any Hspec options:

sensei -isrc -itest test/Spec.hs --no-color --match foo

All command-line arguments after the last -- are passed to Hspec, regardless how they look:

sensei -isrc -itest test/Spec.hs -- --no-color --match foo

Boring files

When sensei is used inside a Git repository it ignores modifications to files that are ignored by git.

Using sensei with Cabal sandboxes

cabal exec sensei test/Spec.hs

生徒 (rōmaji: seito): Accessing result on the command-line

You can access the results of the last test run with seito:

seito

Alternatively, if you have curl version 7.40.0 or newer, you can use curl instead:

curl --unix-socket .sensei.sock http://localhost/

Vim integration

You can use sensei to load the result of the last test run into your quickfix list by executing :make in Vim.

For this to work you can either create a Makefile or set makeprg to a custom value.

(In both cases sed is used to strip ANSI color sequences.)

Option 1: Create a Makefile

Create a Makefile with the following content:

all:
	@seito | sed 's/\x1B\[[0-9;]*[JKmsu]//g'

Option 2: Set makeprg:

Add the following to your Vim configuration (e.g. ~/.vim/after/ftplugin/haskell.vim):

:set makeprg=seito\ \\\|\ sed\ 's/\\x1B\\[[0-9;]*[JKmsu]//g'

Emacs Integration

Similarly you can use sensei to load the result of the last test run into emacs buffer by executing M-x compile in emacs.

For this to work you can create a Makefile as described in Option 1 above.

Development

If you want to use sensei while hacking on sensei you will need to tell sensei where to find startup.ghci by setting:

export sensei_datadir=.