- Start a terminal
- Install Git
- Configure Git
- Make sure Java is installed
- Get Leiningen installed
- Get LightTable installed
- Get Heroku installed
- Test installation
For these instructions, and for much of the class, you will need to have a terminal, or command line, open. This is a text-based interface to talk to your computer, and you can open it by running Terminal.app, which is found under /Applications/Utilities. If you have never used the terminal before, you may want to spend some time reading up on command-line basics.
Go ahead and open your terminal now. It should look something like this:
The prompt (where you will type your commands) may look different: it usually shows the computer name and user name, as well as the folder or directory you are currently in.
For the rest of this setup, I will tell you to run commands in your terminal. When I say that, I mean "type the command into the terminal and press the Return key."
To see if you have git installed type in: git --version If you have git version 1.9.3 (Apple Git-50) or above you should be fine.
If not, visit git-scm.com. Click "Downloads for Mac". The Git installer may begin downloading automatically. If it does not, click the manual download link. Once the download has finished, open ~/Downloads in Finder and double-click the downloaded file (named something like git-2.0.1-intel-universal-snow-leopard.dmg). This will mount the disk image and open a new Finder window. Double-click the installer package (named something like git-2.0.1-intel-universal-snow-leopard.pkg). You may be told that the installer can't be opened because it is from an unidentified developer. If so, click "OK", then right-click (or control-click) the file and select "Open" from the contextual menu. You may be warned again that the installer is from an unidentified developer, but this time you'll have the option to click "Open". Do so. This will launch the installer. Follow its directions, and enter your password when prompted to do so. Once you have finished this process it's safe to unmount the disk image (by clicking the eject button in the Finder sidebar) and delete the file from the Downloads folder.
If you've used Git before then you should already have user.name and user.email configured. Otherwise, type this in the terminal:
git config --global user.name "Your Actual Name"
git config --global user.email "Your Actual Email"
TIP: Use the same email address for heroku, git, github, and ssh.
Verify by typing this in the terminal:
git config --get user.name
Expected result:
your name
git config --get user.email
Expected result:
your email address
Run java -version in your terminal. If you do not have Java installed, OS X will prompt you to install it. Follow all of the directions OS X gives you, then return to this part of the tutorial and run java -version again.
If Java is installed, you will see something like this in your terminal:
The details of Java's version may differ from what you see above; that is perfectly fine.
Leiningen is a tool used on the command line to manage Clojure projects.
To install lein, execute the following commands in your terminal. You will be prompted to enter your password.
curl https://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein > lein
sudo mkdir -p /usr/local/bin/
sudo mv lein /usr/local/bin/lein
sudo chmod a+x /usr/local/bin/lein
export PATH=$PATH:/usr/local/bin
After you run the above commands, run the lein version command. It should take a while to run, as it will download some resources it needs the first time. If it completes successfully, you are golden! If not, ask an instructor for help.
Go to the LightTable site. On the page there, you should see a set of buttons that have download links for Light Table. Click the "OS X 10.7+" button and you will download a .zip file.
There should now be a file named LightTableMac.zip in your Downloads folder. Double-click the file to unzip it, then move LightTable.app to your Applications folder.
The first time you launch LightTable you will be presented with a confirmation prompt. Click "Open".
Heroku is the tool we will use in order to put your application online where others can see it.
First, we need to create an account. Go to Heroku and click the "Sign up" link.
You will be taken to a form where you need to enter your email address in order to sign up. Fill out that form, and you will be sent an email with a link to click to continue the signup process.
After clicking on the link, you will be taken to another form where you will need to choose a password. Choose one and enter it twice.
After all that, you should be at your Heroku dashboard which verifies that you've successfully created your account. Next, you will need to download the Heroku Toolbelt. Download it from toolbelt.heroku.com.
This will download a .pkg file. Double-click it to install the Heroku Toolbelt and follow all prompts from the installation wizard. You will need your OS X account password to complete installation. If you are prompted to create an SSH key, say yes. It may also prompt you to install git. Once the Heroku Toolbelt is installed, go to your terminal and run the command heroku login. You will be prompted for your email and password on Heroku. If you enter them and the command ends successfully, congratulations!
To make your computer automatically communicate securely with Heroku, you will need to set up SSH. First, go to your terminal and run the command ssh-keygen. When prompted for inputs, simply press Return until the process has finished.
Finally, complete your SSH setup with Heroku by running the command heroku keys:add.
You have set up Java, Leiningen, LightTable, Git, and Heroku on your computer--all the tools you will need for this course. Before starting, we need to test them out.
Go to your terminal and run the following command:
git clone https://github.com/heroku/clojure-sample.git
This will check out a sample Clojure application from GitHub, a central repository for lots of source code. Your terminal should look similar to this picture:
Then run the command:
cd clojure-sample
This will put you in the directory with the source code for this sample bit of Clojure code. After that completes, run:
lein repl
This could take a long time, and will download many other pieces of code it relies on. You should see lines that start with Retrieving ... on your screen. When it finishes, your terminal should look like the following:
This is starting a REPL, which we will learn about soon. It's a special terminal for Clojure. At the REPL prompt, type (+ 1 1) and press Return. Did you get the answer 2 back? You will learn more about that in the course. For now, press the Control button and D button on your keyboard together (abbreviated as Ctrl+D). This should take you out of the Clojure REPL and back to your normal terminal prompt. sample.app=> Bye for now!
Now, start Applications > LightTable. Once it is started, press the Control button and Space Bar together (abbreviated Ctrl+Space). This is how you start giving LightTable a command. Start typing the word "instarepl" and you should see a menu of options, like below. Choose "Instarepl: open a clojure instarepl."
At the bottom left of the screen, you will see a cube moving and some text about connecting, retrieving and installing dependencies. Wait until that stops moving, then type (+ 1 1) into the window. It should look like the following image:
If that worked, great! Close LightTable.
We only have one more thing to test, Heroku.
Go back to your terminal. You should still be in the clojure-sample directory.
Run this command:
heroku create
There should be output about something being created. A URL will be displayed. Look at the following example:
Next, run the following commands:
git push heroku master
heroku open
Enter "yes" if you are asked if you are sure you want to connect, like in the following image:
Your browser should open (and take a long time to load), and you should see a website like the following:
If your browser does not open after running heroku open, start a browser and go to the URL displayed after you ran heroku create.
Congratulations! That website is running code you have on your computer that you have uploaded. You have actually made a very simple Clojure app, and your computer is all set up to make more.