Editors & Tooling

• Introduction
• Using IHP with Visual Studio Code / VSCode
  • VSCode on Windows with Windows Subsystem for Linux
• Using IHP with Sublime Text
• Using IHP with Emacs
• Using IHP with Vim / NeoVim
  • Using CoC
• Notes on haskell-language-server
• Customizing the Web Browser used by IHP

Introduction

This place describes all the steps needed to get your code editors and other tooling working with IHP. When your favorite code editor is not described here, feel free to add your setup to this list.

You will also find steps on how to get autocompletion and smart IDE features. This is provided by haskell-language-server. IHP already comes with a bundled haskell-language-server, so you don’t need to install it manually.

Using IHP with Visual Studio Code / VSCode

Install the following extensions:

• nix-env-selector, this loads the project default.nix file, so all the right Haskell packages are available to VSCode
• Haskell, this gets smart IDE features with haskell-language-server
• Haskell HSX, provides support for HSX

To make file paths clickable inside the web browser (e.g. when a type error happens), export this env var in your shell (e.g. in .bashrc):

export IHP_EDITOR="code --goto"

VSCode on Windows with Windows Subsystem for Linux

It is important to not access the files within the WSL from Windows itself (however, the other way around is ok). You can seamlessly (including auto-save) work on your projects within WSL from VS Code in Windows by adding the Remote WSL extension from Microsoft.

Using IHP with Sublime Text

Works great already out of the box.

Recommended packages:

• Nix for syntax highlighting of nix files
• Direnv to load the .envrc file of the project.
• LSP for smart IDE features. Use LSP: Enable Language Server in Project -> Haskell Language Server to activate.

To make file paths clickable inside the web browser (e.g. when a type error happens), export this env var in your shell (e.g. in .bashrc):

export IHP_EDITOR="sublime"

Using IHP with Emacs

Install the following packages from Melpa:

• dante – gives IDE features via ghci, see https://github.com/jyp/dante#installation
• direnv-mode – lets haskell-mode and dante-mode find the PATH to ghci, see https://github.com/wbolster/emacs-direnv#installation
• attrap (optional) – apply fixes at point, see https://github.com/jyp/attrap

and put a .dir-locals.el file in your project root with:

((nil
  (dante-repl-command-line . ("ghci"))
  (haskell-process-type . ghci)))

Using IHP with Vim / NeoVim

Using CoC

Provided you already have CoC setup, just run :CocConfig and add the following segment.

{
    "languageserver": {
        "haskell": {
            "command": "haskell-language-server-wrapper",
            "args": ["--lsp"],
            "rootPatterns": [
                "*.cabal",
                "stack.yaml",
                "cabal.project",
                "package.yaml",
                "hie.yaml"
            ],
            "filetypes": ["haskell", "lhaskell"]
        }
    }
}

Notes on haskell-language-server

Because haskell-language-server is tightly coupled to the GHC version it comes pre-bundled with IHP. In case you also have a local install of haskell-language-server you need to make sure that the one provided by IHP is used. Usually, this is done automatically when your editor is picking up the .envrc file.

When something goes wrong you can also run haskell-language-server inside the project directory (within a nix-shell). This might output some helpful error messages.

Customizing the Web Browser used by IHP

When running ./start the application will automatically be opened in your default browser. You can manually specificy a browser by setting the env var IHP_BROWSER:

export IHP_BROWSER=firefox

You can disable the auto-start of the browser completely using echo as your browser:

export IHP_BROWSER=echo