GotVersion

GotVersion is a small tool that examines your Git repositry and tries to come up with the most meaningful and consistent semantic version string. It's inspired by GitVersion. If you are looking for a mature and super configurable solution you should definitely look into it.

Goals

The goal of GotVersion is to be lightweight, fast and friendly to CI pipelines usage. It currently output JSON and VSO renders of the calculated solution. There is currently no configuration which means it's a bit opiniated on your usage of Git tags. If you use GitFlow or GitHubFlow it should fit perfectly.

Building

The easiest way to buld GotVersion is using Docker

$ git clone https://github.com/loafoe/gotversion.git
$ cd gotversion
$ docker build -t gotversion .

Running

The Docker image will examine the Git repo mounted on /repo:

$ docker run --rm -v /path/to/git/repository:/repo gotversion 

By default it outputs VSO lines:

##vso[task.setvariable variable=SemVer;isOutput=true;]0.4.0
##vso[task.setvariable variable=FullSemVer;isOutput=true;]0.4.0
##vso[task.setvariable variable=SHA;isOutput=true;]0de2be93db13828f1d5f43896406f4902ab4159c
##vso[task.setvariable variable=CommitDate;isOutput=true;]2018-10-04
##vso[task.setvariable variable=BranchName;isOutput=true;]master

Azure DevOPS

Setup

Choose Docker task and configure as follows:

Section	Setting	Value
Container Registry	Point to your docker registry
Commands	Command	run
	Volumes	$(System.DefaultWorkingDirectory):/repo
	Image name	Point to your gotversion image
Output Variables	Reference Name	GotVersion

Task Variables

These lines, when executed as a Docker run task in an Azure DevOPS (VSTS) pipeline will inject the following variable for use in downstream tasks:

Variable	ENV name	Description
$(GotVersion.SemVer)	$GOTVERSION_SEMVER	Abbreviated semantic version of the current build
$(GotVersion.FullSemVer)	$GOTVERSION_FULLSEMVER	The full semantic version (recommended)
$(GotVersion.SHA)	$GOTVERSION_SHA	The full SHA1 of the branch head
$(GotVersion.CommitDate)	$GOTVERSION_COMMITDATE	The date of the commit in YYYY-MM-DD format
$(GotVersion.BranchName)	$GOTVERSION_BRANCHNAME	The Git branch name

Command line

You can also have it emit JSON:

$ docker run --rm -v /path/to/git/repository:/repo gotversion -json

Will output something like:

{
  "Major": 0,
  "Minor": 4,
  "Patch": 0,
  "SemVer": "0.4.0",
  "FullSemVer": "0.4.0",
  "MajorMinorPatch": "0.4.0",
  "BranchName": "master",
  "Sha": "0de2be93db13828f1d5f43896406f4902ab4159c",
  "CommitDate": "2018-10-04",
  "FullBuildMetaData": "Branch.master.Sha.0de2be93db13828f1d5f43896406f4902ab4159c"
}

License

License is MIT