leinjacker is a library of utilities for Leiningen plug-in developers. Current features include:
leinjacker.eval gives you an easy way for your project to call
and have it work independent of the version of Leiningen the user is running. Additionally,
there is a function
hook-eval-in-project. This function can be used provide custom behavior
(like middleware) for
eval-in-project, such as for code instrumentation or alternative JVM
Finally, there is the
in-project macro. This allows you to eval code in your project without
having to construct the form by hand. You just provide the bindings used to pass state to your
project along with the code that uses those bindings.
leinjacker.deps adds some handy functions for querying and manipulating the dependencies
of a project.
leinjacker.utils provides useful utilities for supporting multiple Leiningen generations,
try-resolve-any- useful for resolving namespaced symbols at runtime.
lein-generation- returns the current Leiningen generation (1 or 2) as an integer.
lein-home- returns the path to current Leiningen home (typically
~/.lein/). This abstracts away the location of Leiningen's
leiningen-home, since it moved between generations.
read-lein-project- reads a
project.cljand returns the project map. This abstracts away the location and name of Leiningen's project read function, since it was renamed between generations.
abort- 1.x- and 2.x-compatible way to signal task failure.
apply-task- 1.x- and 2.x-compatible way to apply arguments to a task.
get-classpath- 1.x- and 2.x-compatible way to get the classpath from a project map.
leinjacker.lein-runner has functions for finding and running the
lein command on the
path for each Leiningen generation. Useful for testing plugins under various Leiningen
versions. It provides:
find-lein-cmd- looks for
leinon the $PATH by trying to call it. It takes a
generationargument, which should be
2. It will then look for a command called
lein<generation>that reports the correct generation when called with
lein version. It will memoize the found cmd to
./.lein-commandsto speed up subsequent calls. This can be disabled via the
run-lein- Will execute the given Leiningen
dirwith the given
args, returning the result map from the 'clojure.java.shell/sh' call.
See leinjacker's tests for examples of usage.
Just drop the following into your plug-in’s
(defproject lein-tau "6.283" :name "The π is a lie!" ;; other stuff :dependencies [[leinjacker "0.4.2"] ;; more deps ])
Although this library is built using Leiningen 2, the library itself does not require it. It should also work with Clojure 1.2 and above.
If you ever find yourself writing the same generic code in more than one of your plug-ins, feel free to send it here.
Copyright © 2012 Sattvik Software & Technology Resources, Ltd. Co. All rights reserved.
Distributed under the Eclipse Public License, the same as Clojure.