diff --git a/CHANGELOG.md b/CHANGELOG.md index b46c6d7..fbb7ec5 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,7 +2,7 @@ **For the latest `:git/tag` of `depstar` and its matching `:git/sha`, see the [`depstar` releases page](https://github.com/seancorfield/depstar/releases) on GitHub.** -* v2.1.next in progress +* v2.1.303 -- 2021-09-15 * Fix #102 by converting certain options to strings _after_ alias lookup instead of _before_ (breakage introduced in 2.1.245). * v2.1.297 9626e19 -- 2021-09-04 diff --git a/README.md b/README.md index ca77368..202a103 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Builds JARs, uberjars, does AOT, manifest generation, etc for `deps.edn` project The latest versions on Clojars and on cljdoc: -[![Clojars Project](https://clojars.org/com.github.seancorfield/depstar/latest-version.svg)](https://clojars.org/com.github.seancorfield/depstar) [![cljdoc badge](https://cljdoc.org/badge/com.github.seancorfield/depstar?2.1.297)](https://cljdoc.org/d/com.github.seancorfield/depstar/CURRENT) +[![Clojars Project](https://clojars.org/com.github.seancorfield/depstar/latest-version.svg)](https://clojars.org/com.github.seancorfield/depstar) [![cljdoc badge](https://cljdoc.org/badge/com.github.seancorfield/depstar?2.1.303)](https://cljdoc.org/d/com.github.seancorfield/depstar/CURRENT) The documentation on [cljdoc.org](https://cljdoc.org/d/com.github.seancorfield/depstar/CURRENT) is for the current version of `depstar`: @@ -17,7 +17,7 @@ The documentation on [cljdoc.org](https://cljdoc.org/d/com.github.seancorfield/d * [Building an Application JAR](https://cljdoc.org/d/com.github.seancorfield/depstar/CURRENT/doc/getting-started/building-an-application-jar) * Feedback via [issues](https://github.com/seancorfield/depstar/issues) or in the [`#depstar` channel on the Clojurians Slack](https://clojurians.slack.com/messages/C01AK5V8HPT/). -The documentation on GitHub is for **develop** since the 2.1.297 release -- [see the CHANGELOG](https://github.com/seancorfield/depstar/blob/develop/CHANGELOG.md) and then read the [corresponding updated documentation](https://github.com/seancorfield/depstar/tree/develop/doc) on GitHub if you want. +The documentation on GitHub is for **develop** since the 2.1.303 release -- [see the CHANGELOG](https://github.com/seancorfield/depstar/blob/develop/CHANGELOG.md) and then read the [corresponding updated documentation](https://github.com/seancorfield/depstar/tree/develop/doc) on GitHub if you want. This project follows the version scheme MAJOR.MINOR.COMMITS where MAJOR and MINOR provide some relative indication of the size of the change, but do not follow semantic versioning. In general, all changes endeavor to be non-breaking (by moving to new names rather than by breaking existing names). COMMITS is an ever-increasing counter of commits since the beginning of this repository. @@ -29,11 +29,11 @@ Add `depstar` via one or more aliases in your project `deps.edn` or user-level ` { :aliases { ;; build an uberjar (application) with AOT compilation by default: - :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/uberjar :exec-args {:aot true}} ;; build a jar (library): - :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/jar :exec-args {}} } diff --git a/doc/application-jar.md b/doc/application-jar.md index 91effdf..689f747 100644 --- a/doc/application-jar.md +++ b/doc/application-jar.md @@ -4,7 +4,7 @@ Assuming this alias in your user or project `deps.edn` file: ```clojure ;; build an uberjar (application) with AOT compilation by default: - :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/uberjar :exec-args {:aot true}} ``` diff --git a/doc/cli-tools.md b/doc/cli-tools.md index 240efe2..bae9092 100644 --- a/doc/cli-tools.md +++ b/doc/cli-tools.md @@ -3,7 +3,7 @@ If you are using at least version 1.10.3.933 of the Clojure CLI, you can install `depstar` as a "tool" instead of updating your `deps.edn` file and then invoke it using the following commands: ```bash -clojure -Ttools install com.github.seancorfield/depstar '{:git/tag "v2.1.297"}' :as depstar +clojure -Ttools install com.github.seancorfield/depstar '{:git/tag "v2.1.303"}' :as depstar # make an uberjar: clojure -Tdepstar uberjar :jar MyProject.jar # make a thin JAR: diff --git a/doc/deployment.md b/doc/deployment.md index c05971d..52bc61b 100644 --- a/doc/deployment.md +++ b/doc/deployment.md @@ -76,7 +76,7 @@ pushed, I perform one last commit with the following updates: ```clj ;; override the example :jar alias with a specific one: - :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/jar :exec-args {:jar "clj-new.jar" :sync-pom true}} :deploy {:replace-deps {slipset/deps-deploy {:mvn/version "0.1.5"}} diff --git a/doc/getting-started.md b/doc/getting-started.md index 20d3b27..f76163f 100644 --- a/doc/getting-started.md +++ b/doc/getting-started.md @@ -1,6 +1,6 @@ # Getting Started -> Note: you must have at least version 1.10.1.727 of the Clojure CLI installed! Version 1.10.3.967 is the latest stable version as of `depstar` 2.1.297. See [Clojure Tools Releases](https://clojure.org/releases/tools) for details about the functionality in recent CLI releases. +> Note: you must have at least version 1.10.1.727 of the Clojure CLI installed! Version 1.10.3.967 is the latest stable version as of `depstar` 2.1.303. See [Clojure Tools Releases](https://clojure.org/releases/tools) for details about the functionality in recent CLI releases. Add `depstar` via one or more aliases in your project `deps.edn` or user-level `deps.edn` (in `~/.clojure/` or `~/.config/clojure/`): @@ -8,11 +8,11 @@ Add `depstar` via one or more aliases in your project `deps.edn` or user-level ` { :aliases { ;; build an uberjar (application) with AOT compilation by default: - :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/uberjar :exec-args {:aot true}} ;; build a jar (library): - :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/jar :exec-args {}} } diff --git a/doc/library-jar.md b/doc/library-jar.md index 47625b5..db67e0e 100644 --- a/doc/library-jar.md +++ b/doc/library-jar.md @@ -4,7 +4,7 @@ Assuming this alias in your user or project `deps.edn` file: ```clojure ;; build a jar (library): - :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/jar :exec-args {}} ``` diff --git a/doc/options.md b/doc/options.md index c910f63..57549a0 100644 --- a/doc/options.md +++ b/doc/options.md @@ -35,7 +35,7 @@ You can make this shorter by adding `:exec-fn` to your alias with some of the ar ```clojure ;; a new :uberjar alias to build a project-specific JAR file: - :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/uberjar :exec-args {:jar "MyProject.jar" :aot true @@ -64,7 +64,7 @@ user `deps.edn` file). For example: ;; using an alias as a value for :jvm-opts: :uberjar {:replace-deps - {com.github.seancorfield/depstar {:mvn/version "2.1.297"}} + {com.github.seancorfield/depstar {:mvn/version "2.1.303"}} :exec-fn hf.depstar/uberjar :exec-args {:jar "MyProject.jar" :aot true diff --git a/doc/tools-build.md b/doc/tools-build.md index 33251a9..526aab0 100644 --- a/doc/tools-build.md +++ b/doc/tools-build.md @@ -6,7 +6,7 @@ To use `depstar` as a library, in your `build.clj` script, your `:build` alias s ```clojure :build {:deps {io.github.clojure/tools.build - {:git/tag "v0.3.0" :git/sha "e418fc9"} + {:git/tag "v0.4.0" :git/sha "801a22f"} com.github.seancorfield/depstar ;; this is not the latest version -- see below: {:git/tag "v2.1.297" :git/sha "9626e19"}} @@ -16,7 +16,7 @@ To use `depstar` as a library, in your `build.clj` script, your `:build` alias s **For the latest `:git/tag` of `depstar` and its matching `:git/sha`, see the [`depstar` releases page](https://github.com/seancorfield/depstar/releases) on GitHub.** _[This is because cljdoc always generates documentation from the tag, and the documentation always has to be updated to provide the tag's matching SHA afterwards!]_ -> Note: the above assumes you have at least version 1.10.3.967 of the Clojure CLI installed! That is the latest stable version as of `depstar` 2.1.297. See [Source Libs and Builds](https://clojure.org/news/2021/07/09/source-libs-builds) for details about the new functionality in this recent prerelease, which includes support for `:git/tag`/`:git/sha` source coordinates. You can find the latest tagged version of `depstar` using this command: `clojure -X:deps find-versions :lib com.github.seancorfield/depstar` +> Note: the above assumes you have at least version 1.10.3.967 of the Clojure CLI installed! That is the latest stable version as of `depstar` 2.1.303. See [Source Libs and Builds](https://clojure.org/news/2021/07/09/source-libs-builds) for details about the new functionality in this recent prerelease, which includes support for `:git/tag`/`:git/sha` source coordinates. You can find the latest tagged version of `depstar` using this command: `clojure -X:deps find-versions :lib com.github.seancorfield/depstar` There are two approaches available for using `depstar` for build tasks: * Use all of `tools.build` as usual, except use `depstar` for `jar` and `uber` tasks,