lein-clr

A Leiningen plugin to automate build tasks for ClojureCLR projects.

Leiningen 2 is required to use this plugin. You can use it for both .NET and Mono.

Important: This plugin is in Beta. Please report bugs, share ideas, comments etc.

Installation

Install as a project level plugin in project.clj:

:plugins [[lein-clr "0.2.2"]]

Note: lein-clr redefines the environment variables CLOJURE_LOAD_PATH and CLOJURE_COMPILE_PATH internally ignoring their original values.

Usage

The lein-clr plugin needs a :clr key in project.clj for CLR related details. See sample.project.clj for examples. The sub-sections below show how to get started.

Quickstart in 3 steps -- requires curl/wget and unzip on PATH

(Assuming you are on Windows with a recent version of the .NET framework or Mono. It should work on Unix-like systems using Mono if available in PATH. If you do not have curl/wget and unzip on PATH, consider Quickstart in 4 steps.)

1. Create a new Leiningen project

   C:\work> lein new lein-clr foo
   C:\work> cd foo
   

2. The default project.clj does not enable automatic download of ClojureCLR; enable that by editing project.clj under :clr as follows:

   • Uncomment [:wget :clj-zip :clj-url] and [:unzip "../clj" :clj-zip] under :deps-cmds.
   • Under :main-cmd and :compile-cmd replace :clj-exe with :clj-dep.

3. Run the build tasks

   C:\work\foo> lein clr test
   C:\work\foo> lein clr run -m foo.core
   C:\work=foo> lein clr -v compile foo.core
   

Quickstart in 4 steps

(Assuming you are on Windows with a recent version of the .NET framework or Mono. It should work on Unix-like systems using Mono if available in PATH.)

1. Download a recent ClojureCLR binary package from here:

   http://sourceforge.net/projects/clojureclr/files/

2. Uncompress it into a suitable directory and define an environment variable pointing to that directory location, e.g:

   CLJCLR14_40=C:\clojure-clr-1.4.1-Debug-40

3. Create a new Leiningen project

   C:\work> lein new lein-clr foo
   C:\work> cd foo
   

4. Try the build tasks

   C:\work\foo> lein clr test
   C:\work\foo> lein clr run -m foo.core
   C:\work\foo> lein clr -v compile
   

Build tasks

You can carry out a number of build tasks for ClojureCLR projects using Microsoft .NET or Mono. A synopsis of the tasks:

lein clr [-v] clean
lein clr [-v] compile
lein clr [-v] help
lein clr [-v] repl
lein clr [-v] run [-m ns-having-main] [arg1 [arg2] ...]
lein clr [-v] test [test-ns1 [test-ns2] ...]

Project configuration

lein-clr uses some regular attributes from project.clj for build tasks. Besides, there are some specific attributes you can refer to in the sample.project.clj file in this repo.

Getting in touch

Clojure discussion group: https://groups.google.com/group/clojure

Leiningen discussion group: https://groups.google.com/group/leiningen

With me: By Email or on Twitter: @kumarshantanu

License

Copyright © 2012-2014 Shantanu Kumar

Distributed under the Eclipse Public License, the same as Clojure.