Setting Up HaskellMon Sep 17, 2012
su -c apt-get install haskell-platform haskell-mode hlint emacs -nw ~/.cabal/config ### make sure that `-- documentation: True` and `-- library-profiling: True` cabal install hoogle ~/.cabal/bin/hoogle data cabal install hasktags git clone git://github.com/nominolo/scion.git cd scion cabal install
Then go configure your
.emacs properly. There; I just saved you some long, tedious, boobless hours.
Installing Haskell itself is extremely easy, assuming you're on a relatively recent version of Debian.
apt-get install haskell-platform
should handle that nicely. That will install
ghc (the Haskell compiler),
ghci (the Haskell interpreter) and
cabal (the Haskell package manager). Ok, now before you install anything else, hop into your favorite editor, open up
~/.cabal/config and change the options
-- library-profiling: and
-- documentation: to
True. These both default to false, but having them on is preferable for the development process.
documentation flag isn't critical, just nice. It gives you some extra local docs with the libraries it downloads. I'm honestly surprised that
profiling isn't on by default though. You just plain can't profile without it. If you try, you get an error telling you to install the
profiling versions of all relevant libraries. Here's the kicker though; if you try to install profiling libraries yourself from
cabal by using the
-p flag, it does not resolve dependencies. That means you get to go back through all the libraries you installed, and re-install them recursively by hand. If you do it through the
config option I mention above, it's automatically done for you whenever you install a new library. Which seems, I dunno, a bit better|1|.
I previously mentioned that hoogle is really useful, but that what you'd really want is a local copy you could search without hitting a server. Well, there is. It's a cabal package you can install with
cabal install hoogle hoogle data ## you may need to run the hoogle binary directly with "~/.cabal/bin/hoogle" instead of "hoogle"
That second command will make a local copy of the hoogle database for you. You can then use it to do a text search, like
hoogle map, or a type signature search like
hoogle "(Ord a) => [a] -> [a]". That will give you a long list of results matching your query. You can also use
hoogle --info [search term] to display the documentation of the first result, rather than a list of results.
Boy, it sure would be nice to have that available from your editor, huh?
If you're not an Emacs user, and are used to indenting things by hand (shudder), pick up leksah and be done with it. It's pretty cool, supports incremental compilation out of the box, has some small measure of project management, and performs pretty well. If you're like me, and have gotten used to Emacs handling the tedium of indentation|2|, you'll want a better solution.
The default Haskell mode is available standalone or from the Debian repos. There are apparently some non-obvious config tweaks to make with the standalone version which were done for you in the Debian package, so use the
apt-get option if you can.
You'll also want to install Scion, which will give you type hints in the minibuffer. Ostensibly, it also gives you goto-definition, and a couple of other small convenience facilities, but I've yet to get that working properly|3|. Actually do a
git clone of that github and install it manually, by the way. The version in
cabal has some dependency oddities that kept it from installing properly on my machine. YMMV, as always.
The last thing I ended up doing, though you may want to stick with the defaults, is wire up some extra keybindings for
hlint|4| and hoogle|5|.
And that's how you set up a Haskell environment. Or, at least, that's how I did. Hopefully, I can now start building some cool things with it.
1 - |back| - It's particularly odd when dealing with a fully lazy language, because it seems like that property would make it very difficult to reason about performance a priori. I may talk about that at some point in the future, but you're probably better off reading what Robert Harper says about it.
2 - |back| - Especially in languages with significant whitespace like Haskell.
3 - |back| - I use my own anyway.
4 - |back| - Inspired by this gist by Sam Ritchie. 5 - |back| - Not really inspired by anything, but extending the default
haskell-mode functionality which only lets you do the initial documentation search, rather than viewing.