apache-rat:rat

Note:

This goal should be used as a Maven report.

Full name:

org.apache.rat:apache-rat-plugin:0.16.1: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.
  • The goal is thread-safe and supports parallel builds.

Required Parameters

Name Type Since Description
<basedir> File - The base directory, in which to search for files.
Default: ${basedir}
User Property: rat.basedir

Optional Parameters

Name Type Since Description
<addDefaultLicenseMatchers> boolean - Whether to add the default list of license matchers.
Default: true
User Property: rat.addDefaultLicenseMatchers
<addDefaultLicenses> boolean - Whether to add the default list of licenses.
Default: true
User Property: rat.addDefaultLicenses
<additionalLicenseFiles> String[] - No description.
<approvedLicenseFile> String - No description.
User Property: rat.approvedFile
<approvedLicenses> String[] - No description.
<defaultLicenseFiles> String[] 0.8 Specifies the licenses to accept. By default, these are added to the default licenses, unless you set addDefaultLicenseMatchers to false.
<excludes> String[] - Specifies files, which are excluded in the report. By default, no files are excluded.
<excludesFile> String - Specifies a file, from which to read excludes. Basically, an alternative to specifying the excludes as a list. The excludesFile is assumed to be using the UFT8 character set.
User Property: rat.excludesFile
<excludesFileCharset> String - Specifies the include files character set. Defaults to @code{${project.build.sourceEncoding}), or @code{UTF8}.
Default: ${project.build.sourceEncoding}
User Property: rat.excludesFileCharset
<excludeSubProjects> boolean - Whether to exclude subprojects. This is recommended, if you want a separate apache-rat-plugin report for each subproject.
Default: true
User Property: rat.excludeSubprojects
<families> Family[] - No description.
<includes> String[] - Specifies files, which are included in the report. By default, all files are included.
<includesFile> String - Specifies a file, from which to read includes. Basically, an alternative to specifying the includes as a list.
User Property: rat.includesFile
<includesFileCharset> String - Specifies the include files character set. Defaults to @code{${project.build.sourceEncoding}), or @code{UTF8}.
Default: ${project.build.sourceEncoding}
User Property: rat.includesFileCharset
<licenseFamilies> SimpleLicenseFamily[] 0.8
Deprecated.
No reason given

Specifies the license families to accept.
<licenses> Object[] -
Deprecated.
No reason given

This is an object to accept both License of DeprecatedConfig objects.
<parseSCMIgnoresAsExcludes> boolean - Whether to parse source code management system (SCM) ignore files and use their contents as excludes. At the moment this works for the following SCMs:
See also: org.apache.rat.config.SourceCodeManagementSystems
Default: true
User Property: rat.parseSCMIgnoresAsExcludes
<skip> boolean 0.11 Will skip the plugin execution, e.g. for technical builds that do not take license compliance into account.
Default: false
User Property: rat.skip
<useDefaultExcludes> boolean - Whether to use the default excludes when scanning for files. The default excludes are:
Default: true
User Property: 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: true
User Property: 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: true
User Property: 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: true
User Property: rat.useMavenDefaultExcludes

Parameter Details

<addDefaultLicenseMatchers>

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

<addDefaultLicenses>

Whether to add the default list of licenses.
  • Type: boolean
  • Required: No
  • User Property: rat.addDefaultLicenses
  • Default: true

<additionalLicenseFiles>

No description.
  • Type: java.lang.String[]
  • Required: No

<approvedLicenseFile>

No description.
  • Type: java.lang.String
  • Required: No
  • User Property: rat.approvedFile

<approvedLicenses>

No description.
  • Type: java.lang.String[]
  • Required: No

<basedir>

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

<defaultLicenseFiles>

Specifies the licenses to accept. By default, these are added to the default licenses, unless you set addDefaultLicenseMatchers to false.
  • Type: java.lang.String[]
  • Since: 0.8
  • Required: No

<excludes>

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

<excludesFile>

Specifies a file, from which to read excludes. Basically, an alternative to specifying the excludes as a list. The excludesFile is assumed to be using the UFT8 character set.
  • Type: java.lang.String
  • Required: No
  • User Property: rat.excludesFile

<excludesFileCharset>

Specifies the include files character set. Defaults to @code{${project.build.sourceEncoding}), or @code{UTF8}.
  • Type: java.lang.String
  • Required: No
  • User Property: rat.excludesFileCharset
  • Default: ${project.build.sourceEncoding}

<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

<families>

No description.
  • Type: org.apache.rat.mp.Family[]
  • Required: No

<includes>

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

<includesFile>

Specifies a file, from which to read includes. Basically, an alternative to specifying the includes as a list.
  • Type: java.lang.String
  • Required: No
  • User Property: rat.includesFile

<includesFileCharset>

Specifies the include files character set. Defaults to @code{${project.build.sourceEncoding}), or @code{UTF8}.
  • Type: java.lang.String
  • Required: No
  • User Property: rat.includesFileCharset
  • Default: ${project.build.sourceEncoding}

<licenseFamilies>

Deprecated.
No reason given

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

<licenses>

Deprecated.
No reason given

This is an object to accept both License of DeprecatedConfig objects.
  • Type: java.lang.Object[]
  • Required: No

<parseSCMIgnoresAsExcludes>

Whether to parse source code management system (SCM) ignore files and use their contents as excludes. At the moment this works for the following SCMs:
See also: org.apache.rat.config.SourceCodeManagementSystems
  • Type: boolean
  • Required: No
  • User Property: rat.parseSCMIgnoresAsExcludes
  • Default: true

<skip>

Will skip the plugin execution, e.g. for technical builds that do not take license compliance into account.
  • Type: boolean
  • Since: 0.11
  • Required: No
  • User Property: rat.skip
  • Default: false

<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