Fork me on GitHub
$i18n.getString(

clirr:check-arbitrary

Full name:

org.codehaus.mojo:clirr-maven-plugin:2.9:check-arbitrary

Description:

Check for compatibility between two arbitrary artifact sets.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • The goal is not marked as thread-safe and thus does not support parallel builds.
  • Binds by default to the lifecycle phase: verify.
  • Invokes the execution of the following lifecycle phase prior to executing itself: compile.

Required Parameters

Name Type Since Description
<newComparisonArtifacts> ArtifactSpecification[] - List of artifacts to compare to baseline.
<oldComparisonArtifacts> ArtifactSpecification[] - List of artifacts to serve as a baseline to compare against.

Optional Parameters

Name Type Since Description
<classesDirectory> File - The classes of this project to compare the last release against.
Default: ${project.build.outputDirectory}
<comparisonArtifacts> ArtifactSpecification[] - List of artifacts to compare the current code against. This overrides comparisonVersion, if present. Each comparisonArtifact is made of a groupId, an artifactId and a version number. Optionally it may have a classifier (default null) and a type (default "jar").
<comparisonVersion> String - Version to compare the current code against.
Default: (,${project.version})
User Property: comparisonVersion
<excludes> String[] - A list of classes to exclude. These classes are excluded from the list of classes that are included. Values are specified in path pattern notation, e.g. org/codehaus/mojo/**.
<failOnError> boolean - Whether to fail on errors.
Default: true
User Property: failOnError
<failOnWarning> boolean - Whether to fail on warnings.
Default: false
User Property: failOnWarning
<ignored> Difference[] 2.5 A list of differences reported by Clirr that should be ignored when producing the final report. Values specified here will be joined with the ones specified using the "ignoredDifferencesFile" parameter.
<ignoredDifferencesFile> File 2.5 A path to the XML file containing the ignored differences definitions. Values specified int the file will be joined with the ones specified using the "ignored" parameter.

File Format 
<differences>
  ...
  <difference>
    <className>com.thoughtworks.qdox.parser.impl.Parser</className>
    <field>*</field>
  </difference>
  ...
</differences>

User Property: clirr.ignoredDifferencesFile
<includes> String[] - A list of classes to include. Anything not included is excluded. If omitted, all are assumed to be included. Values are specified in path pattern notation, e.g. org/codehaus/mojo/**.
<logResults> boolean - Whether to log the results to the console or not.
Default: false
User Property: logResults
<minSeverity> String - Show only messages of this severity or higher. Valid values are info, warning and error.
Default: warning
User Property: minSeverity
<skip> boolean - Flag to easily skip execution.
Default: false
User Property: clirr.skip
<skipArtifactTypeTest> boolean - No description.
Default: false
User Property: clirr.skipArtifactTypeTest
<textOutputFile> File - A text output file to render to. If omitted, no output is rendered to a text file.
User Property: textOutputFile
<xmlOutputFile> File - An XML file to render to. If omitted, no output is rendered to an XML file.
User Property: xmlOutputFile

Parameter Details

<classesDirectory>

The classes of this project to compare the last release against.
  • Type: java.io.File
  • Required: No
  • Default: ${project.build.outputDirectory}

<comparisonArtifacts>

List of artifacts to compare the current code against. This overrides comparisonVersion, if present. Each comparisonArtifact is made of a groupId, an artifactId and a version number. Optionally it may have a classifier (default null) and a type (default "jar").
  • Type: org.codehaus.mojo.clirr.ArtifactSpecification[]
  • Required: No

<comparisonVersion>

Version to compare the current code against.
  • Type: java.lang.String
  • Required: No
  • User Property: comparisonVersion
  • Default: (,${project.version})

<excludes>

A list of classes to exclude. These classes are excluded from the list of classes that are included. Values are specified in path pattern notation, e.g. org/codehaus/mojo/**.
  • Type: java.lang.String[]
  • Required: No

<failOnError>

Whether to fail on errors.
  • Type: boolean
  • Required: No
  • User Property: failOnError
  • Default: true

<failOnWarning>

Whether to fail on warnings.
  • Type: boolean
  • Required: No
  • User Property: failOnWarning
  • Default: false

<ignored>

A list of differences reported by Clirr that should be ignored when producing the final report. Values specified here will be joined with the ones specified using the "ignoredDifferencesFile" parameter.
  • Type: org.codehaus.mojo.clirr.Difference[]
  • Since: 2.5
  • Required: No

<ignoredDifferencesFile>

A path to the XML file containing the ignored differences definitions. Values specified int the file will be joined with the ones specified using the "ignored" parameter.

File Format 
<differences>
  ...
  <difference>
    <className>com.thoughtworks.qdox.parser.impl.Parser</className>
    <field>*</field>
  </difference>
  ...
</differences>
  • Type: java.io.File
  • Since: 2.5
  • Required: No
  • User Property: clirr.ignoredDifferencesFile

<includes>

A list of classes to include. Anything not included is excluded. If omitted, all are assumed to be included. Values are specified in path pattern notation, e.g. org/codehaus/mojo/**.
  • Type: java.lang.String[]
  • Required: No

<logResults>

Whether to log the results to the console or not.
  • Type: boolean
  • Required: No
  • User Property: logResults
  • Default: false

<minSeverity>

Show only messages of this severity or higher. Valid values are info, warning and error.
  • Type: java.lang.String
  • Required: No
  • User Property: minSeverity
  • Default: warning

<newComparisonArtifacts>

List of artifacts to compare to baseline.
  • Type: org.codehaus.mojo.clirr.ArtifactSpecification[]
  • Required: Yes

<oldComparisonArtifacts>

List of artifacts to serve as a baseline to compare against.
  • Type: org.codehaus.mojo.clirr.ArtifactSpecification[]
  • Required: Yes

<skip>

Flag to easily skip execution.
  • Type: boolean
  • Required: No
  • User Property: clirr.skip
  • Default: false

<skipArtifactTypeTest>

No description.
  • Type: boolean
  • Required: No
  • User Property: clirr.skipArtifactTypeTest
  • Default: false

<textOutputFile>

A text output file to render to. If omitted, no output is rendered to a text file.
  • Type: java.io.File
  • Required: No
  • User Property: textOutputFile

<xmlOutputFile>

An XML file to render to. If omitted, no output is rendered to an XML file.
  • Type: java.io.File
  • Required: No
  • User Property: xmlOutputFile