apache-rat:rat

Note:This goal should be used as a Maven report.

Full name:

org.apache.rat:apache-rat-plugin:0.11:rat

Description:

Generates a report with Rat's output.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.

Required Parameters

Name Type Since Description
basedir File - The base directory, in which to search for files.
Default value is: ${basedir}.
User property is: rat.basedir.
outputDirectory File - Specifies the directory where the report will be generated
Default value is: ${project.reporting.outputDirectory}.

Optional Parameters

Name Type Since Description
addDefaultLicenseMatchers boolean - Whether to add the default list of license matchers.
Default value is: true.
User property is: rat.addDefaultLicenseMatchers.
excludeSubProjects boolean - Whether to exclude subprojects. This is recommended, if you want a separate apache-rat-plugin report for each subproject.
Default value is: true.
User property is: rat.excludeSubprojects.
excludes String[] - Specifies files, which are excluded in the report. By default, no files are excluded.
includes String[] - Specifies files, which are included in the report. By default, all files are included.
licenseFamilies ILicenseFamily[] 0.8 Specifies the license families to accept.
licenseMatchers HeaderMatcherSpecification[] - Deprecated. Use licenses instead.
licenses IHeaderMatcher[] 0.8 Specifies the licenses to accept. By default, these are added to the default licenses, unless you set addDefaultLicenseMatchers to false.
useDefaultExcludes boolean - Whether to use the default excludes when scanning for files. The default excludes are:
Default value is: true.
User property is: rat.useDefaultExcludes.
useEclipseDefaultExcludes boolean - Whether to use the Eclipse specific default excludes when scanning for files. Eclipse specific default excludes are given by the constant ECLIPSE_DEFAULT_EXCLUDES: The .classpath and .project files, the .settings directory, and so on.
Default value is: true.
User property is: rat.useEclipseDefaultExcludes.
useIdeaDefaultExcludes boolean - Whether to use the IDEA specific default excludes when scanning for files. IDEA specific default excludes are given by the constant IDEA_DEFAULT_EXCLUDES: The *.iml, *.ipr and *.iws files and the .idea directory.
Default value is: true.
User property is: rat.useIdeaDefaultExcludes.
useMavenDefaultExcludes boolean - Whether to use the Maven specific default excludes when scanning for files. Maven specific default excludes are given by the constant MAVEN_DEFAULT_EXCLUDES: The target directory, the cobertura.ser file, and so on.
Default value is: true.
User property is: rat.useMavenDefaultExcludes.

Parameter Details

addDefaultLicenseMatchers:

Whether to add the default list of license matchers.
  • Type: boolean
  • Required: No
  • User Property: rat.addDefaultLicenseMatchers
  • Default: true

basedir:

The base directory, in which to search for files.
  • Type: java.io.File
  • Required: Yes
  • User Property: rat.basedir
  • Default: ${basedir}

excludeSubProjects:

Whether to exclude subprojects. This is recommended, if you want a separate apache-rat-plugin report for each subproject.
  • Type: boolean
  • Required: No
  • User Property: rat.excludeSubprojects
  • Default: true

excludes:

Specifies files, which are excluded in the report. By default, no files are excluded.
  • Type: java.lang.String[]
  • Required: No

includes:

Specifies files, which are included in the report. By default, all files are included.
  • Type: java.lang.String[]
  • Required: No

licenseFamilies:

Specifies the license families to accept.
  • Type: org.apache.rat.license.ILicenseFamily[]
  • Since: 0.8
  • Required: No

licenseMatchers:

Deprecated. Use licenses instead.
Specifies the licenses to accept. Deprecated, use licenses instead.
  • Type: org.apache.rat.mp.HeaderMatcherSpecification[]
  • Required: No

licenses:

Specifies the licenses to accept. By default, these are added to the default licenses, unless you set addDefaultLicenseMatchers to false.
  • Type: org.apache.rat.analysis.IHeaderMatcher[]
  • Since: 0.8
  • Required: No

outputDirectory:

Specifies the directory where the report will be generated
  • Type: java.io.File
  • Required: Yes
  • Default: ${project.reporting.outputDirectory}

useDefaultExcludes:

Whether to use the default excludes when scanning for files. The default excludes are:
  • Type: boolean
  • Required: No
  • User Property: rat.useDefaultExcludes
  • Default: true

useEclipseDefaultExcludes:

Whether to use the Eclipse specific default excludes when scanning for files. Eclipse specific default excludes are given by the constant ECLIPSE_DEFAULT_EXCLUDES: The .classpath and .project files, the .settings directory, and so on.
  • Type: boolean
  • Required: No
  • User Property: rat.useEclipseDefaultExcludes
  • Default: true

useIdeaDefaultExcludes:

Whether to use the IDEA specific default excludes when scanning for files. IDEA specific default excludes are given by the constant IDEA_DEFAULT_EXCLUDES: The *.iml, *.ipr and *.iws files and the .idea directory.
  • Type: boolean
  • Required: No
  • User Property: rat.useIdeaDefaultExcludes
  • Default: true

useMavenDefaultExcludes:

Whether to use the Maven specific default excludes when scanning for files. Maven specific default excludes are given by the constant MAVEN_DEFAULT_EXCLUDES: The target directory, the cobertura.ser file, and so on.
  • Type: boolean
  • Required: No
  • User Property: rat.useMavenDefaultExcludes
  • Default: true