Elixir layer
Table of ContentsClose
with 
1 Description
This layer adds support for Elixir .
Alchemist brings the Elixir tooling to Emacs and comes with a bunch of features like:
- Powerful IEx integration
- Mix integration
- Compile & Execution of Elixir code
- Inline code evaluation
- Documentation lookup
- Definition lookup
- Smart code completion
- Elixir project management
- Integration with company-mode
- Flycheck support for mix compile
- Flycheck support for credo
- Flycheck support for test results
2 Install
To use this configuration layer, add it to your ~/.spacemacs. You will need to
add elixir to the existing dotspacemacs-configuration-layers list in this
file.
3 Configuration
3.1 Flycheck
Note: since flycheck checkers are slow, the checks are enabled only at save time.
3.1.1 Credo
A flycheck checker for credo is installed. The check needs both bunt and
credo to be available, you can install them like this:
git clone https://github.com/rrrene/bunt
cd bunt
mix archive.build
mix archive.install
git clone https://github.com/rrrene/credo
cd credo
mix deps.get
mix archive.build
mix archive.install
3.1.2 mix compile
Important: Elixir compiler is based on macros and can execute arbitrary during compilation. Therefore Spacemacs disable flycheck compilation checker by default.
To enable flycheck support for compilation errors globally the variable
elixir-enable-compilation-checking can be set explicitly to t in your
dotfile but it is not recommended to do so because of the limitation described
above.
Instead you should use directory local variables in order to enable the flycheck
checker only for certain projects. Directory local variables are stored in a
file named .dir-local.el usually at the root of a project. To easily add a
directory local variable use the key binding SPC f v d then choose the
elixir-mode and the variable name elixir-enable-compilation-checking with
a value of t. The result is a new file .dir-local.el with the following
contents:
;;; Directory Local Variables ;;; For more information see (info "(emacs) Directory Variables") ((elixir-mode (elixir-enable-compilation-checking . t)))
Spacemacs marks the variable elixir-enable-compilation-checking as safe so
Emacs won't ask you if the variable is safe whenever an elixir file is opened.
Remember that you can verify the flycheck checkers status with SPC e v.
4 Key bindings
4.1 Refcard
You find and overview of all the key-bindings on the Alchemist-Refcard.
4.2 Help
| Key Binding | Description |
|---|---|
SPC m h : |
Run custom search for help |
SPC m h h |
Show help of the current expression |
SPC m h H |
Toggle through search history |
SPC m h r |
Show help for current region |
4.3 Mix
| Key Binding | Description |
|---|---|
SPC m m : |
Prompt for a mix command |
SPC m m c |
Compile the whole application |
SPC m m h |
Show help for a specific mix command |
SPC m m x |
Run the given expression in the Elixir application context |
4.4 Project
| Key Binding | Description |
|---|---|
SPC m p t |
Open project test directory and list all test files. |
SPC m g t |
Toggle between a file and its tests in the current window. |
SPC m g T |
Toggle between a file and its tests in other window. |
4.5 Evaluation in place
| Key Binding | Description |
|---|---|
SPC m e b |
Evaluate buffer |
SPC m e B |
Evaluate buffer and insert result |
SPC m e l |
Evaluate current line |
SPC m e L |
Evaluate current line and insert result |
SPC m e r |
Evaluate region |
SPC m e R |
Evaluate region and insert result |
4.6 REPL interactions
| Key Binding | Description |
|---|---|
SPC m s c |
Compiles the current buffer in the IEx process. |
SPC m s i |
Start an iex inferior process |
SPC m s I |
Start an IEx process with mix (iex -S mix) |
SPC m s l |
Send current line to REPL buffer |
SPC m s L |
Send current line to REPL buffer and focus it in insert state |
SPC m s m |
Reloads the module in the current buffer in your IEx process |
SPC m s r |
Send region to REPL buffer |
SPC m s R |
Send region to REPL buffer and focus it in insert state |
4.7 Tests
| Key Binding | Description |
|---|---|
SPC m g t |
Open the test file for current buffer |
SPC m t a |
Run all the tests |
SPC m t b |
Run all the tests from current buffer |
SPC m t r |
Rerun the last test |
SPC m t t |
Run test under point |
4.8 Compile
| Key Binding | Description |
|---|---|
SPC m c : |
Run a custom compile command with elixirc |
SPC m c b |
Compile the current buffer with elixirc. elixirc |
SPC m c f |
Compile the given filename with elixirc |