100 lines
4.3 KiB
Org Mode
100 lines
4.3 KiB
Org Mode
#+TITLE: crystal layer
|
||
|
||
[[file:img/crystal.png]]
|
||
|
||
* Table of Contents :TOC_4_gh:noexport:
|
||
- [[#description][Description]]
|
||
- [[#features][Features:]]
|
||
- [[#install][Install]]
|
||
- [[#repl][REPL]]
|
||
- [[#ameba][Ameba]]
|
||
- [[#layer][Layer]]
|
||
- [[#key-bindings][Key bindings]]
|
||
- [[#crystal-commands][Crystal commands]]
|
||
- [[#repl-1][REPL]]
|
||
- [[#ameba-1][Ameba]]
|
||
|
||
* Description
|
||
This layer provides support for the Crystal language.
|
||
|
||
** Features:
|
||
- =crystal tool format= on file save
|
||
- integration [[https://play.crystal-lang.org ][play.crystal-lang.org]] using [[https://github.com/veelenga/play-crystal.el][play-crystal.el]]
|
||
- Linting with flycheck
|
||
- test runner (=crystal spec=)
|
||
- =crystal tool= integration
|
||
- Interactive REPL ([[https://github.com/brantou/inf-crystal.el][inf-crystal.el]] and [[https://github.com/crystal-community/icr][icr]])
|
||
- static code analysis using [[https://github.com/veelenga/ameba.el][ameba]]
|
||
|
||
* Install
|
||
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
|
||
add =crystal= to the existing =dotspacemacs-configuration-layers= list in this
|
||
file.
|
||
|
||
** REPL
|
||
To be able to connect to [[https://github.com/brantou/inf-crystal.el][inf-crystal]], you need to make sure that [[https://github.com/crystal-community/icr][icr]] is
|
||
installed.
|
||
|
||
Installation instructions can be found on the main page of [[https://github.com/crystal-community/icr#installation][icr]].
|
||
|
||
Although not in the installation instruction it seems that on macOS you can
|
||
install it with Homebrew:
|
||
|
||
#+BEGIN_SRC sh
|
||
brew install crystal-icr
|
||
#+END_SRC
|
||
|
||
** Ameba
|
||
To be able to use [[https://github.com/veelenga/ameba.el][ameba.el]], you need to make sure that [[https://github.com/veelenga/ameba][ameba]] is installed.
|
||
|
||
Installation instructions can be found on the main page of [[https://github.com/veelenga/ameba][ameba]].
|
||
|
||
** Layer
|
||
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
|
||
add =crystal= to the existing =dotspacemacs-configuration-layers= list in this
|
||
file.
|
||
|
||
* Key bindings
|
||
** Crystal commands
|
||
|
||
| Key Binding | Description |
|
||
|-------------+-----------------------------------------------------------|
|
||
| ~SPC m e b~ | play-crystal submit buffer |
|
||
| ~SPC m e e~ | play-crystal show code in a browser |
|
||
| ~SPC m e i~ | download play-crystal snippet |
|
||
| ~SPC m e r~ | play-crystal submit region |
|
||
| ~SPC m g G~ | jump to definition in other window |
|
||
| ~SPC m g a~ | jump to matching spec file or back from spec to code file |
|
||
| ~SPC m g g~ | jump to definition |
|
||
| ~SPC m t b~ | run =crystal spec= for the current buffer |
|
||
| ~SPC m t p~ | run =crystal spec= for the current project |
|
||
| ~SPC m u c~ | show context |
|
||
| ~SPC m u e~ | show macro expansion |
|
||
| ~SPC m u f~ | format the current buffer |
|
||
| ~SPC m u i~ | show implementations for given call |
|
||
| ~SPC m x x~ | run =crystal run= for the current file |
|
||
|
||
** REPL
|
||
Start a inferior crystal REPL process with ~SPC m '~ or ~SPC m s i~.
|
||
Send code to inferior process commands:
|
||
|
||
| Key Binding | Description |
|
||
|-------------+---------------------------------------------|
|
||
| ~SPC m '~ | start inferior REPL process |
|
||
| ~SPC m s B~ | send buffer and switch to REPL |
|
||
| ~SPC m s F~ | send function definition and switch to REPL |
|
||
| ~SPC m s R~ | send region and switch to REPL |
|
||
| ~SPC m s b~ | send buffer |
|
||
| ~SPC m s f~ | send function definition |
|
||
| ~SPC m s i~ | start inferior REPL process |
|
||
| ~SPC m s r~ | send region |
|
||
| ~SPC m s s~ | switch to REPL |
|
||
|
||
** Ameba
|
||
|
||
| Key Binding | Description |
|
||
|-------------+------------------------------------------------|
|
||
| ~SPC m a d~ | Prompts from a directory on which to run Ameba |
|
||
| ~SPC m a f~ | Runs Ameba on the current visited file |
|
||
| ~SPC m a p~ | Runs Ameba on the entire project |
|