Getting Started with Eclipse and Counterclockwise

http://dev.clojure.org/display/doc/Getting+Started+with+Eclipse+and+Counterclockwise

Go to start of metadata

 

• Install Eclipse (If you do not have Eclipse installed, or you want to make isolated tests of the Clojure plugin for Eclipse)
  • Grab the Eclipse ZIP file from http://www.eclipse.org/downloads . If you do not know which "package" to get, pick the "Eclipse IDE for Java Developers" one since it ships out of the box with Git support
  • Unzip it somewhere. The executable is eclipse (linux) or eclipse.exe (windows) located in the eclipse/ directory created by the unzip operation
  • The first time Eclipse is run, it will ask you for a location on your disk where eclipse will put its metadata and will create new projects by default.
• Install Counterclockwise (the Clojure plugin for Eclipse)
  • You install it via the “software update center”, that is:
  • Menu Help > Install new software…
  • Paste the following Counterclockwise url in the “Work with:” textbox: http://ccw.cgrand.net/updatesite/
  • Hit Enter
  • Select counterclockwise, verify the “Contact all update sites during …” chekbox is checked, click next, accept licence, etc., restart Eclipse
  • Go to menu Window > Reset Perspective ... this will reset the way the views are layout, and also and and place correctly the views contributed by counterclockwise (for now - July 2010 -, the Namespace Browser viewer, placed "behind" the code outline view)
• Create and run a simple Clojure project (Hello World)
  • Open the Java perspective: Window > Open Perspective > Java (a perspective is a predefined layout of views, suitable for a particular type of development)
  • Create a Clojure project: File > New > Project... > Clojure Project, name it firstClojureProject
  • Create a Clojure source code file in the src/ directory: File > New > File, twist down firstClojureProject in the file creation wizard and select "src" as the ** the parent folder, and name the file helloworld.clj
  • Type code in it to define a function: (defn hello [who] (str "Hello " who " !")) (leave the (ns helloworld) call at the beginning of the file), save the file
  • Run it: Select the firstClojureProject>src>helloworld.clj file, then menu Run > Run as > Clojure REPL. this evaluates the code and starts a REPL

  • Call your function (Hit Ctrl+Enter to send the expression to the REPL server):

    > 1:1 helloworld=> (hello "Betty") [Ctrl+Enter]
    > "Hello Betty !"

Installing and running the labrepl environment for learning Clojure

• If you have installed the "Eclipse IDE for Java Developers" package, you can skip the "Install EGit" and "Install m2e" following steps, since your package already ships with those "Eclipse Features"
• Install EGit, Git support in Eclipse (optional if you already use another git client)
  • You install it via the “software update center”, that is:
  • Menu Help > Install new software…
  • Paste the following EGit url in the “Work with:” textbox: http://download.eclipse.org/egit/updates
  • Hit Enter
  • Select “Eclipse EGit feature”, verify the “Contact all update sites during …” chekbox is checked, click next, accept licence, etc., restart Eclipse
• Install m2e, Maven support in Eclipse
  • You install it via the “software update center”, that is:
  • Menu Help > Install new software…
  • Paste the following maven2eclipse (m2e) url in the “Work with:” textbox: http://m2eclipse.sonatype.org/sites/m2e
  • Hit Enter
  • Select Maven Integration for Eclipse, verify the “Contact all update sites during …” chekbox is checked, click next, accept licence, etc., restart Eclipse
  • Note: for Maven, you need to have a JDK installed on your computer (not just a JRE), and configure it as the JVM for use when running Eclipse. (Maven gives a warning when Maven is used.)
• Grab labrepl from git via EGit
  • Menu File > Import … > Git > Projects From Git; Hit Next
  • URI: git://github.com/relevance/labrepl.git ; Hit Next ; Hit Next ; Check "Import as General Project" ; Hit Finish
• Enable Clojure Support
  • Right-click the "labrepl" project in Package Explorer and choose "Enable/disable Clojure language support"
• Run the labrepl
  • Right click on project “labrepl” in the Package Explorer
  • Run as > Clojure REPL

  • In the REPL Console:

    (require 'labrepl)
    (labrepl/-main)

  • Open your favorite Browser with URL localhost:8080
  • Enjoy the labs!