ericdallo / deps-bin

A Clojure library that builds an executable containing a embedded jar inside

deps-bin

A Clojure library that builds an executable containing a embedded jar inside. This library is a deps.edn only alternative for lein-binplus. It will create a executable file that exec java -jar with the provided jvm options, so you still need java on your $PATH.

On MS-Windows, the executable has a .bat extension, since technically it is a script calling java with an embedded jar file.

Usage

To generate a executable, simply merge:

{:bin {:extra-deps {com.github.ericdallo/deps-bin {:mvn/version "RELEASE"}}
       :exec-fn deps-bin.deps-bin/bin
       :exec-args {:jar "my-jar.jar" 
                   :name "my-bin"}}}

into your deps.edn, and build with:

$ clojure -X:bin

and it should generate a executable that you can run with:

./my-bin

In this example, it expects that you have a jar my-jar.jar, you can generate it with depstar, for example:

$ clojure -X:jar && clojure -X:bin

Other options

• :help true -- show this help (and exit)
• :jar sym-or-str -- specify the source name of the JAR file
• :name sym-or-str -- specify the name of the generated BIN file
• :skip-realign true -- if should skip byte alignment repair.
• :jvm-opts [strs] -- optional list of JVM options to use during bin executing
• :platforms [kws] -- optional list of platforms for which to emit bins, valid kws: :unix, :windows, defaults to system platform

Contribution

Contributions are very welcome, please open an issue or a pull request if inspired :)

deps-bin's Issues

Support generation of bin files on MS-Windows

Currently the lib generates a bash script with an embedded jar, use the same technique to generate a windows batch file.