archetype:integration-test

Full name:

org.apache.maven.plugins:maven-archetype-plugin:2.2:integration-test

Description:

Execute the archetype integration tests, consisting in generating projects from the current archetype and optionally comparing generated projects with reference copy.

Each IT consists of a sub-directory in src/test/resources/projects containing:

  • a goal.txt file, containing a list of goals to run against the generated project (can be empty, content ignored before maven-archetype-plugin 2.1),
  • an archetype.properties file, containing properties for project generation,
  • an optional reference/ directory containing a reference copy of the expected project created from the IT.
Notice that it is expected to be run as part as of a build after the package phase and not directly as a goal from CLI.

Attributes:

  • Requires a Maven project to be executed.

Required Parameters

Name Type Since Description
testProjectsDirectory File 2.2 Directory of test projects
Default value is: ${project.build.testOutputDirectory}/projects.

Optional Parameters

Name Type Since Description
debug boolean 2.2 Whether to show debug statements in the build output.
Default value is: false.
encoding String 2.2 The file encoding for the post-build script.
Default value is: ${project.build.sourceEncoding}.
filterProperties Map 2.2 A list of additional properties which will be used to filter tokens in settings.xml
noLog boolean 2.2 Suppress logging to the build.log file.
Default value is: false.
postBuildHookScript String 2.2 Relative path of a cleanup/verification hook script to run after executing the build. This script may be written with either BeanShell or Groovy. If the file extension is omitted (e.g. verify), the plugin searches for the file by trying out the well-known extensions .bsh and .groovy. If this script exists for a particular project but returns any non-null value different from true or throws an exception, the corresponding build is flagged as a failure.
Default value is: verify.
settingsFile File 2.2 Path to an alternate settings.xml to use for Maven invocation with all ITs. Note that the <localRepository> element of this settings file is always ignored, i.e. the path given by the parameter localRepositoryPath is dominant.
showVersion boolean 2.2 flag to enable show mvn version used for running its (cli option : -V,--show-version )
Default value is: false.
streamLogs boolean 2.2 Flag used to determine whether the build logs should be output to the normal mojo log.
Default value is: true.

Parameter Details

debug:

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

encoding:

The file encoding for the post-build script.
  • Type: java.lang.String
  • Since: 2.2
  • Required: No
  • Expression: ${encoding}
  • Default: ${project.build.sourceEncoding}

filterProperties:

A list of additional properties which will be used to filter tokens in settings.xml
  • Type: java.util.Map
  • Since: 2.2
  • Required: No

noLog:

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

postBuildHookScript:

Relative path of a cleanup/verification hook script to run after executing the build. This script may be written with either BeanShell or Groovy. If the file extension is omitted (e.g. verify), the plugin searches for the file by trying out the well-known extensions .bsh and .groovy. If this script exists for a particular project but returns any non-null value different from true or throws an exception, the corresponding build is flagged as a failure.
  • Type: java.lang.String
  • Since: 2.2
  • Required: No
  • Expression: ${archetype.test.verifyScript}
  • Default: verify

settingsFile:

Path to an alternate settings.xml to use for Maven invocation with all ITs. Note that the <localRepository> element of this settings file is always ignored, i.e. the path given by the parameter localRepositoryPath is dominant.
  • Type: java.io.File
  • Since: 2.2
  • Required: No
  • Expression: ${archetype.test.settingsFile}

showVersion:

flag to enable show mvn version used for running its (cli option : -V,--show-version )
  • Type: boolean
  • Since: 2.2
  • Required: No
  • Expression: ${archetype.test.showVersion}
  • Default: false

streamLogs:

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

testProjectsDirectory:

Directory of test projects
  • Type: java.io.File
  • Since: 2.2
  • Required: Yes
  • Expression: ${archetype.test.projectsDirectory}
  • Default: ${project.build.testOutputDirectory}/projects