Clirr Maven Plugin – clirr:check-arbitrary

clirr:check-arbitrary

Full name:

org.codehaus.mojo:clirr-maven-plugin:2.8: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.
Binds by default to the lifecycle phase: verify.
Invokes the execution of the lifecycle phase compile prior to executing itself.

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 value is: `${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 value is: `(,${project.version})`. User property is: `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 value is: `true`. User property is: `failOnError`.
failOnWarning	`boolean`	`-`	Whether to fail on warnings. Default value is: `false`. User property is: `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 is*: `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 value is: `false`. User property is: `logResults`.
minSeverity	`String`	`-`	Show only messages of this severity or higher. Valid values are `info`, `warning` and `error`. Default value is: `warning`. User property is: `minSeverity`.
skip	`boolean`	`-`	Flag to easily skip execution. Default value is: `false`. User property is: `clirr.skip`.
skipArtifactTypeTest	`boolean`	`-`	(no description) Default value is: `false`. User property is: `clirr.skipArtifactTypeTest`.
textOutputFile	`File`	`-`	A text output file to render to. If omitted, no output is rendered to a text file. User property is: `textOutputFile`.
xmlOutputFile	`File`	`-`	An XML file to render to. If omitted, no output is rendered to an XML file. User property is: `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.