versions:resolve-ranges

Full name:

org.codehaus.mojo:versions-maven-plugin:1.3.1:resolve-ranges

Description:

Attempts to resolve dependency version ranges to the specific version being used in the build. For example a version range of "[1.0, 1.2)" would be resolved to the specific version currently in use "1.1".

Attributes:

  • Requires a Maven project to be executed.
  • Executes by direct invocation only.
  • Since version: 1.0-alpha-3.

Optional Parameters

Name Type Since Description
allowSnapshots Boolean 1.0-alpha-1 Whether to allow snapshots when searching for the latest version of an artifact.
Default value is: false.
excludeProperties String 1.3 A comma separated list of properties to not update even if they contain version-ranges.
excludeReactor Boolean 1.0-alpha-3 Whether to skip processing dependencies that are produced as part of the current reactor.
excludes String[] 1.0-beta-1 A list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if excludesList is defined.
excludesList String 1.0-beta-1 A comma separated list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of excludes from the command line. When specifying excludes from the pom, use the excludes configuration instead. If this property is specified then the exclude configuration is ignored.
generateBackupPoms Boolean 1.0-alpha-3 Controls whether a backup pom should be created (default is true).
includeProperties String 1.3 A comma separated list of properties to update if they contain version-ranges.
includes String[] 1.0-beta-1 A list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if includesList is defined.
includesList String 1.0-beta-1 A comma separated list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of includes from the command line. When specifying includes from the pom, use the includes configuration instead. If this property is specified then the include configuration is ignored.
processDependencies Boolean 1.0-alpha-3 Whether to process the dependencies section of the project. If not set will default to true.
processDependencyManagement Boolean 1.0-alpha-3 Whether to process the dependencyManagement section of the project. If not set will default to true.
processProperties Boolean 1.3 Whether to process the properties section of the project. If not set will default to true.
rulesUri String 1.0-alpha-3 The Wagon URI of a ruleSet file containing the rules that control how to compare version numbers.
serverId String 1.0-alpha-3 settings.xml's server id for the URL. This is used when wagon needs extra authentication information.
Default value is: serverId.

Parameter Details

allowSnapshots:

Whether to allow snapshots when searching for the latest version of an artifact.
  • Type: java.lang.Boolean
  • Since: 1.0-alpha-1
  • Required: No
  • Expression: ${allowSnapshots}
  • Default: false

excludeProperties:

A comma separated list of properties to not update even if they contain version-ranges.
  • Type: java.lang.String
  • Since: 1.3
  • Required: No
  • Expression: ${excludeProperties}

excludeReactor:

Whether to skip processing dependencies that are produced as part of the current reactor.
  • Type: java.lang.Boolean
  • Since: 1.0-alpha-3
  • Required: No
  • Expression: ${excludeReactor}

excludes:

A list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if excludesList is defined.
  • Type: java.lang.String[]
  • Since: 1.0-beta-1
  • Required: No

excludesList:

A comma separated list of artifact patterns to exclude. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of excludes from the command line. When specifying excludes from the pom, use the excludes configuration instead. If this property is specified then the exclude configuration is ignored.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${excludes}

generateBackupPoms:

Controls whether a backup pom should be created (default is true).
  • Type: java.lang.Boolean
  • Since: 1.0-alpha-3
  • Required: No
  • Expression: ${generateBackupPoms}

includeProperties:

A comma separated list of properties to update if they contain version-ranges.
  • Type: java.lang.String
  • Since: 1.3
  • Required: No
  • Expression: ${includeProperties}

includes:

A list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". This configuration setting is ignored if includesList is defined.
  • Type: java.lang.String[]
  • Since: 1.0-beta-1
  • Required: No

includesList:

A comma separated list of artifact patterns to include. Follows the pattern "groupId:artifactId:type:classifier:version". Designed to allow specifing the set of includes from the command line. When specifying includes from the pom, use the includes configuration instead. If this property is specified then the include configuration is ignored.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${includes}

processDependencies:

Whether to process the dependencies section of the project. If not set will default to true.
  • Type: java.lang.Boolean
  • Since: 1.0-alpha-3
  • Required: No
  • Expression: ${processDependencies}

processDependencyManagement:

Whether to process the dependencyManagement section of the project. If not set will default to true.
  • Type: java.lang.Boolean
  • Since: 1.0-alpha-3
  • Required: No
  • Expression: ${processDependencyManagement}

processProperties:

Whether to process the properties section of the project. If not set will default to true.
  • Type: java.lang.Boolean
  • Since: 1.3
  • Required: No
  • Expression: ${processProperties}

rulesUri:

The Wagon URI of a ruleSet file containing the rules that control how to compare version numbers.
  • Type: java.lang.String
  • Since: 1.0-alpha-3
  • Required: No
  • Expression: ${maven.version.rules}

serverId:

settings.xml's server id for the URL. This is used when wagon needs extra authentication information.
  • Type: java.lang.String
  • Since: 1.0-alpha-3
  • Required: No
  • Expression: ${maven.version.rules.serverId}
  • Default: serverId