Atom.io and ProtoREPL

Proto REPL is a Clojure development environment and REPL for Atom.io.

Atom and ProtoREPL

Install Atom.io

Follow the instructions for your operating system

{% tabs debian=”Debian/Ubuntu”, mac=”MacOSX”, redhat=”RedHat”, windows=”Windows” %}

{% content “debian” %} The standalone install is the simplest option. However, using the package manager approach will simplify updating Atom.io to new versions.

Standalone Install

Download the latest .deb file from Atom.io

Once downloaded, double-click the .deb file to install.

Via Package Manager

Add the official Atom package repository to your system by running the following commands in a terminal window:

  1. curl -sL https://packagecloud.io/AtomEditor/atom/gpgkey | sudo apt-key add -
  2. sudo sh -c 'echo "deb [arch=amd64] https://packagecloud.io/AtomEditor/atom/any/ any main" > /etc/apt/sources.list.d/atom.list'
  3. sudo apt-get update
  4. sudo apt-get install atom

Running Atom

To run atom, press the Super key and type atom, or open a terminal and type the command atom.

{% content “mac” %}

Download the atom-mac.zip file.

Open the atom-mac.zip file (double click) and drag the Atom application into your “Applications” folder.

See Installing Atom for troubleshooting and further details.

{% content “redhat” %} Download the latest .rpm file from Atom.io

Once downloaded, double-click the .rpm file to install.

To run atom, press the Super key and type atom, or open a terminal and type the command atom.

See the Atom guide for Fedora if you wish to use the package manager instead.

{% content “windows” %}

Danger::Leiningen in GitBash does not work with Atom

Recommend using VSCode and Calva if you have installed Leiningen via GitBash method.

Downloaded AtomSetup.exe Windows Installer.

Open the AtomSetup.exe installer and follow the instructions.

This will install Atom, add the atom and apm commands to your PATH and create a shortcut in the start menu.

{% endtabs %}

Install Proto REPL package

Open the Atom Settings. In the install section, search for each of the required packages and install them. If you have time, also install the recommended packages.

Required packages

  • ink - Proto REPL dependency used for inline display and the REPL output.
  • proto-repl - Clojure REPL, autocompletion, etc.

Recommended packages

Configure ProtoREPL with Leiningen

Go to the Proto REPL Settings (Atom Preferences, then packages, then Proto REPL)

Modify “Lein Path” to the path where Leiningen.

Use which lein in a terminal to get the path.

Example project: Welcome to ClojureBridge

We have created an example Clojure project called “Welcome To ClojureBridge” to test your development tools.

{% tabs projectzip=”Download project as zip file”, projectclone=”Clone project from Github” %}

{% content “projectzip” %} Download the “Welcome To ClojureBridge” zip file and extract all the files.

{% content “projectclone” %} If you are comfortable using the git version control tool and the command line, then you can clone the project using git

  1. git clone https://github.com/ClojureBridge/welcometoclojurebridge

{% endtabs %}

Test your editor with a clojure project

Add the project called welcometoclojurebridge.

Open the project.clj file and add the dependency [proto-repl "0.3.1"].

Open the src/welcometoclojurebridge/core.clj file.

Ctrl-Alt-, s to start a Clojure REPL and display the REPL in a new window.

You should see a friendly message from the ClojureBridge team.