Fork me on GitHub

gitflow:feature-finish

Full name:

com.amashchenko.maven.plugin:gitflow-maven-plugin:1.21.0:feature-finish

Description:

The git flow feature finish mojo.

Attributes:

  • Requires a Maven project to be executed.
  • Executes as an aggregator goal.
  • The goal is not marked as thread-safe and thus does not support parallel builds.

Optional Parameters

Name Type Since Description
<argLine> String 1.8.0 Command line arguments to pass to the underlying Maven commands.
User property is: argLine.
<commitMessagePrefix> String 1.14.0 Prefix that is applied to commit messages.
User property is: commitMessagePrefix.
<commitMessages> CommitMessages 1.2.1 Git commit messages.
Default value is: ${commitMessages}.
<featureBranch> String 1.16.0 Feature branch to use in non-interactive mode. Must start with feature branch prefix. The featureBranch parameter will be used instead of featureName if both are set.
User property is: featureBranch.
<featureName> String 1.9.0 Feature name, without feature branch prefix, to use in non-interactive mode.
User property is: featureName.
<featureSquash> boolean 1.2.3 Whether to squash feature branch commits into a single commit upon merging.
Default value is: false.
User property is: featureSquash.
<fetchRemote> boolean 1.3.0 Whether to fetch remote branch and compare it with the local one.
Default value is: true.
User property is: fetchRemote.
<gitExecutable> String - The path to the Git executable. Defaults to "git".
User property is: gitExecutable.
<gitFlowConfig> GitFlowConfig - Git flow configuration.
Default value is: ${gitFlowConfig}.
<gitPushOptions> String 1.18.0 Options to pass to Git push command using --push-option. Multiple options can be added separated with a space e.g. -DgitPushOptions="merge_request.create merge_request.target=develop merge_request.label='Super feature'"
User property is: gitPushOptions.
<gpgSignCommit> boolean 1.9.0 Whether to make a GPG-signed commit.
Default value is: false.
User property is: gpgSignCommit.
<incrementVersionAtFinish> boolean 1.15.0 Whether to increment the version during feature-finish goal.
Default value is: false.
User property is: incrementVersionAtFinish.
<installProject> boolean 1.0.5 Whether to call Maven install goal during the mojo execution.
Default value is: false.
User property is: installProject.
<keepBranch> boolean - Whether to keep feature branch after finish.
Default value is: false.
User property is: keepBranch.
<mvnExecutable> String - The path to the Maven executable. Defaults to "mvn".
User property is: mvnExecutable.
<postFeatureFinishGoals> String 1.13.0 Maven goals to execute in the development branch after merging a feature.
User property is: postFeatureFinishGoals.
<preFeatureFinishGoals> String 1.13.0 Maven goals to execute in the feature branch before merging into the development branch.
User property is: preFeatureFinishGoals.
<projectVersionPolicyId> String 1.18.0 The role-hint for the org.apache.maven.shared.release.policy.version.VersionPolicy implementation used to calculate the project versions. If a policy is set other parameters controlling the generation of version are ignored (digitsOnlyDevVersion, versionDigitToIncrement).
User property is: projectVersionPolicyId.
<pushRemote> boolean 1.3.0 Whether to push to the remote.
Default value is: true.
User property is: pushRemote.
<skipTestProject> boolean 1.0.5 Whether to skip calling Maven test goal before merging the branch.
Default value is: false.
User property is: skipTestProject.
<skipUpdateVersion> boolean 1.13.0 Whether to skip updating version. Useful with versionProperty to be able to update revision property without modifying version tag.
User property is: skipUpdateVersion.
<tychoBuild> boolean 1.1.0 Whether this is Tycho build.
Default value is: false.
<tychoVersionsPluginVersion> String 1.18.0 Version of tycho-versions-plugin to use.
Default value is: 1.7.0.
User property is: tychoVersionsPluginVersion.
<updateGitSubmodules> Boolean 1.19.0 Explicitly enable or disable executing Git submodule update before commit. By default plugin tries to automatically determine if update of the Git submodules is needed.
User property is: updateGitSubmodules.
<updateOutputTimestamp> boolean 1.17.0 Whether to update the project.build.outputTimestamp property automatically or not.
Default value is: true.
User property is: updateOutputTimestamp.
<verbose> boolean 1.0.7 Whether to print commands output into the console.
Default value is: false.
User property is: verbose.
<versionProperty> String 1.13.0 Property to set version to.
User property is: versionProperty.
<versionsForceUpdate> boolean 1.10.0 Whether to set -DgroupId='*' -DartifactId='*' when calling versions-maven-plugin.
Default value is: false.
User property is: versionsForceUpdate.
<versionsMavenPluginVersion> String 1.18.0 Version of versions-maven-plugin to use.
Default value is: 2.16.0.
User property is: versionsMavenPluginVersion.

Parameter Details

<argLine>

Command line arguments to pass to the underlying Maven commands.
  • Type: java.lang.String
  • Since: 1.8.0
  • Required: No
  • User Property: argLine

<commitMessagePrefix>

Prefix that is applied to commit messages.
  • Type: java.lang.String
  • Since: 1.14.0
  • Required: No
  • User Property: commitMessagePrefix

<commitMessages>

Git commit messages.
  • Type: com.amashchenko.maven.plugin.gitflow.CommitMessages
  • Since: 1.2.1
  • Required: No
  • Default: ${commitMessages}

<featureBranch>

Feature branch to use in non-interactive mode. Must start with feature branch prefix. The featureBranch parameter will be used instead of featureName if both are set.
  • Type: java.lang.String
  • Since: 1.16.0
  • Required: No
  • User Property: featureBranch

<featureName>

Feature name, without feature branch prefix, to use in non-interactive mode.
  • Type: java.lang.String
  • Since: 1.9.0
  • Required: No
  • User Property: featureName

<featureSquash>

Whether to squash feature branch commits into a single commit upon merging.
  • Type: boolean
  • Since: 1.2.3
  • Required: No
  • User Property: featureSquash
  • Default: false

<fetchRemote>

Whether to fetch remote branch and compare it with the local one.
  • Type: boolean
  • Since: 1.3.0
  • Required: No
  • User Property: fetchRemote
  • Default: true

<gitExecutable>

The path to the Git executable. Defaults to "git".
  • Type: java.lang.String
  • Required: No
  • User Property: gitExecutable

<gitFlowConfig>

Git flow configuration.
  • Type: com.amashchenko.maven.plugin.gitflow.GitFlowConfig
  • Required: No
  • Default: ${gitFlowConfig}

<gitPushOptions>

Options to pass to Git push command using --push-option. Multiple options can be added separated with a space e.g. -DgitPushOptions="merge_request.create merge_request.target=develop merge_request.label='Super feature'"
  • Type: java.lang.String
  • Since: 1.18.0
  • Required: No
  • User Property: gitPushOptions

<gpgSignCommit>

Whether to make a GPG-signed commit.
  • Type: boolean
  • Since: 1.9.0
  • Required: No
  • User Property: gpgSignCommit
  • Default: false

<incrementVersionAtFinish>

Whether to increment the version during feature-finish goal.
  • Type: boolean
  • Since: 1.15.0
  • Required: No
  • User Property: incrementVersionAtFinish
  • Default: false

<installProject>

Whether to call Maven install goal during the mojo execution.
  • Type: boolean
  • Since: 1.0.5
  • Required: No
  • User Property: installProject
  • Default: false

<keepBranch>

Whether to keep feature branch after finish.
  • Type: boolean
  • Required: No
  • User Property: keepBranch
  • Default: false

<mvnExecutable>

The path to the Maven executable. Defaults to "mvn".
  • Type: java.lang.String
  • Required: No
  • User Property: mvnExecutable

<postFeatureFinishGoals>

Maven goals to execute in the development branch after merging a feature.
  • Type: java.lang.String
  • Since: 1.13.0
  • Required: No
  • User Property: postFeatureFinishGoals

<preFeatureFinishGoals>

Maven goals to execute in the feature branch before merging into the development branch.
  • Type: java.lang.String
  • Since: 1.13.0
  • Required: No
  • User Property: preFeatureFinishGoals

<projectVersionPolicyId>

The role-hint for the org.apache.maven.shared.release.policy.version.VersionPolicy implementation used to calculate the project versions. If a policy is set other parameters controlling the generation of version are ignored (digitsOnlyDevVersion, versionDigitToIncrement).
  • Type: java.lang.String
  • Since: 1.18.0
  • Required: No
  • User Property: projectVersionPolicyId

<pushRemote>

Whether to push to the remote.
  • Type: boolean
  • Since: 1.3.0
  • Required: No
  • User Property: pushRemote
  • Default: true

<skipTestProject>

Whether to skip calling Maven test goal before merging the branch.
  • Type: boolean
  • Since: 1.0.5
  • Required: No
  • User Property: skipTestProject
  • Default: false

<skipUpdateVersion>

Whether to skip updating version. Useful with versionProperty to be able to update revision property without modifying version tag.
  • Type: boolean
  • Since: 1.13.0
  • Required: No
  • User Property: skipUpdateVersion

<tychoBuild>

Whether this is Tycho build.
  • Type: boolean
  • Since: 1.1.0
  • Required: No
  • Default: false

<tychoVersionsPluginVersion>

Version of tycho-versions-plugin to use.
  • Type: java.lang.String
  • Since: 1.18.0
  • Required: No
  • User Property: tychoVersionsPluginVersion
  • Default: 1.7.0

<updateGitSubmodules>

Explicitly enable or disable executing Git submodule update before commit. By default plugin tries to automatically determine if update of the Git submodules is needed.
  • Type: java.lang.Boolean
  • Since: 1.19.0
  • Required: No
  • User Property: updateGitSubmodules

<updateOutputTimestamp>

Whether to update the project.build.outputTimestamp property automatically or not.
  • Type: boolean
  • Since: 1.17.0
  • Required: No
  • User Property: updateOutputTimestamp
  • Default: true

<verbose>

Whether to print commands output into the console.
  • Type: boolean
  • Since: 1.0.7
  • Required: No
  • User Property: verbose
  • Default: false

<versionProperty>

Property to set version to.
  • Type: java.lang.String
  • Since: 1.13.0
  • Required: No
  • User Property: versionProperty

<versionsForceUpdate>

Whether to set -DgroupId='*' -DartifactId='*' when calling versions-maven-plugin.
  • Type: boolean
  • Since: 1.10.0
  • Required: No
  • User Property: versionsForceUpdate
  • Default: false

<versionsMavenPluginVersion>

Version of versions-maven-plugin to use.
  • Type: java.lang.String
  • Since: 1.18.0
  • Required: No
  • User Property: versionsMavenPluginVersion
  • Default: 2.16.0