elm-mode
elm-mode copied to clipboard
jcollard
Elm mode for emacs
elm-mode
Elm mode for Emacs.
Features
- Syntax highlighting.
- Intelligent indentation.
- Integration with
elm-make - Integration with
elm-repl - Integration with
elm-reactor - Integration with
elm-package - Integration with elm-format
- Integration with elm-test
Indentation
elm-mode indentation is based on cycling: every time you insert a new
line there will be one or more indentation levels available for you to
choose from. The exact number is printed in the minibuffer either as
Sole indentation or Indent cycle (n)... where n is the number of
available indentations to choose from. If the automatic indentation
level was not the one you expected simply hit TAB to cycle through the
list (note that hitting any other key will cancel the cycle).
Simpler indentation
There is also a simpler indentation mode, Elm Indent Simple which doesn't try
to be as smart as the default one. The benefit of this mode is that it works a
little more similarly to how more conventional editors handle indentation:
indent one step forward by pressing TAB, one step backward with S-TAB.
It tries to be a little smart, however, and guess the easiest to determine indentation levels.
You can enable it by setting a variable, elm-mode-indent-mode to
#'elm-indent-simple-mode, for example by doing this:
(setq elm-mode-hook '(elm-indent-simple-mode))
Installation
This package requires Emacs 25.1 or later.
MELPA
You can install elm-mode from the package in
MELPA. This is by far the most straightforward
and recommended installation method.
From source
Add this repo to your load-path and (require 'elm-mode). Ensure that
you have installed all the dependencies listed in the Package-Requires
header of elm-mode.el.
Bindings
The following bindings are available in elm-mode:
TAGS
| Keybinding | Description |
|---|---|
| C-c M-t | Generate a TAGS file for the current project. |
| M-. | Jump to tag at point. |
| M-, | Jump to previous location after visiting a tag. |
TAGS file generation requires that the UNIX find, egrep commands
and the Emacs etags command be available in your path.
Set or customize elm-tags-on-save to t to generate a new TAGS file
for the current project on every save.
Set or customize elm-tags-exclude-elm-stuff to nil to include
source files inside elm-stuff directories when generating the TAGS
file.
elm-make
| Keybinding | Description |
|---|---|
| C-c C-c | Compile the current buffer. |
| C-u C-c C-c | Compile the current buffer, specifying the output file. |
| C-c M-c | Compile the main elm file. |
| C-u C-c M-c | Compile the main elm file, specifying the output file. |
| C-c C-a | Add missing type annotations to the current buffer. |
| C-u C-c C-a | Add missing type annotations to the current buffer, prompting before each change. |
| C-c C-r | Clean up imports in the current buffer. |
| C-u C-c C-r | Clean up imports in the current buffer, prompting before each change. |
elm-repl
| Keybinding | Description |
|---|---|
| C-c C-l | Load the current file in a REPL. |
| C-c C-p | Push the current region to a REPL. |
| C-c C-e | Push the current decl. to a REPL (requires haskell-mode). |
elm-reactor
| Keybinding | Description |
|---|---|
| C-c C-n | Preview the current buffer in a browser. |
| C-u C-c C-n | Preview the current buffer in a browser in debug mode. |
| C-c C-m | Preview the main elm file in a browser. |
| C-u C-c C-m | Preview the main elm file in a browser in debug mode. |
elm-package
| Keybinding | Description |
|---|---|
| C-c C-d | View a function's documentation in a browser. |
| C-c C-i | Import a module from one of the dependencies. |
| C-c C-s | Sort the imports in the current file. |
| C-c M-k | Open the package catalog. |
| C-u C-c M-k | Open the package catalog, refreshing the package list first. |
The following bindings are available in the package list buffer:
| Keybinding | Description |
|---|---|
| g | Refresh package list. |
| n | Next package. |
| p | Previous package. |
| v | View package in browser. |
| m | Mark package for installation. |
| i | Mark package for installation. |
| u | Unmark package. |
| x | Install marked packages. |
Set or customize elm-sort-imports-on-save to t to apply
elm-sort-imports on the current buffer on every save.
Completion for Elm >= 0.19
To obtain completion, code navigation and other niceties, use
elm-language-server
and an LSP package. eglot is a lightweight
LSP front-end package for Emacs, and has built-in support for elm-language-server.
Some users might prefer the rather larger and more opinionated lsp-mode.
elm-format
The following functionality requires elm-format to be
installed. elm-format does not come with the Elm installer so you
will have to install it manually.
| Keybinding | Description |
|---|---|
| C-c C-f | Automatically format the current buffer. |
Enable elm-format-on-save-mode to apply elm-format on the current
buffer on every save. You might like to add it to your
elm-mode-hook:
(add-hook 'elm-mode-hook 'elm-format-on-save-mode)
Alternatively, you can enable it on a per-project basis by including an
entry like the following in your .dir-locals.el:
(elm-mode (mode . elm-format-on-save))
elm-test
The following functionality requires elm-test to be
installed. elm-test does not come with the Elm installer so you
will have to install it manually.
| Keybinding | Description |
|---|---|
| C-c C-v | Run the test suite for the current project. |
jcollard