Gradle Auto Version Plugin

Provides automatic versioning

License	The Apache License, Version 2.0
Categories	Auto Application Layer Libs Code Generators
GroupId	com.github.mixja
ArtifactId	autoversion
Last Version	0.2.0
Release Date	Oct 2, 2017
Type	jar
Description	Gradle Auto Version Plugin Provides automatic versioning
Project URL	https://github.com/mixja/gradle-autoversion-plugin
Source Code Management	https://github.com/mixja/gradle-autoversion-plugin

Download autoversion

Filename	Size
autoversion-0.2.0.pom
autoversion-0.2.0.jar	11 KB
autoversion-0.2.0-sources.jar	2 KB
autoversion-0.2.0-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.mixja/autoversion/ -->
<dependency>
    <groupId>com.github.mixja</groupId>
    <artifactId>autoversion</artifactId>
    <version>0.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.mixja/autoversion/
implementation 'com.github.mixja:autoversion:0.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.mixja/autoversion/
implementation ("com.github.mixja:autoversion:0.2.0")

Apache Buildr

'com.github.mixja:autoversion:jar:0.2.0'

Apache Ivy

<dependency org="com.github.mixja" name="autoversion" rev="0.2.0">
  <artifact name="autoversion" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.mixja', module='autoversion', version='0.2.0')
)

Scala SBT

libraryDependencies += "com.github.mixja" % "autoversion" % "0.2.0"

Leiningen

[com.github.mixja/autoversion "0.2.0"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.eclipse.jgit : org.eclipse.jgit	jar	4.8.0.201706111038-r

Project Modules

There are no modules declared in this project.

Gradle Autoversion Plugin

Introduction

This plugin provides automatic versioning for your Gradle projects and is intended for projects that adopt continuous delivery principles where every commit (at least to master) is a release candidate, and struggle with more traditional versioning systems such as semantic versioning.

Installation

To install this plugin, add the following to the buildscript section at the top of your build.gradle:

buildscript {
    repositories {
        mavenCentral()
    }
    dependencies {
        classpath 'com.github.mixja:autoversion:0.1.0'
    }
}

apply plugin: 'com.github.mixja.autoversion'

Once installed, the plugin will automatically set the version property in your project, and adds a task called version:

$ gradle version -q
17.06.18

# All versioned artefacts will be versioned according to the generated version
$ gradle build
...
...

Versioning Configuration

The current versioning behaviour uses the following values based from the current commit to generate a version:

<year-of-latest-commit>.<month-of-latest-commit>.<number-of-commits-in-commit-month>

All date calculations are based on UTC time

For example, if the latest commit was June 18th, 2017 and there have been 12 commits since June 1st, 2017, the generated version would be:

17.06.12

Build Identifiers

The versioning scheme supports an optional build identifer, which by default is the value of the BUILD_ID environment variable if present:

$ export BUILD_ID=build1356
$ gradle version -q
17.06.12.build1356

You can also configure your own expressions for obtaining the build identifier in your build.gradle file:

autoVersion {
	buildVersion = System.getenv("MY_BUILD_SYSTEM_ID")
}

Branch Versioning

By default, the generated version does not include branch information if the current branch is master.

This behaviour can be changed by configuring the defaultBranch property:

autoVersion {
	buildVersion = System.getenv("MY_BUILD_SYSTEM_ID")
	defaultBranch = develop
}

If a non-default branch is detected, the branch name will be included in the generated version as follows:

$ git checkout my-feature-branch
$ gradle version -q
17.06.12.my-feature-branch
$ export BUILD_ID=build1111
$ gradle version -q
17.06.12.my-feature-branch.build1111

Versions

Version
0.2.0 Oct 2, 2017
0.1.0 Aug 13, 2017