Description

Find some jars and start a Clojure VM with them.

This is meant to be a simpler, more transparent and faster running alternative to Leiningen's Clojure startup commands. The assumption is that you have a few directories that contain all the jars that you need to run, and you just want to start a Clojure VM with those. Leiningen has been useful to the community, but unfortunately has multiple problems:

• it downloads a lot of files from the internet, much of which we don't really need
• is very slow to start, but virtue of the fact that it's written itself in Clojure, and occasionally gets in a funked state.
• installs separate copies/caches of files in a private repo, which sometimes gets borked (and the recovery involves deleting the local repo and reinstalling)
• is not able to work offline properly (2012-03-31, I'm writing this on the train, pissed off I can't work on my project without internet access)

This script...

• Does not download anything for you: you download your jars yourself, you build them, resolve dependencies, put them wherever you like; I assume you know better. I'm not attempting to solve that problem, I just wanna run Clojure without unexpected magic. (However, the chasing of dependencies is a problem in Java, in general, which needs resolving, and that can be made independent of this script).
• Given a list of directories, it finds all the jar files anywhere under them. If multiple versions of a library are found, it selects the higest versioned one. The script ignores duplicates (i.e. you're allowed to be a little messy, real life is sometimes messy). Also, you can specify jar files directly.
• It also tries to identify projects with some .clj files in them and if the directory names under the .clj files correspond to the namespace directires, it automatically adds their source directories to the classpath. This works for the typical Leiningen project hierarchies and Clojure core projects.
• Finally, it starts a JVM with those libraries, invoking a REPL or a Swank for you, with debugging options if you want. It supports options for cdt. You can also run as a main program.

The script is very transparent about what it does (use -v or -vv to have it print full details), there's no hidden magic (in particular, no Maven or Ant stuff). You'll probably enjoy using this if you're not coming to Clojure from a Java background.

Note: this is not an attempt to replace the full functionality of Leiningen, but an attempt to make running Clojure _very_ easy (when you've already fetched all the jars you need).

To run a REPL, invoke one of these:

streamlined [DIR] [DIR ...]  --repl
streamlined [DIR] [DIR ...]  --swank
streamlined [DIR] [DIR ...]  --nrepl

To start a main program, try this:

streamlined [DIR] [DIR ...]  --main [NAMESPACE] -- [ARG1] [ARG2 ...]

Please Donate!

Download

Download program here.