Skip to content
This repository
Newer
Older
100644 153 lines (117 sloc) 6.966 kb
624832e8 »
2010-01-14 working first lab
1 # labrepl for Clojure
2
3 Copyright (c) Relevance, Inc. All rights reserved.
db97156e »
2010-03-24 reorg README
4
c96dc789 »
2010-03-10 rock-paper-scissors draft complete
5 The use and distribution terms for this software are covered by the
6 Eclipse Public License 1.0 (http://opensource.org/licenses/eclipse-1.0.php)
7 which can be found in the file epl-v10.html at the root of this distribution.
8 By using this software in any fashion, you are agreeing to be bound by
9 the terms of this license.
488ac7dd »
2010-03-23 update readme, commit pom
10
db97156e »
2010-03-24 reorg README
11 You must not remove this notice, or any other, from this software.
a4715207 »
2010-03-23 extended support for maven
12
db97156e »
2010-03-24 reorg README
13 Instructions below for getting started with NetBeans/Enclojure, Eclipse/Counterclockwise, Maven, Mac/Linux command line, Windows command line, IDEA/La Clojure, and Emacs.
488ac7dd »
2010-03-23 update readme, commit pom
14
db97156e »
2010-03-24 reorg README
15 ## Getting Started (NetBeans/Enclojure)
488ac7dd »
2010-03-23 update readme, commit pom
16
6ac98e2a »
2010-03-23 enhanced instructions for Netbeans
17 One-time setup
18
19 * Grab labrepl from git
20 * you do not need leiningen or to do the lein or any other steps above
21 * If you've just installed Netbeans, activate feature Java SE
22 * Activate features is on the Start page
23 * or from Tools, Plugins, Installed
24 * Install enclojure
25 * Make sure you use [the latest .nbm from 2010-march-23](http://github.com/downloads/EricThorsen/enclojure/enclojure-plugin-2010-23-mar.nbm)
26 * Tools/Plugins/Downloaded, locate downloaded .nbm
27 * Restart Netbeans w/enclojure plugin installed
28 * Open project labrepl
29 * File, Open project, select directory where you pulled labrepl
30 * Right click on Libraries in the project pane
31 * Download missing dependencies
32 * wait for that to complete
33
34 To run the labrepl
35
36 * Right click on project in the project pane
37 * Start Project REPL
38 * In the integrated REPL:
39 * `(require 'labrepl)`
40 * `(labrepl/-main)`
41 * Browse to localhost:8080
42 * Enjoy the labs!
488ac7dd »
2010-03-23 update readme, commit pom
43
db97156e »
2010-03-24 reorg README
44 ## Getting Started (Eclipse/Counterclockwise)
488ac7dd »
2010-03-23 update readme, commit pom
45
46 * The repository includes Eclipse .project and .classpath files. If you are using the counterclockwise Eclipse plugin (http://code.google.com/p/counterclockwise/) you should be able to import the project into your workspace.
47
db97156e »
2010-03-24 reorg README
48 One-time setup
488ac7dd »
2010-03-23 update readme, commit pom
49
db97156e »
2010-03-24 reorg README
50 * If you do not have Eclipse installed
51 * Grab a recent version of eclipse, e.g. the "Eclipse IDE for java developers" from the download page: http://www.eclipse.org/downloads/
52 * Unzip it somewhere. The executable is eclipse (linux) eclipse.exe (windows) located in the eclipse/ directory created by the unzip operation
53 * The first time it 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.
54 * If you do not have Eclipse Git (EGit) installed
55 * You install it via the "software update center", that is:
56 * Menu Help > Install new software...
57 * Paste the following EGit url in the "Work with:" textbox: http://download.eclipse.org/egit/updates
58 * Hit Enter
59 * Select "Eclipse EGit feature", verify the "Contact all update sites during ..." chekbox is checked, click next, accept licence, etc., restart Eclipse
60 * If you do not have maven support in Eclipse (plugin m2e)
61 * You install it via the "software update center", that is:
62 * Menu Help > Install new software...
63 * Paste the following maven2eclipse (m2e) url in the "Work with:" textbox: http://m2eclipse.sonatype.org/sites/m2e
64 * Hit Enter
65 * Select Maven Integration for Eclipse, verify the "Contact all update sites during ..." chekbox is checked, click next, accept licence, etc., restart Eclipse
66 * If you do not have Counterclockwise installed
67 * You install it via the "software update center", that is:
68 * Menu Help > Install new software...
69 * Paste the following Counterclockwise url in the "Work with:" textbox: http://updatesite.counterclockwise.googlecode.com/hg/
70 * Hit Enter
71 * Select counterclockwise, verify the "Contact all update sites during ..." chekbox is checked, click next, accept licence, etc., restart Eclipse
72 * Grab labrepl from git via EGit
73 * Menu File > Import ... > Git > Git Repository ; Hit Next
74 * URI: git://github.com/relevance/labrepl.git ; Hit Next ; Hit Next ; Hit Next ; Hit Finish
75 * You now have a project named labrepl in eclipse
76 * Download project labrepl project's dependencies
77 * In the Package Explorer, right click on project labrepl > Maven > Enable Dependency Management
78 * Wait while the project is updated (takes time because it is downloading all the missing dependencies automatically)
488ac7dd »
2010-03-23 update readme, commit pom
79
db97156e »
2010-03-24 reorg README
80 To run the labrepl
81
82 * Right click on project "labrepl" in the Package Explorer
83 * Run as > Clojure REPL
84 * In the REPL Console:
85 * `(require 'labrepl)`
86 * `(labrepl/-main)`
87 * Browse to localhost:8080
88 * Enjoy the labs!
89
90 ## Getting Started (Maven)
91
92 * Make sure you have Java installed.
93 * Make sure you have Maven (http://maven.apache.org/) installed.
94 * Run `mvn clojure:repl` to launch Clojure REPL (maven will download all necessary
95 dependencies).
96 * Browse to localhost:8080 for instructions.
97 * Press Ctrl+D to exit the repl when you are done.
98
99 ## Getting Started (Mac/Linux command line)
100
101 * Make sure you have Java installed.
102 * Make sure you have leiningen installed (http://github.com/technomancy/leiningen).
103 * Run `lein deps` to install dependent libs.
104 * Run `script/repl` to launch the labrepl.
105 * Browse to localhost:8080 for instructions.
106 * Press Ctrl+D to exit the repl when you are done.
107
108 ## Getting Started (Windows command line)
109
110 This is minimally tested. You are probably better off using Maven or one of the IDEs above. Let me know if you have problems.
111
112 * Make sure you have Java installed.
113 * Make sure you have leiningen installed (http://github.com/technomancy/leiningen). Do not use `lein self-install` as Windows installation is a manual process. You will need to:
114 * Download leinigen.jar and set `LEIN_JAR` to point to it.
115 * Download a Clojure 1.1 clojure.jar (from clojure.org) and set `CLOJURE_JAR` to point to it.
116 * Set your path to include `{your-lein-install}\bin`
117 * Run `lein.bat deps` to install dependent libs
118 * Run `script\repl` to launch the labrepl.
119 * Browse to localhost:8080 for instructions.
120 * Press Ctrl+D to exit the repl when you are done.
121
122 ## Getting Started (IDEA/La Clojure)
123
124 Help wanted here. You can use the maven install instructions, then create an IDEA project over existing sources, accept the defaults, and things will *partially* work. Completion will work against project code, but not against functions in clojure and clojure-contrib. If you know how to fix this, please send me a patch.
125
126 ## Getting Started (Emacs)
488ac7dd »
2010-03-23 update readme, commit pom
127
128 If you don't know emacs you may want to pick one of the choices above. The learning curve is steep.
129
db97156e »
2010-03-24 reorg README
130 * Install Emacs, the Emacs Starter Kit, Clojure mode, slime, and swank.
488ac7dd »
2010-03-23 update readme, commit pom
131 * From within emacs, set the `inferior-lisp-program` variable to `script/swank`.
132 * Making sure your emacs working directory is the labrepl, run `inferior-lisp`.
133 * If you want slime as well, run `slime-connect` and accept the defaults. You now have slime and inferior-lisp both working simultaneously.
134
db97156e »
2010-03-24 reorg README
135 ## Running the Tests
45d389d2 »
2010-03-24 instructions for running the tests
136
db97156e »
2010-03-24 reorg README
137 * Maven: `mvn clojure:test`
138 * Shell: `script/test`
45d389d2 »
2010-03-24 instructions for running the tests
139
db97156e »
2010-03-24 reorg README
140 ## Thanks for contributions and reviews from
c374fd4c »
2010-01-15 LJK feedback
141
96b492f1 »
2010-02-17 license
142 * Aaron Bedra
d37fd85b »
2010-03-23 new lab: looping
143 * Rich Hickey
c374fd4c »
2010-01-15 LJK feedback
144 * Larry Karnowski
d37fd85b »
2010-03-23 new lab: looping
145 * Michael Kohl
96b492f1 »
2010-02-17 license
146 * Jess Martin
d37fd85b »
2010-03-23 new lab: looping
147 * Alex Ott
db97156e »
2010-03-24 reorg README
148 * Laurent Petit
96b492f1 »
2010-02-17 license
149
150
45d389d2 »
2010-03-24 instructions for running the tests
151
624832e8 »
2010-01-14 working first lab
152
Something went wrong with that request. Please try again.