Package org.gradle.api.plugins.quality
Class CheckstyleExtension
- java.lang.Object
-
- org.gradle.api.plugins.quality.CodeQualityExtension
-
- org.gradle.api.plugins.quality.CheckstyleExtension
-
public abstract class CheckstyleExtension extends CodeQualityExtension
Configuration options for the Checkstyle plugin.- See Also:
CheckstylePlugin
-
-
Constructor Summary
Constructors Constructor Description CheckstyleExtension(Project project)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description TextResource
getConfig()
The Checkstyle configuration to use.DirectoryProperty
getConfigDirectory()
Path to other Checkstyle configuration files.java.io.File
getConfigFile()
The Checkstyle configuration file to use.java.util.Map<java.lang.String,java.lang.Object>
getConfigProperties()
The properties available for use in the configuration file.Property<java.lang.Boolean>
getEnableExternalDtdLoad()
Enable the ability to use custom DTD files in config and load them from some location on all checkstyle tasks in this project.int
getMaxErrors()
The maximum number of errors that are tolerated before breaking the build or setting the failure property.int
getMaxWarnings()
The maximum number of warnings that are tolerated before breaking the build or setting the failure property.boolean
isShowViolations()
Whether rule violations are to be displayed on the console.void
setConfig(TextResource config)
The Checkstyle configuration to use.void
setConfigFile(java.io.File configFile)
The Checkstyle configuration file to use.void
setConfigProperties(java.util.Map<java.lang.String,java.lang.Object> configProperties)
The properties available for use in the configuration file.void
setMaxErrors(int maxErrors)
Set the maximum number of errors that are tolerated before breaking the build.void
setMaxWarnings(int maxWarnings)
Set the maximum number of warnings that are tolerated before breaking the build.void
setShowViolations(boolean showViolations)
Whether rule violations are to be displayed on the console.-
Methods inherited from class org.gradle.api.plugins.quality.CodeQualityExtension
getReportsDir, getSourceSets, getToolVersion, isIgnoreFailures, setIgnoreFailures, setReportsDir, setSourceSets, setToolVersion
-
-
-
-
Constructor Detail
-
CheckstyleExtension
public CheckstyleExtension(Project project)
-
-
Method Detail
-
getConfigFile
public java.io.File getConfigFile()
The Checkstyle configuration file to use.
-
setConfigFile
public void setConfigFile(java.io.File configFile)
The Checkstyle configuration file to use.
-
getConfig
public TextResource getConfig()
The Checkstyle configuration to use. Replaces theconfigFile
property.- Since:
- 2.2
-
setConfig
public void setConfig(TextResource config)
The Checkstyle configuration to use. Replaces theconfigFile
property.- Since:
- 2.2
-
getConfigProperties
public java.util.Map<java.lang.String,java.lang.Object> getConfigProperties()
The properties available for use in the configuration file. These are substituted into the configuration file.
-
setConfigProperties
public void setConfigProperties(java.util.Map<java.lang.String,java.lang.Object> configProperties)
The properties available for use in the configuration file. These are substituted into the configuration file.
-
getConfigDirectory
public DirectoryProperty getConfigDirectory()
Path to other Checkstyle configuration files. By default, this path is$rootProject.projectDir/config/checkstyle
This path will be exposed as the variable
config_loc
in Checkstyle's configuration files.- Returns:
- path to other Checkstyle configuration files
- Since:
- 4.7
-
getMaxErrors
public int getMaxErrors()
The maximum number of errors that are tolerated before breaking the build or setting the failure property. Defaults to0
.Example: maxErrors = 42
- Returns:
- the maximum number of errors allowed
- Since:
- 3.4
-
setMaxErrors
public void setMaxErrors(int maxErrors)
Set the maximum number of errors that are tolerated before breaking the build.- Parameters:
maxErrors
- number of errors allowed- Since:
- 3.4
-
getMaxWarnings
public int getMaxWarnings()
The maximum number of warnings that are tolerated before breaking the build or setting the failure property. Defaults toInteger.MAX_VALUE
.Example: maxWarnings = 1000
- Returns:
- the maximum number of warnings allowed
- Since:
- 3.4
-
setMaxWarnings
public void setMaxWarnings(int maxWarnings)
Set the maximum number of warnings that are tolerated before breaking the build.- Parameters:
maxWarnings
- number of warnings allowed- Since:
- 3.4
-
isShowViolations
public boolean isShowViolations()
Whether rule violations are to be displayed on the console. Defaults totrue
. Example: showViolations = false
-
setShowViolations
public void setShowViolations(boolean showViolations)
Whether rule violations are to be displayed on the console. Defaults totrue
. Example: showViolations = false
-
getEnableExternalDtdLoad
@Incubating @Optional @Input public Property<java.lang.Boolean> getEnableExternalDtdLoad()
Enable the ability to use custom DTD files in config and load them from some location on all checkstyle tasks in this project. Disabled by default due to security concerns. See Checkstyle documentation for more details.- Returns:
- The property controlling whether to enable the ability to use custom DTD files
- Since:
- 7.6
-
-