jgitflow-gradle-plugin

A JGitflow Gradle Plugin.

License	License Apache-2.0
Categories	Categories Gradle Build Tools Git Development Tools Version Controls JGit General Purpose Libraries Utility
GroupId	GroupId io.github.robwin
ArtifactId	ArtifactId jgitflow-gradle-plugin
Last Version	Last Version 0.6.0
Release Date	Release Date Oct 27, 2017
Type	Type jar
Description	Description jgitflow-gradle-plugin A JGitflow Gradle Plugin.
Project URL	Project URL https://github.com/RobWin/jgitflow-gradle-plugin
Source Code Management	Source Code Management https://github.com/RobWin/jgitflow-gradle-plugin.git

Download jgitflow-gradle-plugin

Filename	Size
jgitflow-gradle-plugin-0.6.0.pom
jgitflow-gradle-plugin-0.6.0.jar	73 KB
jgitflow-gradle-plugin-0.6.0-sources.jar	13 KB
jgitflow-gradle-plugin-0.6.0-javadoc.jar	261 bytes
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.robwin/jgitflow-gradle-plugin/ -->
<dependency>
    <groupId>io.github.robwin</groupId>
    <artifactId>jgitflow-gradle-plugin</artifactId>
    <version>0.6.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.robwin/jgitflow-gradle-plugin/
implementation 'io.github.robwin:jgitflow-gradle-plugin:0.6.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.robwin/jgitflow-gradle-plugin/
implementation ("io.github.robwin:jgitflow-gradle-plugin:0.6.0")

Apache Buildr

'io.github.robwin:jgitflow-gradle-plugin:jar:0.6.0'

Apache Ivy

<dependency org="io.github.robwin" name="jgitflow-gradle-plugin" rev="0.6.0">
  <artifact name="jgitflow-gradle-plugin" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.robwin', module='jgitflow-gradle-plugin', version='0.6.0')
)

Scala SBT

libraryDependencies += "io.github.robwin" % "jgitflow-gradle-plugin" % "0.6.0"

Leiningen

[io.github.robwin/jgitflow-gradle-plugin "0.6.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
io.ultreia.java4all.jgitflow : jgitflow-core	jar	1.0.0-rc-1
com.github.zafarkhaja : java-semver	jar	0.9.0

Project Modules

There are no modules declared in this project.

JGitflow Gradle Plugin

Overview

This is a Gradle Plugin which adds tasks to Gradle to support the Gitflow Workflow. The Gitflow Workflow provides a robust framework for managing larger projects. The Plugin uses org.eclipse.jgit and external.atlassian.jgitflow:jgit-flow-core to implement the Gitflow Workflow. The project is inspired by the JGitFlow Maven Plugin.
The Plugin adds the task group jgitflow which contains the following tasks:

initJGitflow: Initializes the JGitflow context. Creates a develop branch and switches to develop branch.
releaseStart: Creates a release branch release/<releaseVersion> from a develop branch and updates the gradle.properties file with a release version. Switches to release branch.
releaseFinish: Merges a release branch back into the master branch and develop branch. Tags the release. Removes the release branch. Pushes everything to the remote origin. Switches back to develop branch.
releasePublish: Publishes a release branch to the remote origin.
featureStart: Creates a feature branch feature/<featureName> from a develop branch. Switches to feature branch.
featureFinish: Merges a feature branch back into the develop branch. Removes the feature branch. Switches back to develop branch.
featurePublish: Publishes a feature branch to the remote origin.
hotfixStart: Creates a hotfix branch hotfix/<hotfixName> from a master branch. Switches to hotfix branch.
hotfixFinish: Merges a hotfix branch back into the master branch and develop branch. Additionally the master merge is tagged with the hotfix version. Switches back to develop branch.
hotfixPublish: Publishes a hotfix branch to the remote origin.

The project requires at least JDK 7.

Usage Guide

Add the following snippet to your Gradle build file:

buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        classpath 'io.github.robwin:jgitflow-gradle-plugin:0.6.0'
    }
}

apply plugin: 'io.github.robwin.jgitflow'

JGitflow context configuration

The default jgitflow context configuration looks as follows:

Table 1. Branch names

Logical branch name	Real branch name
master	"master"
develop	"develop"
feature	"feature/<featureName>"
release	"release/<releaseVersion>"
hotfix	"hotfix/<hotfixName>";

By default a release tag has no version prefix.

Initializes the JGitflow context

Before you can use the tasks, you must initialize the JGitflow context.

gradlew initJGitflow

If you want to change the JGitflow context configuration, you can do the following.

initJGitflow{
    feature = "features/"
    release = "releases/"
    versiontag = 'v'
}

Git authentication

If you want to push changes to a remote origin, you must specify your username and password in a ~/.gradle/gradle.properties file or as a command line parameter.
SSH is not supported yet.

Example

gitUsername=<username>
gitPassword=<password>

-PgitUsername=<username> -PgitPassword=<password>

Release Start Task

The task exposes a few properties as part of its configuration.

Table 2. Properties of releaseStart

Mandatory	Property	Description	Type	Default
No	releaseVersion	The version of the release. If not set, version will be taken from gradle.properties ('version' property with stripped SNAPSHOT postfix)	String	empty
No	allowSnapshotDependencies	Allow snapshot library dependencies	Boolean	false
No	baseCommit	You can optionally supply a base commit sha-1 hash to start the release from. The commit must be on the develop branch.	String	empty
No	scmMessagePrefix	You can optionally supply a SCM Prefix.	String	empty
No	scmMessageSuffix	You can optionally supply a SCM Suffix.	String	empty

Example

The tasks should be invoked via a command line.

gradlew releaseStart
gradlew releaseStart -PreleaseVersion=1.0.0

Release Finish Task

Table 3. Properties of releaseFinish

Mandatory	Property	Description	Type	Default
No	releaseVersion	The version of the release. If not set, version will be taken from gradle.properties ('version' property with stripped SNAPSHOT postfix)	String	empty
No	newVersion	The new version of the develop branch. If not set then releaseVersion with incremented version and SNAPSHOT postfix (http://semver.org/)	String	empty
No	newVersionIncrement	Controls which part of the version gets incremented when newVersion is set. Can be one of PATCH, MINOR or MAJOR.	String	PATCH
Yes	pushRelease	A flag indicating whether or not the finished release should be pushed to remote	boolean	true
No	scmMessagePrefix	You can optionally supply a SCM Prefix.	String	empty
No	scmMessageSuffix	You can optionally supply a SCM Suffix.	String	empty

Example

The tasks should be invoked via a command line.

gradlew releaseFinish
gradlew releaseFinish -PnewVersionIncrement=PATCH
gradlew releaseFinish -PreleaseVersion=1.0.0
gradlew releaseFinish -PreleaseVersion=1.0.0 -PnewVersion=1.0.1-SNAPSHOT
gradlew releaseFinish -PreleaseVersion=1.0.0 -PnewVersion=1.0.1-SNAPSHOT -PpushRelease=true
gradlew releaseFinish -PreleaseVersion=1.0.0 -PnewVersion=1.0.1-SNAPSHOT -PpushRelease=false

Feature Start Task

The task exposes a few properties as part of its configuration.

Table 4. Properties of featureStart

Mandatory	Property	Description	Type	Default
Yes	featureName	The name of the feature	String	empty
No	scmMessagePrefix	You can optionally supply a SCM Prefix.	String	empty
No	scmMessageSuffix	You can optionally supply a SCM Suffix.	String	empty

Example

The tasks should be invoked via a command line.

gradlew featureStart -PfeatureName="NewFeature"

Feature Finish Task

Table 5. Properties of featureFinish

Mandatory	Property	Description	Type	Default
Yes	featureName	The name of the feature	String	empty
No	scmMessagePrefix	You can optionally supply a SCM Prefix.	String	empty
No	scmMessageSuffix	You can optionally supply a SCM Suffix.	String	empty

Example

The tasks should be invoked via a command line.

gradlew featureFinish -PfeatureName="NewFeature"

Hotfix Start Task

The task exposes a few properties as part of its configuration.

Table 6. Properties of hotfixStart

Mandatory	Property	Description	Type	Default
Yes	hotfixName	The name of the hotfix	String	empty
No	baseCommit	You can optionally supply a base commit sha-1 hash to start the hotfix from. The commit must be on the master branch.	String	empty
No	scmMessagePrefix	You can optionally supply a SCM Prefix.	String	empty
No	scmMessageSuffix	You can optionally supply a SCM Suffix.	String	empty

Example

The tasks should be invoked via a command line.

gradlew hotfixStart -PhotfixName="HotfixXYZ"

Hotfix Finish Task

Table 7. Properties of hotfixFinish

Mandatory	Property	Description	Type	Default
Yes	hotfixName	The name of the hotfix	String	empty
No	scmMessagePrefix	You can optionally supply a SCM Prefix.	String	empty
No	scmMessageSuffix	You can optionally supply a SCM Suffix.	String	empty

Example

The tasks should be invoked via a command line.

gradlew hotfixFinish -PhotfixName="HotfixXYZ"

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Versions

Version
0.6.0 Oct 27, 2017
0.5.0 Mar 14, 2017
0.4.0 Dec 6, 2016
0.3.2 Mar 18, 2016
0.3.1 Oct 19, 2015
0.3.0 Oct 7, 2015
0.2.6 Jul 17, 2015
0.2.5 Jul 15, 2015
0.2.4 Jul 15, 2015
0.2.2 Jul 14, 2015
0.2.1 Jul 10, 2015
0.2.0 Jul 10, 2015

jgitflow-gradle-plugin

License

Categories

GroupId

ArtifactId

Last Version

Release Date

Type

Description

Project URL

Source Code Management

Download jgitflow-gradle-plugin

How to add to project

Dependencies

compile (2)

Project Modules

JGitflow Gradle Plugin

Overview

Usage Guide

JGitflow context configuration

Initializes the JGitflow context

Git authentication

Example

Release Start Task

Example

Release Finish Task

Example

Feature Start Task

Example

Feature Finish Task

Example

Hotfix Start Task

Example

Hotfix Finish Task

Example

License

Versions