leiningen.release — leiningen 2.9.3

Perform :release-tasks.

*level* clj

bump-version clj

(bump-version version-str & [level])

Given a version string, return the bumped version string - incremented at the indicated level. Add qualifier unless releasing non-snapshot. Level defaults to level.

bump-version-map clj

(bump-version-map {:keys [major minor patch qualifier snapshot]} level)

Given version as a map of the sort returned by parse-semantic-version, return a map of the version incremented in the level argument. Always returns a SNAPSHOT version, unless the level is :release. For :release, removes SNAPSHOT if the input is a SNAPSHOT, removes qualifier if the input is not a SNAPSHOT.

next-qualifier clj

(next-qualifier qualifier)

(next-qualifier sublevel qualifier)

Increments and returns the qualifier. If an explicit sublevel is provided, then, if the original qualifier was using that sublevel, increments it, else returns that sublevel with "1" appended. Supports empty strings for sublevel, in which case the return value is effectively a BuildNumber.

parse-semantic-version clj

(parse-semantic-version version-string)

release clj

(release project)

(release project level)

Perform release tasks.

The default list of release tasks is as follows:

:release-tasks [["vcs" "assert-committed"] ["change" "version" "leiningen.release/bump-version" "release"] ["vcs" "commit"] ["vcs" "tag"] ["deploy"] ["change" "version" "leiningen.release/bump-version"] ["vcs" "commit"] ["vcs" "push"]]

First change the version stored in project.clj, then commit that change, tag this commit to with the release version indicated, deploy to the Maven release repository, then change to the next snapshot version in project.clj, commit that change, and push to the default remote version control repository.

A key point to note is that this default set of :release-tasks requires a clean working directory as far as the current version control system is concerned. This ensures that the vcs commit tasks will only save changes made to project.clj made by the change version tasks.

This behavior can be overridden by setting :release-tasks a vector in which every element is either a task name or a collection in which the first element is a task name and the rest are arguments to that task.

The release task takes a single argument which should be one of :major, :minor, :patch, :alpha, :beta, or :rc to indicate which version level to bump. If none is given, it defaults to :patch.

string->semantic-version clj

(string->semantic-version version-string)

version-map->string clj

(version-map->string version-map)

Given a version-map, return a string representing the version.