Skip to content
develop
Go to file
Code

Latest commit

Co-authored-by: svc-excavator-bot <svc-excavator-bot@palantir.com>
24795d8

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

readme.md

Autorelease

Git-Version Gradle Plugin

Build Status Gradle Plugins Release

When applied, Git-Version adds two methods to the target project.

The first, called gitVersion(), mimics git describe --tags --always --first-parent to determine a version string. It behaves exactly as git describe --tags --always --first-parent method behaves, except that when the repository is in a dirty state, appends .dirty to the version string.

The second, called versionDetails(), returns an object containing the specific details of the version string: the tag name, the commit count since the tag, the current commit hash of HEAD, and an optional branch name of HEAD.

Usage

Apply the plugin using standard Gradle convention:

plugins {
    id 'com.palantir.git-version' version '<current version>'
}

Set the version of a project by calling:

version gitVersion()

You can get an object containing more detailed information by calling:

def details = versionDetails()
details.lastTag
details.commitDistance
details.gitHash
details.gitHashFull // full 40-character Git commit hash
details.branchName // is null if the repository in detached HEAD mode
details.isCleanTag

You can optionally search a subset of tags with prefix. Example when the tag is my-product@2.15.0:

gitVersion(prefix:'my-product@') // -> 2.15.0

Valid prefixes are defined by the regex [/@]?([A-Za-z]+[/@-])+.

/Abc/
Abc@
foo-bar@
foo/bar@

Tasks

This plugin adds a printVersion task, which will echo the project's configured version to standard-out.

License

This plugin is made available under the Apache 2.0 License.

You can’t perform that action at this time.