Atom and ProtoREPL user guide

A simplified user guide to get you started quickly and a list of keyboard shortcuts.

Please take a look at the ProtoREPL documentation for a detailed guides.

{% youtube %} https://youtu.be/_P7urPN2QRQ {% endyoutube %}

Start a Local Clojure REPL

Ctrl-Shift-a to add a Clojure project to Atom. This should be a project created with Leiningen.

Open the project.clj file and add the latest proto-repl library as a dependency

Ctrl-Shift-p to pop-up the Command Palette (cmd-shift-p) and select Proto REPL: Toggle

ctrl-alt-, e will exit the REPL, (i.e. once you have finished the workshop).

Connecting to a Remote REPL

Proto REPL can connect to a Clojure REPL started with Leiningen on the command line.

Ctrl-Alt-, y and enter the hosts and port number from the already running REPL.

Alternatively, use Ctrl-Shift-p to pop-up the Command Palette (cmd-shift-p) and select Proto REPL: Remote Nrepl Connection. Enter the host and port of the REPL to establish the connection.

Evaluating Code

Code can be evaluated in a Clojure file or the REPL window.

shift+enter to evaluate code typed in the REPL window. The REPL maintains a history of the code typed in and can be navigated by using the up and down arrow keys.

ctrl-alt-, b evaluates an expression (a block of code)

ctrl-alt-, s evaluates a selected area of code

ctrl-alt-, f evaluates the whole Clojure file

Changing the REPL Namespace

Change the REPL namespace to get access to the functions in that namespace.

Place your cursor in the namespace definition, (ns my-namespace ,,,)

ctrl-alt-, b evaluates the namespace expression and change the REPL to this new namespace.

Keybindings and Events

Keyboard shortcuts below refer to using ctrl-alt-, then a letter. This means press the ctrl key and the comma key at the same time, release them, and then press the subsequent letter.