Tested on Java LTS versions from 8 to 21.
Tested on Gradle versions from 7.1 to 8.9.
This plugin executes SonarLint inspections without connecting to a SonarQube server.
The plugin uses these Sonar plugins:
For every SourceSet
a SonarLint task is created by default.
sonarLint {
isGeneratedCodeIgnored = false // `true` by default, set to `false` to validate generated code (code inside `./build/`)
// see detailed documentation about `nodeJs` later in the document
nodeJs {
nodeJsExecutable = project.layout.projectDirectory.file('/usr/bin/node') // set path to Node.js executable
detectNodeJs = true // `false` by default, set to `true` to enable automatic Node.js detection
logNodeJsNotFound = false // Hide warning message about not found Node.js
}
rules {
enable(
'java:S100', // Enable `java:S100` rule (that is disabled by default)
'java:S101', // Enable `java:S101` rule (that is disabled by default)
)
enabled = ['java:S100'] // `enabled` - a mutable collection of enabled rules
disable(
'java:S1000', // Disable `java:S1000` rule
'java:S1001', // Disable `java:S1001` rule
)
disabled = ['java:S1000'] // `disabled` - a mutable collection of disabled rules
rule('java:S100') {
property('format', '^[a-z][a-zA-Z0-9]*$') // Configure `format` property for `java:S100` rule
properties = ['format': '^[a-z][a-zA-Z0-9]*$'] // `properties` - a mutable map of rule properties
}
}
languages {
include('java', 'kotlin') // Enable Java and Kotlin languages only, all other languages become disabled
exclude('java', 'kotlin') // Disable Java and Kotlin languages, all other languages remain enabled
}
sonarProperty('sonar.html.file.suffixes', '.custom-html') // Configure `sonar.html.file.suffixes` Sonar property
sonarProperties = ['sonar.html.file.suffixes': '.custom-html'] // `sonarProperties` - a mutable map of Sonar properties
ignoredPaths.add('**/dto/**') // Ignore all files which relative path matches `**/dto/**` glob for all rules
rules {
rule('java:S100') {
ignoredPaths.add('**/dto/**') // Ignore all files which relative path matches `**/dto/**` glob for rule `java:S100`
}
}
testSourceSets = sourceSets.matching { true } // Which source-sets contain test sources. Source-sets created by plugins like `name.remal.test-source-sets` are automatically integrated. Most probably, you don't have to configure anything yourself.
logging {
withDescription = false // Hide rule descriptions from console output
hideWarnings = true // To hide warnings produced by this plugin
}
// `sonarLint` extension extends `CodeQualityExtension` (see https://docs.gradle.org/current/javadoc/org/gradle/api/plugins/quality/CodeQualityExtension.html).
// You can use all fields of `CodeQualityExtension` the same way as for `checkstyle`, for example.
}
For every property value (for both Sonar properties and rule properties) you can use project.provider { ... }
to set a lazy value that will be calculated when a SonarLint task is executed. For example:
sonarLint {
sonarProperty('sonar.html.file.suffixes', project.provider { '.custom-html' })
}
Two additional help tasks are created:
-
sonarLintProperties
- displays Sonar properties that can be configured viasonarLint.sonarProperties
. -
sonarLintRules
- displays all Sonar rules available, their description and their properties.
SonarLint requires Node.js of the version 18.17.0 or greater to process CSS, HTML, JavaScript, TypeScript, YAML languages.
If Node.js detection is enabled, the plugin tries to find a Node.js executable automatically. The detection algorithm is:
- Try to find a Node.js executable on $PATH
- Then try to download a Node.js executable from the official website
If Node.js is successfully detected, is will be used.
If Node.js cannot be detected, CSS, HTML, JavaScript, TypeScript, YAML languages will be excluded.
If OS or CPU architecture does not support official Node.js, the detection won't detect any executable.
If there are no files requiring Node.js in the sources, Node.js detection will be skipped.
Gradle 6 support was removed.
Package name was changed from name.remal.gradleplugins.sonarlint
to name.remal.gradle_plugins.sonarlint
.