Switching to the REPL
re-write this section
Update for Clojure CLI tools
, s a
toggles between a Clojure code file buffer and the REPL buffer, opening the REPL buffer where required.
, s n
evaluates the namespace of the current Clojure file in the REPL, changing the REPL to be in that namespace.
To REPL buffer or not to REPL buffer
Many developers simply evaluate functions and expressions within the Clojure code buffer itself.
A REPL buffer is very useful for showing larger results from evaluating code and any side effect information such as logging and debugging.
Select the REPL namespace
SPC SPC cider-repl-set-ns
displays a pop-up buffer of all the available namespaces.
A running REPL is required.
The user namespace
When starting a REPL the default namespace is called user
. This namespace contains the clojure.repl
library allowing you to call functions useful for development, such as (doc ,,,)
, (source ,,,)
, etc.
To use the doc
and source
tools, you can stay in the user
namespace and use require
function to include your own code in the user
namespace. For example:
(require 'my-custom-code.core)
(require '[my-custom-code-time :as time])
Setting the default REPL namespace
Set the namespace used when starting the REPL in the project.clj
file by adding :init-ns
to the :repl-options
:repl-options {:init-ns the-default.namespace}
Keybindings
Keybinding | Description |
---|---|
, s a |
toggle between source code and REPL buffer |
, s o |
Switch between CLJ & CLJS REPLs in current project |
REPL Buffer
The REPL buffer contains a detailed welcome message describing how to use the basics of the REPL.