643 lines
29 KiB
Org Mode
643 lines
29 KiB
Org Mode
#+TITLE: Clojure layer
|
|
|
|
#+TAGS: dsl|layer|lisp|programming
|
|
|
|
[[file:img/clojure.png]] [[file:img/cider.png]]
|
|
|
|
* Table of Contents :TOC_5_gh:noexport:
|
|
- [[#description][Description]]
|
|
- [[#features][Features:]]
|
|
- [[#install][Install]]
|
|
- [[#layer][Layer]]
|
|
- [[#pretty-symbols][Pretty Symbols]]
|
|
- [[#enabling-sayid-or-clj-refactor][Enabling sayid or clj-refactor]]
|
|
- [[#enabling-automatic-linting][Enabling Automatic Linting]]
|
|
- [[#enable-clj-kondo-linter][Enable clj-kondo linter]]
|
|
- [[#enable-joker-linter][Enable joker linter]]
|
|
- [[#enable-squiggly-linter][Enable Squiggly linter]]
|
|
- [[#enable-multiple-linters][Enable multiple linters]]
|
|
- [[#starting-clojure-manually-outside-of-emacs][Starting Clojure manually (outside of Emacs)]]
|
|
- [[#quick-start-with-boot][Quick Start with boot]]
|
|
- [[#quick-start-with-lein][Quick Start with lein]]
|
|
- [[#more-details][More details]]
|
|
- [[#usage][Usage]]
|
|
- [[#cheatsheet][Cheatsheet]]
|
|
- [[#structuraly-safe-editing][Structuraly safe editing]]
|
|
- [[#key-bindings][Key bindings]]
|
|
- [[#working-with-clojure-files-barfage-slurpage--more][Working with clojure files (barfage, slurpage & more)]]
|
|
- [[#leader][Leader]]
|
|
- [[#documentation][Documentation]]
|
|
- [[#evaluation][Evaluation]]
|
|
- [[#goto][Goto]]
|
|
- [[#repl][REPL]]
|
|
- [[#tests][Tests]]
|
|
- [[#toggles][Toggles]]
|
|
- [[#debugging][Debugging]]
|
|
- [[#refactoring][Refactoring]]
|
|
- [[#reformatting][Reformatting]]
|
|
- [[#profiling][Profiling]]
|
|
- [[#cider-buffers][CIDER Buffers]]
|
|
- [[#cider-repl-mode][cider-repl-mode]]
|
|
- [[#stacktrace-mode][stacktrace-mode]]
|
|
- [[#inspector-mode][inspector-mode]]
|
|
- [[#test-report-mode][test-report-mode]]
|
|
- [[#sayid-buffers][Sayid Buffers]]
|
|
- [[#sayid-mode][sayid-mode]]
|
|
- [[#sayid-traced-mode][sayid-traced-mode]]
|
|
- [[#sayid-pprint][sayid-pprint]]
|
|
- [[#development-notes][Development Notes]]
|
|
- [[#indentation][Indentation]]
|
|
|
|
* Description
|
|
This layer adds support for [[https://clojure.org/][Clojure]] language using [[https://github.com/clojure-emacs/cider][CIDER]].
|
|
|
|
** Features:
|
|
- REPL via [[https://github.com/clojure-emacs/cider][CIDER]]
|
|
- Code formatting via [[https://github.com/clojure-emacs/cider][CIDER]] using [[https://github.com/weavejester/cljfmt][Cljfmt]]
|
|
- Refactoring via [[https://github.com/clojure-emacs/clj-refactor.el][clj-refactor]]
|
|
- Linting via [[https://github.com/clojure-emacs/squiggly-clojure][squiggly-clojure]], [[https://github.com/borkdude/clj-kondo][clj-kondo]] or [[https://github.com/candid82/joker][joker]]
|
|
- Aligning of code forms via [[https://github.com/clojure-emacs/clojure-mode][clojure-mode]]
|
|
- Debugging with [[https://github.com/clojure-emacs/sayid][sayid]]
|
|
- Clojure cheatsheet
|
|
- Structuraly safe editing using optional [[https://github.com/luxbock/evil-cleverparens][evil-cleverparens]]
|
|
|
|
* Install
|
|
** Layer
|
|
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
|
|
add =clojure= to the existing =dotspacemacs-configuration-layers= list in this
|
|
file.
|
|
|
|
** Pretty Symbols
|
|
Pretty symbols for anonymous functions, set literals and partial, like =(λ [a]
|
|
(+ a 5))=, =ƒ(+ % 5)=, =∈{2 4 6}= and =Ƥ=.
|
|
|
|
To enable this feature, add the following snippet to the
|
|
=dotspacemacs/user-config= section of your =~/.spacemacs= file:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq clojure-enable-fancify-symbols t)
|
|
#+END_SRC
|
|
|
|
Or set this variable when loading the configuration layer:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(setq-default dotspacemacs-configuration-layers
|
|
'((clojure :variables clojure-enable-fancify-symbols t)))
|
|
#+END_SRC
|
|
|
|
** Enabling sayid or clj-refactor
|
|
The packages sayid (Clojure debugger) and clj-refactor (automatic refactorings)
|
|
are disabled by default. To enable them, add a =:variables= option when enabling
|
|
the =clojure= layer, specifying =clojure-enable-sayid=, or
|
|
=clojure-enable-clj-refactor=, or both.
|
|
|
|
In your Spacemacs configuration:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
;; before
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
clojure
|
|
)
|
|
|
|
;; after
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
(clojure :variables
|
|
clojure-enable-sayid t
|
|
clojure-enable-clj-refactor t)
|
|
)
|
|
#+END_SRC
|
|
|
|
Enabling either of these packages will cause extra nREPL middleware to be
|
|
injected when jacking in CIDER.
|
|
|
|
** Enabling Automatic Linting
|
|
[[https://github.com/borkdude/clj-kondo][clj-kondo]], [[https://github.com/candid82/joker][joker]] and [[https://github.com/clojure-emacs/squiggly-clojure][squiggly-clojure]] provide automated linting via =flycheck=.
|
|
These packages are disabled by default as they require the relevant linter binaries
|
|
to be installed locally.
|
|
|
|
The recommended linter is to use [[https://github.com/borkdude/clj-kondo][clj-kondo]] in combination with [[https://github.com/candid82/joker][joker]]. Together they catch the most issues while both running extremely quickly.
|
|
|
|
squiggly reloads your code on every change which gives unexpected results if
|
|
your code is not re-loadable. squiggly also requires =org.clojure/core.typed= be
|
|
added to the development dependencies of your projects or build tool when using
|
|
=cider-connect=.
|
|
|
|
*** Enable clj-kondo linter
|
|
This linter based on static syntax checking and requires the [[https://github.com/borkdude/clj-kondo][clj-kondo]] binary
|
|
installed on the system PATH that =spacemacs.env= includes. Please read the
|
|
[[https://github.com/borkdude/clj-kondo/blob/master/doc/install.md][clj-kondo binary installation instructions]]
|
|
|
|
Enable the clj-kondo automatic linter in Spacemacs by adding a =:variables= option
|
|
to your Spacemacs configuration:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
;; Witout any variables your configuration would just include clojure
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
clojure
|
|
)
|
|
|
|
;; to use clj-kondo as a linter, add this variable to the clojure layer
|
|
;; wrapping the clojure layer in a list
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
(clojure :variables
|
|
clojure-enable-linters 'clj-kondo)
|
|
)
|
|
#+END_SRC
|
|
|
|
*** Enable joker linter
|
|
This linter is based on static syntax checking and requires the [[https://github.com/candid82/joker][joker]] binary
|
|
installed on the system PATH that =spacemacs.env= includes. Please read the
|
|
[[https://github.com/candid82/joker#installation][joker binary installation instructions]]
|
|
|
|
Enable the joker automatic linter in Spacemacs by adding a =:variables= option
|
|
to your Spacemacs configuration:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
;; Witout any variables your configuration would just include clojure
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
clojure
|
|
)
|
|
|
|
;; to use joker as a linter, add this variable to the clojure layer
|
|
;; wrapping the clojure layer in a list
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
(clojure :variables
|
|
clojure-enable-linters 'joker)
|
|
)
|
|
#+END_SRC
|
|
|
|
*** Enable Squiggly linter
|
|
[[https://github.com/clojure-emacs/squiggly-clojure][squiggly-clojure]] uses [[https://github.com/jonase/eastwood][Eastwood]] and [[https://github.com/jonase/kibit][Kibit]] for linting. Please install these projects
|
|
before configuring Spacemacs with =squiggly=.
|
|
|
|
Make sure to read the [[https://github.com/clojure-emacs/squiggly-clojure#warnings][squiggly-clojure warnings section]].
|
|
|
|
Please read the section on [[https://github.com/clojure-emacs/squiggly-clojure#dependencies-in-clojure][squiggly dependencies]] if you are using =cider-connect=
|
|
|
|
Enable the squiggly (eastwood, kibit and core.typed) automatic linter in Spacemacs by adding a =:variables= option to your Spacemacs configuration:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
;; Without any variables your configuration would just include Clojure
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
clojure
|
|
)
|
|
|
|
;; to use squiggly as a linter, add this variable to the clojure layer
|
|
;; wrapping the clojure layer in a list
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
(clojure :variables
|
|
clojure-enable-linters 'squiggly)
|
|
)
|
|
|
|
#+END_SRC
|
|
|
|
Troubleshooting: please read [[https://github.com/clojure-emacs/squiggly-clojure#debugging-and-bug-reporting][debugging and bug reporting]] and try to reproduce using the [[https://github.com/clojure-emacs/squiggly-clojure/tree/master/sample-project][sample project]].
|
|
|
|
*** Enable multiple linters
|
|
You can choose to enable multiple linters and have them all run together. This gives you better linting coverage, as they don't catch all the same issues.
|
|
|
|
You will need to follow their individual install instructions first, to get all their necessary binaries and configs on the system PATH that =spacemacs.env= includes. Please refer to their individual Enable ... linter section respectively.
|
|
|
|
Once all the linters you want to enable are installed, you simply need to specify a list of them in the =:variables= option to your Spacemacs configuration:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
;; Witout any variables your configuration would just include clojure
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
clojure
|
|
)
|
|
|
|
;; to enable multiple linters, say clj-kondo and joker, add a list variable to the clojure layer
|
|
;; listing each one in the order you want them running, wrapping the clojure layer in a list
|
|
dotspacemacs-configuration-layers
|
|
'(...
|
|
(clojure :variables
|
|
clojure-enable-linters '(clj-kondo joker))
|
|
)
|
|
#+END_SRC
|
|
|
|
** Starting Clojure manually (outside of Emacs)
|
|
CIDER communicates with your Clojure process through nREPL, and for CIDER to
|
|
function correctly extra nREPL middleware needs to be present
|
|
(cider/cider-nrepl). The same is true for clj-refactor (refactor-nrepl), and for
|
|
sayid (com.billpiel/sayid).
|
|
|
|
When starting the Clojure process through cider (=cider-jack-in= and friends)
|
|
this will be handled automatically, and so most users should be able to just run
|
|
~SPC m s i~ to connect to the CIDER REPL and skip the rest of this section.
|
|
|
|
If you are running an older version of CIDER (0.10 or older), or if you are
|
|
starting the Clojure process yourself outside of Emacs, then you need to make
|
|
sure the necessary dependencies are present, and the necessary nREPL middlewares
|
|
are enabled.
|
|
|
|
*** Quick Start with boot
|
|
- Install =boot= 2.8.2 or newer (see [[https://github.com/boot-clj/boot#user-content-install]])
|
|
- Create a file =~/.boot/profile.boot= with the following content:
|
|
|
|
#+BEGIN_SRC clojure
|
|
(require 'boot.repl)
|
|
|
|
(swap! boot.repl/*default-dependencies* conj
|
|
;; When running an older version of CIDER (pre 0.18), use the
|
|
;; version that best matches M-x cider-version. For versions since
|
|
;; 0.18.0 use whatever version is the most recent.
|
|
'[cider/cider-nrepl "0.21.1"]
|
|
|
|
;; Only necessary when using clj-refactor
|
|
'[refactor-nrepl "2.4.0"]
|
|
|
|
;; Only necessary when using sayid
|
|
'[com.billpiel/sayid "0.0.17"])
|
|
|
|
(swap! boot.repl/*default-middleware* conj
|
|
'cider.nrepl/cider-middleware
|
|
'refactor-nrepl.middleware/wrap-refactor
|
|
'com.billpiel.sayid.nrepl-middleware/wrap-sayid)
|
|
#+END_SRC
|
|
|
|
*** Quick Start with lein
|
|
- Install =lein= version 2.9.0 or newer (see [[https://leiningen.org/#install]])
|
|
- Create a file =~/.lein/profiles.clj= with the following content:
|
|
|
|
#+BEGIN_SRC clojure
|
|
{:repl
|
|
{:plugins [;; When running an older version of CIDER (pre 0.18), use the
|
|
;; version that best matches M-x cider-version. For versions since
|
|
;; 0.18.0 use whatever version is the most recent.
|
|
[cider/cider-nrepl "0.21.1"]
|
|
|
|
;; Only necessary when using clj-refactor
|
|
[refactor-nrepl "2.4.0"]
|
|
|
|
;; Only necessary when using sayid
|
|
[com.billpiel/sayid "0.0.17"]]
|
|
|
|
:dependencies [[nrepl "0.4.5"]]
|
|
|
|
:repl-options
|
|
{:nrepl-middleware [refactor-nrepl.middleware/wrap-refactor ;; clj-refactor
|
|
com.billpiel.sayid.nrepl-middleware/wrap-sayid ;; sayid
|
|
]}}}
|
|
#+END_SRC
|
|
|
|
*** More details
|
|
More info regarding installation of nREPL middleware can be found here:
|
|
- CIDER: [[https://cider.readthedocs.io/en/latest/installation/][CIDER installation (official docs)]]
|
|
- clj-refactor: [[https://github.com/clojure-emacs/refactor-nrepl][refactor-nrepl]]
|
|
|
|
* Usage
|
|
** Cheatsheet
|
|
This layers installs the [[https://github.com/clojure-emacs/clojure-cheatsheet][clojure-cheatsheet]] package which embeds this useful
|
|
[[https://clojure.org/api/cheatsheet][cheatsheet]] into Emacs.
|
|
|
|
Type ~SPC m h c~ to display the cheatsheet then type in some terms (space
|
|
separated) to narrow down the list. For example, try typing in sort map to see
|
|
some functions that deal with sorting maps.
|
|
|
|
** Structuraly safe editing
|
|
This layer adds support for =evil-cleverparens= which allows to safely edit
|
|
lisp code by keeping the s-expressions balanced.
|
|
|
|
By default this mode is not activated. You can turn it on locally on the active
|
|
buffer with ~SPC m T s~ (=s= for safe).
|
|
|
|
To turn it on automatically for all =clojure= buffers call the following
|
|
function in your =dotspacemacs/user-config= function:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(spacemacs/toggle-evil-safe-lisp-structural-editing-on-register-hook-clojure-mode)
|
|
#+END_SRC
|
|
|
|
or to enable it for all supported modes:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(spacemacs/toggle-evil-safe-lisp-structural-editing-on-register-hooks)
|
|
#+END_SRC
|
|
|
|
When enabled the symbol =🆂= should be displayed in the mode-line.
|
|
|
|
* Key bindings
|
|
** Working with clojure files (barfage, slurpage & more)
|
|
Spacemacs comes with a special =lisp-state= for working with lisp code that
|
|
supports slurpage, barfage and more tools you'll likely want when working with
|
|
lisp.
|
|
|
|
As this state works the same for all files, the documentation is in global
|
|
[[https://github.com/syl20bnr/spacemacs/blob/master/doc/DOCUMENTATION.org#lisp-key-bindings][DOCUMENTATION.org]]. In general, use ~SPC k~ to interact with the lisp-state.
|
|
|
|
** Leader
|
|
*** Documentation
|
|
|
|
| Key binding | Description |
|
|
|-------------+-----------------------------|
|
|
| ~SPC m h a~ | cider apropos |
|
|
| ~SPC m h c~ | clojure cheatsheet |
|
|
| ~SPC m h d~ | cider clojuredocs |
|
|
| ~SPC m h h~ | cider doc |
|
|
| ~SPC m h j~ | cider javadoc |
|
|
| ~SPC m h n~ | cider browse namespace |
|
|
| ~SPC m h N~ | cider browse all namespaces |
|
|
|
|
*** Evaluation
|
|
|
|
| Key binding | Description |
|
|
|-------------+-----------------------------------------------------------|
|
|
| ~SPC m e ;~ | eval sexp and show result as comment |
|
|
| ~SPC m e b~ | eval buffer |
|
|
| ~SPC m e e~ | eval last sexp |
|
|
| ~SPC m e f~ | eval function at point |
|
|
| ~SPC m e i~ | interrupt the current evaluation |
|
|
| ~SPC m e r~ | eval region |
|
|
| ~SPC m e m~ | cider macroexpand 1 |
|
|
| ~SPC m e M~ | cider macroexpand all |
|
|
| ~SPC m e p~ | print last sexp (clojure interaction mode only) |
|
|
| ~SPC m e P~ | eval last sexp and pretty print result in separate buffer |
|
|
| ~SPC m e u~ | Undefine a symbol from the current namespace |
|
|
| ~SPC m e v~ | eval sexp around point |
|
|
| ~SPC m e w~ | eval last sexp and replace with result |
|
|
|
|
*** Goto
|
|
|
|
| Key binding | Description |
|
|
|-------------+----------------------------------------------|
|
|
| ~SPC m g b~ | go back |
|
|
| ~SPC m g C~ | browse classpath |
|
|
| ~SPC m g g~ | goto var definition =spacemacs/clj-find-var= |
|
|
| ~SPC m g e~ | goto error |
|
|
| ~SPC m g n~ | goto namespace |
|
|
| ~SPC m g r~ | goto resource |
|
|
| ~SPC m g s~ | browse spec |
|
|
| ~SPC m g S~ | browse all specs |
|
|
|
|
*** REPL
|
|
|
|
| Key binding | Description |
|
|
|---------------+--------------------------------------------------------------------------------|
|
|
| ~SPC m ,~ | handle shortcut (cider-repl-handle-shortcut) |
|
|
| ~SPC m s b~ | send and eval buffer in REPL |
|
|
| ~SPC m s B~ | send and eval buffer and switch to REPL in =insert state= |
|
|
| ~SPC m s c~ | connect to REPL (cider-connect) or clear repl buffer (cider-repl-clear-buffer) |
|
|
| ~SPC m s C~ | clear REPL (cider-find-and-clear-repl-output) |
|
|
| ~SPC m s e~ | send and eval last sexp in REPL |
|
|
| ~SPC m s E~ | send and eval last sexp and switch to REPL in =insert state= |
|
|
| ~SPC m s f~ | send and eval function in REPL |
|
|
| ~SPC m s F~ | send and eval function and switch to REPL in =insert state= |
|
|
| ~SPC m s j c~ | start Clojure REPL (=cider-jack-in-clj=) |
|
|
| ~SPC m s j f~ | start Clojure REPL (=cider-jack-in-clj&cljs=) |
|
|
| ~SPC m s j s~ | start ClojureScript REPL (=cider-jack-in-cljs=) |
|
|
| ~SPC m s n~ | send and eval ns form in REPL |
|
|
| ~SPC m s N~ | send and eval ns form and switch to REPL in =insert state= |
|
|
| ~SPC m s q~ | kill REPL (cider-quit) |
|
|
| ~SPC m s o~ | switch to other repl instance (cider-repl-switch-to-other) |
|
|
| ~SPC m s r~ | send and eval region in REPL |
|
|
| ~SPC m s R~ | send and eval region and switch to REPL in =insert state= |
|
|
| ~SPC m s s~ | switch to REPL or jump to last file or last clj buffer from repl (cider-repl) |
|
|
| ~SPC m s u~ | require Clojure utils into current namespace - i.e. functions =doc= =source= |
|
|
| ~SPC m s x~ | refresh REPL |
|
|
| ~SPC m s X~ | restart REPL |
|
|
|
|
*** Tests
|
|
|
|
| Key binding | Description |
|
|
|-------------+------------------------------------|
|
|
| ~SPC m t a~ | run all tests in namespace |
|
|
| ~SPC m t r~ | re-run test failures for namespace |
|
|
| ~SPC m t t~ | run test at point |
|
|
|
|
*** Toggles
|
|
|
|
| Key binding | Description |
|
|
|-------------+-----------------------------|
|
|
| ~SPC m T e~ | toggle englighten mode |
|
|
| ~SPC m T f~ | toggle REPL font-locking |
|
|
| ~SPC m T i~ | toggle indentation style |
|
|
| ~SPC m T p~ | toggle REPL pretty-printing |
|
|
| ~SPC m T t~ | toggle auto test mode |
|
|
|
|
*** Debugging
|
|
|
|
| Key binding | Description |
|
|
|---------------+----------------------------------------------------|
|
|
| ~SPC m d !~ | reload traces and clear sayid workspace |
|
|
| ~SPC m d b~ | instrument expression at point |
|
|
| ~SPC m d c~ | clear workspace trace log |
|
|
| ~SPC m d e~ | display last stacktrace |
|
|
| ~SPC m d E~ | one time display of value at cursor |
|
|
| ~SPC m d f~ | query form at point |
|
|
| ~SPC m d h~ | show sayid help (key bindings may not be accurate) |
|
|
| ~SPC m d i~ | inspect expression at point |
|
|
| ~SPC m d r~ | reload namespaces |
|
|
| ~SPC m d s~ | show what is currently traced |
|
|
| ~SPC m d S~ | show what is currently traced in current namespace |
|
|
| ~SPC m d t b~ | trace current file's namespace |
|
|
| ~SPC m d t d~ | disable existing trace on current function |
|
|
| ~SPC m d t D~ | disable existing trace on all functions |
|
|
| ~SPC m d t e~ | enable existing trace on current function |
|
|
| ~SPC m d t E~ | enable existing trace on all functions |
|
|
| ~SPC m d t K~ | remove all traces |
|
|
| ~SPC m d t n~ | create inner trace on function |
|
|
| ~SPC m d t o~ | create outer trace on function |
|
|
| ~SPC m d t p~ | trace namespaces by regex |
|
|
| ~SPC m d t r~ | remove trace on function |
|
|
| ~SPC m d t y~ | recursively trace every namespace in given dir |
|
|
| ~SPC m d v~ | inspect expression at point |
|
|
| ~SPC m d V~ | set the view |
|
|
| ~SPC m d w~ | open sayid workspace window |
|
|
| ~SPC m d x~ | clear workspace traces and log |
|
|
|
|
*** Refactoring
|
|
The following refactoring key bindings are enabled by default in clojure-mode:
|
|
|
|
| Key binding | Description |
|
|
|---------------+----------------------------------------------------------------|
|
|
| ~SPC m r c i~ | cycle between if and if-not forms |
|
|
| ~SPC m r c p~ | cycle privacy of defn and def forms |
|
|
| ~SPC m r c (~ | convert coll to list |
|
|
| ~SPC m r c '~ | convert coll to quoted list |
|
|
| ~SPC m r c {~ | convert coll to map |
|
|
| ~SPC m r c #~ | convert coll to set |
|
|
| ~SPC m r c [~ | convert coll to vector |
|
|
| ~SPC m r t f~ | rewrite the following form to use the -> (thread first) macro. |
|
|
| ~SPC m r t l~ | rewrite the following form to use the ->> (thread last) macro. |
|
|
| ~SPC m r t h~ | thread another form into the surrounding threading macro |
|
|
| ~SPC m r u a~ | unwind all steps of surrounding threading macro |
|
|
| ~SPC m r u w~ | unwind threading macro one step at a time |
|
|
|
|
The following refactorings require cljr-refactor to be enabled and generally depend on a connected CIDER session.
|
|
|
|
| Key binding | Description |
|
|
|---------------+-----------------------------------|
|
|
| ~SPC m r ?~ | describe refactoring |
|
|
| ~SPC m r a d~ | add declaration |
|
|
| ~SPC m r a i~ | add import to ns |
|
|
| ~SPC m r a m~ | add missing libspec |
|
|
| ~SPC m r a p~ | add project dependency |
|
|
| ~SPC m r a r~ | add require to ns |
|
|
| ~SPC m r a u~ | add use to ns |
|
|
| ~SPC m r c :~ | toggle between keyword and string |
|
|
| ~SPC m r c n~ | clean ns |
|
|
| ~SPC m r d k~ | destructure keys |
|
|
| ~SPC m r e c~ | extract constant |
|
|
| ~SPC m r e d~ | extract definition |
|
|
| ~SPC m r e f~ | extract function |
|
|
| ~SPC m r e l~ | expand let |
|
|
| ~SPC m r f u~ | find usages |
|
|
| ~SPC m r f e~ | create fn from example |
|
|
| ~SPC m r h d~ | hotload dependency |
|
|
| ~SPC m r i l~ | introduce let |
|
|
| ~SPC m r i s~ | inline symbol |
|
|
| ~SPC m r m f~ | move form |
|
|
| ~SPC m r m l~ | move to let |
|
|
| ~SPC m r p c~ | project clean |
|
|
| ~SPC m r p f~ | promote function |
|
|
| ~SPC m r r d~ | remove debug fns |
|
|
| ~SPC m r r f~ | rename file |
|
|
| ~SPC m r r l~ | remove let |
|
|
| ~SPC m r r r~ | remove unused requires |
|
|
| ~SPC m r r s~ | rename symbol |
|
|
| ~SPC m r r u~ | replace use |
|
|
| ~SPC m r s n~ | sort ns |
|
|
| ~SPC m r s p~ | sort project dependencies |
|
|
| ~SPC m r s r~ | stop referring |
|
|
| ~SPC m r s c~ | show changelog |
|
|
| ~SPC m r u p~ | update project dependencies |
|
|
|
|
*** Reformatting
|
|
|
|
| Key binding | Description |
|
|
|--------------------------+-------------------------|
|
|
| ~SPC m f b~ or ~SPC m =~ | reformat current buffer |
|
|
| ~SPC m f l~ | realign current form |
|
|
| | |
|
|
|
|
*** Profiling
|
|
|
|
| Key binding | Description |
|
|
|-------------+----------------------|
|
|
| ~SPC m p +~ | profile samples |
|
|
| ~SPC m p c~ | clear profile |
|
|
| ~SPC m p n~ | toggle profile ns |
|
|
| ~SPC m p s~ | profile summary |
|
|
| ~SPC m p S~ | summary for all |
|
|
| ~SPC m p t~ | toggle profile |
|
|
| ~SPC m p v~ | is variable profiled |
|
|
|
|
** CIDER Buffers
|
|
In general, ~q~ should always quit the popped up buffer.
|
|
|
|
*** cider-repl-mode
|
|
|
|
| Key binding | Description |
|
|
|-------------+----------------|
|
|
| ~C-j~ | next input |
|
|
| ~C-k~ | previous input |
|
|
|
|
*** stacktrace-mode
|
|
|
|
| Key binding | Description |
|
|
|-------------+---------------------|
|
|
| ~C-j~ | next cause |
|
|
| ~C-k~ | previous cause |
|
|
| ~TAB~ | cycle current cause |
|
|
| ~0~ | cycle all causes |
|
|
| ~1~ | cycle cause 1 |
|
|
| ~2~ | cycle cause 2 |
|
|
| ~3~ | cycle cause 3 |
|
|
| ~4~ | cycle cause 4 |
|
|
| ~5~ | cycle cause 5 |
|
|
| ~a~ | toggle all |
|
|
| ~c~ | toggle clj |
|
|
| ~d~ | toggle duplicates |
|
|
| ~J~ | toggle java |
|
|
| ~r~ | toggle repl |
|
|
| ~T~ | toggle tooling |
|
|
|
|
*** inspector-mode
|
|
|
|
| Key binding | Description |
|
|
|-------------+---------------------------------|
|
|
| ~TAB~ | next inspectable object |
|
|
| ~Shift-TAB~ | previous inspectable object |
|
|
| ~RET~ | inspect object |
|
|
| ~L~ | pop to the parent object |
|
|
| ~n~ | next page in paginated view |
|
|
| ~N~ | previous page in paginated view |
|
|
| ~r~ | refresh |
|
|
| ~s~ | set a new page size |
|
|
|
|
*** test-report-mode
|
|
|
|
| Key binding | Description |
|
|
|-------------+--------------------|
|
|
| ~C-j~ | next result |
|
|
| ~C-k~ | previous result |
|
|
| ~RET~ | jump to test |
|
|
| ~d~ | ediff test result |
|
|
| ~e~ | show stacktrace |
|
|
| ~r~ | rerun failed tests |
|
|
| ~t~ | run test |
|
|
| ~T~ | run tests |
|
|
|
|
** Sayid Buffers
|
|
*** sayid-mode
|
|
|
|
| Key binding | Description |
|
|
|--------------------+---------------------------------------------------|
|
|
| ~Shift-Backspace~ | forward buffer state |
|
|
| ~enter~ | pop to function |
|
|
| ~d~ | def value to $s/* |
|
|
| ~f~ | query for calls to function |
|
|
| ~F~ | query to calls to function with modifier |
|
|
| ~i~ | show only this instance |
|
|
| ~I~ | show only this instance with modifier |
|
|
| ~L~ or ~Backspace~ | previous buffer state |
|
|
| ~n~ | jump to next call |
|
|
| ~N~ | jump to previous call |
|
|
| ~P~ | pretty print value |
|
|
| ~C~ | clear workspace trace log |
|
|
| ~e~ | generate instance expression and put in kill ring |
|
|
| ~H~ | display help (key bindings may not be accurate) |
|
|
| ~w~ | show full workspace trace |
|
|
| ~C-s v~ | toggle view |
|
|
| ~C-s V~ | set view |
|
|
|
|
*** sayid-traced-mode
|
|
|
|
| Key binding | Description |
|
|
|-------------+-------------------------------------------------|
|
|
| ~backspace~ | go back to trace overview |
|
|
| ~enter~ | drill into ns at point |
|
|
| ~e~ | enable trace |
|
|
| ~E~ | enable all traces |
|
|
| ~d~ | disable trace |
|
|
| ~D~ | disable all traces |
|
|
| ~h~ | display help (key bindings may not be accurate) |
|
|
| ~i~ | apply inner trace to function at point |
|
|
| ~o~ | apply outer trace to function at point |
|
|
| ~r~ | remove trace at point |
|
|
|
|
*** sayid-pprint
|
|
|
|
| Key binding | Description |
|
|
|-------------+-----------------------------|
|
|
| ~enter~ | show path in minibuffer |
|
|
| ~i~ | enter child node |
|
|
| ~o~ | enter parent node |
|
|
| ~n~ | enter next sibling node |
|
|
| ~p~ | enter previous sibling node |
|
|
|
|
* Development Notes
|
|
** Indentation
|
|
With a [[https://github.com/clojure-emacs/cider/blob/master/doc/modules/ROOT/pages/indent_spec.adoc][Indentation spec]] functionality of Cider to read the custom indentation rules from the
|
|
var's metadata, it is better for consistency reasons to not add the custom
|
|
indentation rules to Spacemacs, but to add them to the metadata of those
|
|
specific vars.
|