Evaluate in the REPL Buffer

If you are used to working directly in the REPL, then you can easily open and work in a REPL buffer. You will need a Clojure project open and must have started a REPL.

, s a toggles between the REPL buffer and a source code buffer. The REPL buffer will be shown in a new window if it is not currently being displayed.

Evaluate in the source file buffers

Evaluating code source file buffers is typically more effective as the code is saved to a file. The whole buffer can be evaluated, , e b or just a specific expression, , e f. Even nested expressions can be evaluated, , e e. Expressions results can be added as a comment, , e ;, to have a record of results and results can also be pretty printed , e P.

Change REPL buffer namespace

user is the default namespace of the REPL. This namespace includes the doc and source functions from clojure.repl. This namespace is different to that of your project, so you will need to change the namespace of the REPL before calling any code in a project.

, s n from the source code buffer will change the REPL namespace to the same as the source code namespace.

The REPL prompt should now show the namespace you have changed into.

Using the REPL buffer to evaluate

i for Evil insert state to use the REPL buffer.

Type in expressions at the REPL prompt and press RET to evaluate them.

C-RET to add a new line and write an expression over multiple lines. RET to evaluate the expression when ready.

C-j and C-k in Evil normal state cycle through the history of expressions entered in the REPL buffer.

Send expressions to the REPL buffer

, s f will send the current expression to the REPL to be evaluated.

To call a function, it must be in the namespace the REPL is currently set to. Or you can send a function definition to the REPL before and then you are able to call that function.

, s f will send the current function definition to the REPL. Then you can either call that function from the REPL buffer or use , e f to send an expression that calls the function to the REPL buffer.

Changing the namespace in the REPL buffer

The in-ns function will change the REPL namespace to that specified in its argument. For example:

(in-ns 'spacemacs-workshop.core) in the REPL buffer will change to the spacemacs-workshop.core namespace.

REPL Buffer shortcut menu

, at the start of a line in Evil Insert state will open a list of command shortcuts for the REPL.

Clojure send to REPL menu

Clojure send to REPL - quit sub menu

Clojure REPL tools

, s u adds the REPL utility functions apropos, dir, dir-fn, doc, find-doc and source into the current REPL namespace.

These REPL utility functions are included in the user namespace by default. See the clojure.repl api documentation for full details