2010-10-29 15:41:20 +00:00
|
|
|
# Clojure Koans
|
|
|
|
|
|
|
|
|
|
The Clojure Koans are a fun and easy way to get started with Clojure - no
|
|
|
|
|
experience assumed or required. Just follow the instructions below to start
|
|
|
|
|
making tests pass!
|
2010-01-15 01:13:17 +00:00
|
|
|
|
2010-05-27 18:22:26 +00:00
|
|
|
|
2010-01-15 01:13:17 +00:00
|
|
|
### Getting Started
|
|
|
|
|
|
2010-05-27 01:16:28 +00:00
|
|
|
The only things you need to run the Clojure Koans are:
|
|
|
|
|
|
|
|
|
|
- JRE 1.5 or higher
|
2010-10-29 15:07:11 +00:00
|
|
|
- clojure-1.3.0-alpha1.jar
|
2010-05-27 18:22:26 +00:00
|
|
|
|
2010-10-29 15:07:11 +00:00
|
|
|
clojure-1.3.0-alpha1.jar needs to be placed in a directory `lib` under this
|
|
|
|
|
project.
|
2010-05-27 01:16:28 +00:00
|
|
|
|
2010-10-29 15:07:11 +00:00
|
|
|
You can use Leiningen (http://github.com/technomancy/leiningen) to
|
|
|
|
|
automatically install the Clojure jar in the right place.
|
2010-05-27 01:16:28 +00:00
|
|
|
|
2010-05-27 18:22:26 +00:00
|
|
|
After you have leiningen installed, run
|
2010-01-15 01:13:17 +00:00
|
|
|
|
|
|
|
|
`lein deps`
|
|
|
|
|
|
|
|
|
|
which will download all dependencies you need to run the clojure koans.
|
|
|
|
|
|
2010-05-27 18:22:26 +00:00
|
|
|
|
2010-01-15 01:13:17 +00:00
|
|
|
### Running The Koans
|
|
|
|
|
|
|
|
|
|
To run the koans, simply run
|
|
|
|
|
|
2010-10-29 15:07:11 +00:00
|
|
|
`run.sh`
|
2010-05-27 01:16:28 +00:00
|
|
|
|
|
|
|
|
or, on Windows,
|
|
|
|
|
|
|
|
|
|
`run.bat`
|
2010-10-29 15:07:11 +00:00
|
|
|
|
2010-10-29 15:41:20 +00:00
|
|
|
|
2010-10-29 15:43:32 +00:00
|
|
|
|
|
|
|
|
### Contributing
|
|
|
|
|
|
|
|
|
|
Patches are encouraged! Make sure the answer sheet still passes (`test.sh`, or
|
|
|
|
|
`test.bat` on Windows), and send a pull request.
|
|
|
|
|
|
|
|
|
|
The file ideaboard.txt has lots of good places to start
|
|
|
|
|
|
|
|
|
|
|
2010-10-29 15:41:20 +00:00
|
|
|
### Contributors (in order of appearance)
|
|
|
|
|
|
|
|
|
|
- Aaron Bedra
|
|
|
|
|
- Colin Jones
|
|
|
|
|
- Eric Lavigne
|
|
|
|
|
- Nuno Marquez
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Credits
|
|
|
|
|
|
|
|
|
|
These exercises were started by [Aaron Bedra](http://github.com/abedra) of
|
|
|
|
|
[Relevance, Inc.](http://github.com/relevance) in early 2010, as a learning
|
|
|
|
|
tool for newcomers to functional programming. Aaron's macro-fu makes these
|
|
|
|
|
koans extremely simple and fun to use, and to improve upon, and Relevance's
|
|
|
|
|
initiative
|
|
|
|
|
|
|
|
|
|
Using the [koans](http://en.wikipedia.org/wiki/koan) metaphor as a tool for
|
|
|
|
|
learning a programming language started with the
|
|
|
|
|
[Ruby Koans](http://rubykoans.com) by [EdgeCase](http://github.com/edgecase).
|
|
|
|
|
|
