Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
= Clojure-contrib = The user contributions library, clojure-contrib, is a collection of namespaces implementing features that may be useful to a large part of the Clojure community. Clojure-contrib is open source under the Eclipse Public License and is copyrighted by Rich Hickey and the various contributors. Download releases from http://clojure.org/downloads The official source repository for clojure-contrib is http://github.com/clojure/clojure-contrib Documentation and APIs are available at http://clojure.github.com/clojure-contrib/ Issues are maintained in the Assembla space at http://www.assembla.com/spaces/clojure-contrib General discussion occurs in the Clojure Google group at http://groups.google.com/group/clojure and developer discussions are in the Clojure Dev Google group at http://groups.google.com/group/clojure-dev Compiled JARs of released versions are available in the Maven repository http://build.clojure.org/releases and SNAPSHOT versions are available at http://build.clojure.org/snapshots = Building Clojure-contrib = If you downloaded a release distribution or pre-compiled JAR, you do NOT need to build anything. If you downloaded the sources from Github, you will need Apache Maven (2.0 or higher) to run the build. See http://maven.apache.org/ AFTER version 1.2.0, clojure-contrib is divided into many small modules. To build all the modules, run the following command in this directory: mvn install This will compile and test all modules and store them in your local Maven repository cache (usually $HOME/.m2/repository). There is also an "uberjar" containing all compiled modules at ./modules/complete/target/complete-$VERSION-bin.jar Additional build commands are available: mvn clojure:repl To start a Clojure REPL (Read-Eval-Print Loop) mvn compile To compile sources without building a JAR mvn test To run unit tests mvn assembly:assembly To build ZIP/tar distributions containing source and JARs To skip the testing phase when building, add "-Dmaven.test.skip=true" to the mvn command line. = Building Against Specific Released Clojure Versions = You can specify -Dclojure.version=VERSION on the command line to select a different Clojure version. = Building Against a Custom Clojure JAR = To build against a customized Clojure JAR, build *Clojure* like this: 1. Modify the Clojure sources with your custom changes 2. Set a custom version number in src/clj/clojure/version.properties 3. Download maven-ant-tasks.jar from http://maven.apache.org/ant-tasks/download.html 4. In the Clojure source directory, run: ant -lib /path/to/maven-ant-tasks.jar ci-build THEN, build clojure-contrib with -Dclojure.version=YOUR_CUSTOM_VERSION = Clojure-contrib Versions = Versions of clojure-contrib are matched to versions of Clojure. If you are using Clojure 1.0, use clojure-contrib 1.0.* If you are using Clojure 1.1, use clojure-contrib 1.1.* If you are using Clojure 1.2, use clojure-contrib 1.2.* If you are using Clojure 1.3, use clojure-contrib 1.3.* If you are using Clojure from the "master" branch on Github, use clojure-contrib from the "master" branch on Github. = Clojure-contrib Committers = The following people are committers to the official clojure-contrib repositiory: Tom Faulhaber Stephen Gilardi Christophe Grand Rich Hickey Konrad Hinsen Stuart Holloway Chris Houser David Miller Stuart Sierra Frantisek Sodomka