depstar

a clj-based uberjarrer (forked from healthfinch/depstar and enhanced)

Usage

Install this tool to an alias in $PROJECT/deps.edn or $HOME/.clojure/deps.edn:

{
  :aliases {:depstar
              {:extra-deps
                 {seancorfield/depstar {:mvn/version "0.2.3"}}}}
}

Create an uberjar by invoking depstar with the desired jar name:

clojure -A:depstar -m hf.depstar.uberjar MyProject.jar

Create a (library) jar by invoking depstar with the desired jar name:

clojure -A:depstar -m hf.depstar.jar MyLib.jar

If you want to see all of the files that are being copied into the JAR file, add -v or --verbose after the JAR filename.

depstar uses the classpath computed by clojure. For example, add web assets into an uberjar by including an alias in your deps.edn:

{:paths ["src"]
 :aliases {:webassets {:extra-paths ["public-html"]}}}

Then invoke depstar with the chosen aliases:

clojure -A:depstar:webassets -m hf.depstar.uberjar MyProject.jar

Note that depstar does no AOT compilation and does not add a manifest to the jar file. You can run the uberjar as follows (assuming project.core is your main namespace):

java -cp MyProject.jar clojure.main -m project.core

Changes

• 0.2.3 -- Jul 01, 2019 -- Back off Clojure version to 1.7.0 so depstar can be used to build JARs for older projects.
• 0.2.2 -- Jun 29, 2019 -- Fix #11 by adding a -v/--verbose option to display files added to the archive; Fix #9 properly by creating parent directories prior to move of JAR file.
• 0.2.1 -- May 08, 2019 -- Fix #9 by creating parent directories for target JAR file (PR #10 @jarohen).
• 0.2.0 -- May 07, 2019 -- Fix #8 by switching to ZipFileSystem and performing a single copy pass (instead of copying to temporary folder tree and then building a zip file).
• 0.1.7 -- Apr 24, 2019 -- Fix #6 by excluding *.pom files; Fix #7 by excluding module-info.class files; lists excluded files if debugging enabled.
• 0.1.6 -- Mar 10, 2019 -- Fix for JARs containing data_readers.clj (do not close input stream!); supports -Ddepstar.debug=true and DEPSTAR_DEBUG=true to be more verbose.
• 0.1.5 -- Oct 24, 2018 -- Fix for timestamp preservation.
• 0.1.2 -- Oct 23, 2018 -- Initial fork with (incorrect) fix for exception from JARs containing data_readers.clj; hf.depstar.jar namespace added.

License

The use and distribution terms for this software are covered by the Eclipse Public License 2.0