Getting started¶
Installation¶
Plugin is available from maven central, bintray jcenter and gradle plugins portal.
buildscript { repositories { jcenter() gradlePluginPortal() } dependencies { classpath 'ru.vyarus:gradle-quality-plugin:3.0.0' } } apply plugin: 'ru.vyarus.quality'
OR
plugins { id 'ru.vyarus.quality' version '3.0.0' }
Warning
Plugin must be applied after java
or groovy
plugins. Otherwise it will do nothing.
Note
Plugin itself is compiled for java 7, but java quality tools require java 8 so, by default, you will need java 8 for java. Groovy project will work on java 7.
If you are using lower java versions use previous plugin releases.
Usage¶
Plugin will auto detect java and groovy sources and activate required quality plugins. All tools will be configured with the default opinionated configs.
$ gradlew check
Will execute all quality plugins. Alternatively, you can use grouping task to run checks without tests.
If any violations were found then build will fail with all violations printed to console. For example like this:
23 PMD rule violations were found in 2 files [Comments | CommentRequired] sample.(Sample.java:3) headerCommentRequirement Required https://pmd.github.io/pmd-5.4.0/pmd-java/rules/java/comments.html#CommentRequired ...
Or you can use build task (which also calls check):
$ gradlew build
Tip
It's better to fix all quality issues before commit.
Non strict mode¶
You can switch off strict mode to avoid build failure when quality violations are found:
quality { strict = false }
You will still see all violations in the output.
Suppress¶
Sometimes (quite rare) tool could be wrong or your situation could require violation break. In this case violation could be suppressed: see exact tool page for suppression hints.