emacs

Spacemacs for Clojure Development With Emacs - Configure Clojure

Adding the Clojure layer to Spacemacs provides great support for the language via CIDER, Clojure-mode, clj-refactor and lots of useful tools.

The Clojure layer also adds to the auto-completion layer, providing matches for anything currently defined in the current namespace. The yasnippets package also allows you to expand shortcuts for common Clojure code structures, eg. def, defn, let, require.

Adding Clojure support

Clojure support in Spacemacs is configured by adding the clojure layer. Edit ./spacemacs and add clojure to the list of layers defined in dotspacemacs-configuration-layers` function

1
(dotspacemacs-configuration-layers '(clojure)

For an example, see my spacemacs configuration on github. Please note that there are more configuration options added to this file than required for Clojure, only add the ones you understand.

Restarting Emacs will download by the related packages for Clojure.

You can also use SPC f e R (evil mode) or M-m f e R (holy mode) to reload the Spacemacs configuration and download packages, however for a big layer I have found a restart of Emacs is needed to load in all the new configuration.

Configure Pretty symbols

You can configure the Clojure layer to use pretty symbols to represent a few things in Clojure, such as:

1
2
3
4
(λ [a](+ a 5)) ;; anonymous function (fn ...)
ƒ(+ % 5)       ;; anonymous function shorthand #(...)
∈{2 4 6}       ;; set #{...}
Ƥ              ;; partial function (partial ...)

To enable this feature, edit the ./spacemacs file and add the following snippet to the dotspacemacs/user-config function:

1
(setq clojure-enable-fancify-symbols t)

Configure Leiningen

Install Leiningen using the instructions on Leiningen.org, or if you already have Leiningen installed then check you have the latest version via lein upgrade

Leiningen should be version 2.6.x or greater as of 22nd February 2015

If you are using CIDER 0.11 or greater then you are done, as from this version the Leiningen dependencies are automatically injected when you start cider-jack-in.

Clojure REPL - CIDER dependency injection for cider-jack-in

Only for CIDER 0.10 or earlier

Edit the Leiningen profile configuration for your useer, eg. ~/.lein/profiles.clj and add the following plugins and dependencies:

1
2
3
4
{:user {:plugins      [[cider/cider-nrepl "0.11.0-SNAPSHOT"]
                       [refactor-nrepl "2.0.0-SNAPSHOT"]]
        :dependencies [[alembic "0.3.2"]
                       [org.clojure/tools.nrepl "0.2.12"]]}}

Plugin versions are the latest as of 28th December 2015.
You can also check for the latest versions of cider-nrepl, refactor-nrepl, alembic & tools.nrepl

The cider-nrepl plugin should match the version of CIDER used in Spacemacs, found by using M-x cider-version. You will see a warning message in the REPL buffer if the versions do not match, for example:

Clojure REPL - CIDER and cider-nrepl version mis-match

Summary

Now you have the Clojure layer and Leiningen configured so you can create your Clojure apps with ease. Next time we will show how to use the REPL to evaluate code, giving you almost instant feedback on what you have created.

Thank you
jr0cket

This work is licensed under a Creative Commons Attribution 4.0 ShareAlike License, including custom images & stylesheets. Permissions beyond the scope of this license may be available at @jr0cket
Creative Commons License