Clojure Dev Environment Setup

Instructions

Download and install the Java JDK (1.8+) (do not get the demo and samples version) http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

Check if Java is on your PATH by opening either a terminal or a command prompt and typing “java -version” You should see something like this:

Java(TM) SE Runtime Environment (build 1.8.0_131-b11)

Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)

Make sure that the version is 1.8 or greater.

If Java is not on your path, Google “How to add to your path ” and follow the instructions. For Mac / Linux, I would recommend adding to your path in the .bash_profile (assuming you are using Bash). This step is not complete until the previous step works. On Windows, you may need to restart your computer for path additions to show up. On Mac/Linux, you may need to “source ~/.bash_profile”
Install Git (https://git-scm.com/) and make sure it is on your path
Install Leiningen (https://leiningen.org/)
Check if Leiningen is on your path by opening either a terminal or command prompt and typing:

lein –version

You should see something like this:

Leiningen 2.7.1 on Java 1.8.0_131 Java HotSpot(TM) 64-Bit Server VM

Install Atom (https://atom.io/) -- Do not use an older version than 1.18 – only the official latest version for the class will be supported.
Use the Atom package manager "apm" command to install these plugins from the command line (or you can do it manually through preferences install -- make sure to install 0.9.0 for Ink and not 0.9.2+):

apm install platformio-ide-terminal parinfer lisp-paredit rainbow-delimiters proto-repl ink@0.9.0 atom-beautify atom-file-icons hasklig advanced-open-file

Install joker from: https://github.com/candid82/joker and make sure it is on your path
Use the "apm" command to install linter-jocker: "apm install linter-joker"
Open ore create the .lein/profiles.clj file in your home directory and set its contents to what is shown below. On Mac, this is in ~/.lein on Windows, it is typically in c:/Users/.../.lein, but can be other places (See here: technomancy/leiningen#1910).

{:user
{:dependencies [[clj-stacktrace "0.2.8"]
               [org.clojure/tools.trace "0.7.9"]
               [spyscope       "0.1.6"]]
:repl-options {
               :init (do (require 'clj-stacktrace.repl)
                         (set! *print-length* 50)
                         (set! *print-level* 3))
               :caught clj-stacktrace.repl/pst+}
:injections [(require 'spyscope.core)
             (require '[clojure.stacktrace :refer :all])
             (require '[clojure.tools.trace :refer :all])]}}

Clone the CSX278-DevEnvTest repo by opening a terminal or command prompt, changing to a directory where you would like to store it, and then running the command:

git clone https://github.com/juleswhite/CSX278-DevEnvTest

Open a terminal or command prompt and change to the directory that you just cloned (make sure there is a “src” folder)
Copy the contents of either the mac-keymap.cson or windows-keymap.cson into your Atom keyboard.cson (you can open it from within Atom by going to the Atom or File menu and selecting the Keymap option -- it is also available in the .atom configuration directory). Make sure and save the changes.
In the terminal from your project directory, run the command:

lein run

and you should see a welcome message. If you do not or you get an error, you made a mistake in one of your setup steps. Find and fix the mistake.

Run the command:

lein repl

and you should see a message like this:

nREPL server started on port 56244 on host 127.0.0.1 - nrepl://127.0.0.1:56244
REPL-y 0.3.7, nREPL 0.2.12
Clojure 1.8.0
Java HotSpot(TM) 64-Bit Server VM 1.8.0_131-b11
    Docs: (doc function-name-here)
          (find-doc "part-of-name-here")
  Source: (source function-name-here)
 Javadoc: (javadoc java-object-or-class-here)
    Exit: Control+D or (exit) or (quit)
 Results: Stored in vars *1, *2, *3, an exception in *e

Look for the port that the nREPL server was started on and remember it.

Whenever you are working on Clojure, you will want to start a REPL for your project, write down the port number, and then connect to it from Atom, which we will do in the next step.

Open Atom, File->“Add Project Folder”, and add the folder that you cloned. Make sure that you open the folder that you cloned and not its parent. If you do this correctly, a new project should show up that has a “src” folder at the top-level when you expand it.
In Atom, open the file src/x278/core.clj
Press “Cmd + r” (Mac) or "Ctrl + r" (Windows) (or run the Atom command "Proto Repl: Remote Nrepl Connection") and enter the port number that you wrote down from the nRepl step. A new Protorepl “repl” window should then open and you will see a message like this:

REPL Instructions

Code can be entered at the bottom and executed by pressing shift+enter.

Try it now by typing (+ 1 1) in the bottom section and pressing shift+enter.

Working in another Clojure file and sending forms to the REPL is the most efficient way to work. Use the following key bindings to send code to the REPL. See the settings for more keybindings.

ctrl-alt-, then b
Execute block. Finds the block of Clojure code your cursor is in and executes that.

ctrl-alt-, s
Executes the selection. Sends the selected text to the REPL.

You can disable this help text in the settings.
Starting remote REPL connection on localhost:55666Refreshing code...
:reloading (asgnx.core asgnx.core-test)
Refresh complete

Place the cursor immediately after the last ")" following "(defn print-welcome” and BEFORE the “(defn –main” and press either “Cmd + Enter” (Mac) or "Ctrl + Enter" (Windows). You should see “#'user/print-welcome” print in the repl window.

Cursor goes here:

(defn print-welcome []
    (println "  __        __   _                            _           ____ ____
  \\ \\      / /__| | ___ ___  _ __ ___   ___  | |_ ___    / ___/ ___|
   \\ \\ /\\ / / _ \\ |/ __/ _ \\| '_ ` _ \\ / _ \\ | __/ _ \\  | |   \\___ \\
    \\ V  V /  __/ | (_| (_) | | | | | |  __/ | || (_) | | |___ ___) |
     \\_/\\_/ \\___|_|\\___\\___/|_| |_| |_|\\___|  \\__\\___/   \\____|____/

        ____ _____ ___  _
  __  _|___ \\___  ( _ )| |
  \\ \\/ / __) | / // _ \\| |
   >  < / __/ / /| (_) |_|
  /_/\\_\\_____/_/  \\___/(_)
                          ")) <--put_the_cursor_here

In the repl (not the core.clj source file!), type “(print-welcome)” and hit “Shift+Enter”
If everything was done correctly, you should see the welcome message print in the repl. Copy this message VERBATIM and paste it in as the answer to the second question in the setup assignment.

IrfaanKhalid/CSX278-DevEnvTest

Clojure Dev Environment Setup

Instructions