invoker:run

Full name:

org.apache.maven.plugins:maven-invoker-plugin:1.2.1:run

Description:

Searches for integration test Maven projects, and executes each, collecting a log in the project directory, and outputting the results to the command line.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Requires dependency resolution of artifacts in scope: test.
  • Since version: 1.0.
  • Binds by default to the lifecycle phase: integration-test.

Optional Parameters

Name Type Since Description
addTestClassPath boolean 1.2 A flag whether the test class path of the project under test should be included in the class path of the pre-/post-build scripts. If set to false, the class path of script interpreter consists only of the runtime dependencies of the Maven Invoker Plugin. If set the true, the project's test class path will be prepended to the interpreter class path. Among others, this feature allows the scripts to access utility classes from the test sources of your project. Default value is: false.
cloneAllFiles boolean 1.2 Some files are normally excluded when copying the IT projects from the directory specified by the parameter projectsDirectory to the directory given by cloneProjectsTo (e.g. .svn, CVS, *~, etc). Setting this parameter to true will cause all files to be copied to the cloneProjectsTo directory. Default value is: false.
cloneProjectsTo File 1.1 Directory to which projects should be cloned prior to execution. If not specified, each integration test will be run in the directory in which the corresponding IT POM was found. In this case, you most likely want to configure your SCM to ignore target and build.log in the test's base directory.
debug boolean 1.0 Whether to show debug statements in the build output. Default value is: false.
encoding String 1.2 The file encoding for the pre-/post-build scripts and the list files for goals and profiles. Default value is: ${project.build.sourceEncoding}.
goals List 1.0 The list of goals to execute on each project. Default value is: package.
goalsFile String 1.0 Deprecated. As of version 1.2 the properties file specified by the parameter invokerPropertiesFile should be used instead. Default value is: goals.txt.
interpolationsProperties Properties 1.1 List of properties which will be used to interpolate goal files.
invokerPropertiesFile String 1.2 The name of an optional test-specific file that contains properties used to configure the invocation of an integration test. This properties file may be used to specify settings for an individual test invocation. Any property present in the file will override the corresponding setting from the plugin configuration. The values of the properties are filtered and may use expressions like ${project.version} to reference project properties or values from the parameter interpolationsProperties. The snippet below describes the supported properties: 
# A comma or space separated list of goals/phases to execute, may
# specify an empty list to execute the default goal of the IT project
invoker.goals=clean package site

# A comma or space separated list of profiles to activate
invoker.profiles=its,jdk15

# The value for the environment variable MAVEN_OPTS
invoker.mavenOpts=-Dfile.encoding=UTF-16 -Xms32m -Xmx256m

# Possible values are "fail-fast" (default), "fail-at-end" and "fail-never"
invoker.failureBehavior=fail-never

# The expected result of the build, possible values are "success" (default) and "failure"
invoker.buildResult=failure

# A boolean value controlling the -N flag, defaults to "false"
invoker.nonRecursive=false
Default value is: invoker.properties.
invokerTest String 1.1 Specify this parameter to run individual tests by file name, overriding the pomIncludes and pomExcludes parameters. Each pattern you specify here will be used to create an include pattern formatted like ${projectsDirectory}/${invoker.test}, so you can just type "-Dinvoker.test=MyTest" to run a single it in ${projectsDirectory}/${invoker.test}".
localRepositoryPath File 1.0 The local repository for caching artifacts.
mavenOpts String 1.2 The MAVEN_OPTS environment variable to use when invoking Maven. This value can be overridden for individual integration tests by using invokerPropertiesFile.
noLog boolean 1.0 Suppress logging to the build.log file. Default value is: false.
pom File 1.0 A single POM to build, skipping any scanning parameters and behavior.
pomExcludes List 1.0 Excludes for searching the integration test directory. This parameter is meant to be set from the POM. By default, no POM files are excluded.
pomIncludes List 1.0 Includes for searching the integration test directory. This parameter is meant to be set from the POM. If this parameter is not set, the plugin will search for all pom.xml files one directory below projectsDirectory (*/pom.xml).
postBuildHookScript String 1.0 Relative path of a cleanup/verification BeanShell script to run after executing the build. Default value is: postbuild.bsh.
preBuildHookScript String 1.0 Relative path of a pre-build hook BeanShell script to run prior to executing the build. Default value is: prebuild.bsh.
profiles List 1.1 List of profile identifiers to explicitly trigger in the build.
profilesFile String 1.1 Deprecated. As of version 1.2 the properties file specified by the parameter invokerPropertiesFile should be used instead. Default value is: profiles.txt.
projectsDirectory File 1.0 Directory to search for integration tests. Default value is: ${basedir}/src/projects/.
properties Map 1.1 Common set of properties to pass in on each project's command line, via -D parameters.
settingsFile File 1.2 Path to an alternate settings.xml to use for Maven invocation with all ITs.
showErrors boolean 1.0 Whether to show errors in the build output. Default value is: false.
skipInvocation boolean 1.1 Flag used to suppress certain invocations. This is useful in tailoring the build using profiles. Default value is: false.
streamLogs boolean 1.0 Flag used to determine whether the build logs should be output to the normal mojo log. Default value is: false.
suppressSummaries boolean 1.0 Flag used to suppress the summary output notifying of successes and failures. If set to true, the only indication of the build's success or failure will be the effect it has on the main build (if it fails, the main build should fail as well). If streamLogs is enabled, the sub-build summary will also provide an indication. Default value is: false.
testProperties Properties 1.0 Deprecated. Use properties parameter instead.
testPropertiesFile String 1.0 Location of a properties file that defines CLI properties for the test. Default value is: test.properties.

Parameter Details

addTestClassPath:

A flag whether the test class path of the project under test should be included in the class path of the pre-/post-build scripts. If set to false, the class path of script interpreter consists only of the runtime dependencies of the Maven Invoker Plugin. If set the true, the project's test class path will be prepended to the interpreter class path. Among others, this feature allows the scripts to access utility classes from the test sources of your project.
  • Type: boolean
  • Since: 1.2
  • Required: No
  • Expression: ${invoker.addTestClassPath}
  • Default: false

cloneAllFiles:

Some files are normally excluded when copying the IT projects from the directory specified by the parameter projectsDirectory to the directory given by cloneProjectsTo (e.g. .svn, CVS, *~, etc). Setting this parameter to true will cause all files to be copied to the cloneProjectsTo directory.
  • Type: boolean
  • Since: 1.2
  • Required: No
  • Default: false

cloneProjectsTo:

Directory to which projects should be cloned prior to execution. If not specified, each integration test will be run in the directory in which the corresponding IT POM was found. In this case, you most likely want to configure your SCM to ignore target and build.log in the test's base directory.
  • Type: java.io.File
  • Since: 1.1
  • Required: No

debug:

Whether to show debug statements in the build output.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.debug}
  • Default: false

encoding:

The file encoding for the pre-/post-build scripts and the list files for goals and profiles.
  • Type: java.lang.String
  • Since: 1.2
  • Required: No
  • Expression: ${encoding}
  • Default: ${project.build.sourceEncoding}

goals:

The list of goals to execute on each project. Default value is: package.
  • Type: java.util.List
  • Since: 1.0
  • Required: No

goalsFile:

Deprecated. As of version 1.2 the properties file specified by the parameter invokerPropertiesFile should be used instead.
The name of the project-specific file that contains the enumeration of goals to execute for that test.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.goalsFile}
  • Default: goals.txt

interpolationsProperties:

List of properties which will be used to interpolate goal files.
  • Type: java.util.Properties
  • Since: 1.1
  • Required: No

invokerPropertiesFile:

The name of an optional test-specific file that contains properties used to configure the invocation of an integration test. This properties file may be used to specify settings for an individual test invocation. Any property present in the file will override the corresponding setting from the plugin configuration. The values of the properties are filtered and may use expressions like ${project.version} to reference project properties or values from the parameter interpolationsProperties. The snippet below describes the supported properties: 
# A comma or space separated list of goals/phases to execute, may
# specify an empty list to execute the default goal of the IT project
invoker.goals=clean package site

# A comma or space separated list of profiles to activate
invoker.profiles=its,jdk15

# The value for the environment variable MAVEN_OPTS
invoker.mavenOpts=-Dfile.encoding=UTF-16 -Xms32m -Xmx256m

# Possible values are "fail-fast" (default), "fail-at-end" and "fail-never"
invoker.failureBehavior=fail-never

# The expected result of the build, possible values are "success" (default) and "failure"
invoker.buildResult=failure

# A boolean value controlling the -N flag, defaults to "false"
invoker.nonRecursive=false
  • Type: java.lang.String
  • Since: 1.2
  • Required: No
  • Expression: ${invoker.invokerPropertiesFile}
  • Default: invoker.properties

invokerTest:

Specify this parameter to run individual tests by file name, overriding the pomIncludes and pomExcludes parameters. Each pattern you specify here will be used to create an include pattern formatted like ${projectsDirectory}/${invoker.test}, so you can just type "-Dinvoker.test=MyTest" to run a single it in ${projectsDirectory}/${invoker.test}".
  • Type: java.lang.String
  • Since: 1.1
  • Required: No
  • Expression: ${invoker.test}

localRepositoryPath:

The local repository for caching artifacts.
  • Type: java.io.File
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.localRepositoryPath}

mavenOpts:

The MAVEN_OPTS environment variable to use when invoking Maven. This value can be overridden for individual integration tests by using invokerPropertiesFile.
  • Type: java.lang.String
  • Since: 1.2
  • Required: No
  • Expression: ${invoker.mavenOpts}

noLog:

Suppress logging to the build.log file.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.noLog}
  • Default: false

pom:

A single POM to build, skipping any scanning parameters and behavior.
  • Type: java.io.File
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.pom}

pomExcludes:

Excludes for searching the integration test directory. This parameter is meant to be set from the POM. By default, no POM files are excluded.
  • Type: java.util.List
  • Since: 1.0
  • Required: No

pomIncludes:

Includes for searching the integration test directory. This parameter is meant to be set from the POM. If this parameter is not set, the plugin will search for all pom.xml files one directory below projectsDirectory (*/pom.xml).
  • Type: java.util.List
  • Since: 1.0
  • Required: No

postBuildHookScript:

Relative path of a cleanup/verification BeanShell script to run after executing the build.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.postBuildHookScript}
  • Default: postbuild.bsh

preBuildHookScript:

Relative path of a pre-build hook BeanShell script to run prior to executing the build.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.preBuildHookScript}
  • Default: prebuild.bsh

profiles:

List of profile identifiers to explicitly trigger in the build.
  • Type: java.util.List
  • Since: 1.1
  • Required: No

profilesFile:

Deprecated. As of version 1.2 the properties file specified by the parameter invokerPropertiesFile should be used instead.
The name of the project-specific file that contains the enumeration of profiles to use for that test. If the file exists and empty no profiles will be used even if the profiles is set
  • Type: java.lang.String
  • Since: 1.1
  • Required: No
  • Expression: ${invoker.profilesFile}
  • Default: profiles.txt

projectsDirectory:

Directory to search for integration tests.
  • Type: java.io.File
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.projectsDirectory}
  • Default: ${basedir}/src/projects/

properties:

Common set of properties to pass in on each project's command line, via -D parameters.
  • Type: java.util.Map
  • Since: 1.1
  • Required: No

settingsFile:

Path to an alternate settings.xml to use for Maven invocation with all ITs.
  • Type: java.io.File
  • Since: 1.2
  • Required: No
  • Expression: ${invoker.settingsFile}

showErrors:

Whether to show errors in the build output.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.showErrors}
  • Default: false

skipInvocation:

Flag used to suppress certain invocations. This is useful in tailoring the build using profiles.
  • Type: boolean
  • Since: 1.1
  • Required: No
  • Default: false

streamLogs:

Flag used to determine whether the build logs should be output to the normal mojo log.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.streamLogs}
  • Default: false

suppressSummaries:

Flag used to suppress the summary output notifying of successes and failures. If set to true, the only indication of the build's success or failure will be the effect it has on the main build (if it fails, the main build should fail as well). If streamLogs is enabled, the sub-build summary will also provide an indication.
  • Type: boolean
  • Since: 1.0
  • Required: No
  • Default: false

testProperties:

Deprecated. Use properties parameter instead.
Common set of test properties to pass in on each IT's command line, via -D parameters.
  • Type: java.util.Properties
  • Since: 1.0
  • Required: No

testPropertiesFile:

Location of a properties file that defines CLI properties for the test.
  • Type: java.lang.String
  • Since: 1.0
  • Required: No
  • Expression: ${invoker.testPropertiesFile}
  • Default: test.properties