Skip to content

a Gradle plugin that uses `git describe` to produce a version string.

License

Notifications You must be signed in to change notification settings

gillessed/gradle-git-version

 
 

Repository files navigation

Git-Version Gradle Plugin

Build Status Gradle Plugins Release

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

The first, called gitVersion(), runs the JGit equivalent of git describe to determine a version string. It behaves exactly as the JGit git describe 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, and the commit count since the tag.

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

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.

About

a Gradle plugin that uses `git describe` to produce a version string.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Groovy 100.0%