Stack-based JSON interface to ide-backend
Emacs Lisp Haskell Shell
Switch branches/tags
Nothing to show
Clone or download
Latest commit f3481e2 Jan 12, 2016

README.md

stack-ide

Stack-based JSON interface to ide-backend

Project status

While you are certainly free to continue working on stack-ide, FP Complete is no longer actively working on it. Check out the following alternatives:

  • ghc-mod

  • ghci-ng

  • There is also a new community project to work on haskell ide integration, which will hopefully grow to subsume the featureset and positive attributes of stack-ide.

See this blogpost for more info.

Installing

Install with:

git clone https://github.com/commercialhaskell/stack-ide.git
cd stack-ide
git submodule update --init --recursive
stack build --copy-bins

GHC 7.10 has some GHC API bug fixes which show up in ide-backend in GHC 7.8, so the stack.yaml references a nightly Stackage build which requires GHC 7.10.

Note that you should install these tools in the same Stack LTS/Nightly resolver as the projects that you want to work on, so that the necessary packages are in scope.

Emacs

There is Emacs integration provided by stack-mode in this repository.

Add the following to your .emacs:

(add-to-list 'load-path "/path/to/stack-ide/stack-mode/")
(require 'stack-mode)
(add-hook 'haskell-mode-hook 'stack-mode)

When opening a .hs file it will figure out where your cabal package is and start a stack ide session under that package's directory.

There is an example project on the stack-mode branch at emacs-haskell-config. Follow the instructions.

Running manually

Make sure you have a recent Git master version of stack installed.

Go to a project and run:

$ stack ide start

If your projects conflict, it might fail to start successfully. stack-ide is such a project, so you should specify the target explicitly, e.g.

$ stack ide start stack-ide
{"tag":"ResponseWelcome","contents":[0,1,1]}
…