ru.vyarus.gradle.plugin.animalsniffer.AnimalSnifferExtension.groovy Maven / Gradle / Ivy
package ru.vyarus.gradle.plugin.animalsniffer
import groovy.transform.CompileStatic
import org.gradle.api.Project
import org.gradle.api.file.FileCollection
import org.gradle.api.plugins.quality.CodeQualityExtension
/**
* Animal sniffer plugin extension. Use 'sourceSets' to define target source set (all by default).
* Use 'toolVersion' to override default version. 'ignoreFailures' prevents failures on error.
*
* @author Vyacheslav Rusakov
* @since 13.12.2015
*/
@CompileStatic
class AnimalSnifferExtension extends CodeQualityExtension {
private final Project project
AnimalSnifferExtension(Project project) {
this.project = project
toolVersion = '1.15'
}
/**
* Signatures to use for the check. By default {@code configurations.signature}.
* Assumed to be used for specific cases when signature for check is built inside project
* or come from not standard source.
*/
FileCollection signatures = project.configurations[AnimalSnifferPlugin.SIGNATURE_CONF]
/**
* Annotation class name used to disable check for annotated class/method/field.
*/
String annotation
/**
* Ignore classes, not mentioned in signature. This does not mean "not check class", this mean "allow class usage".
* Useful in situations, when some classes target higher java versions and so may use classes not described in
* signature.
*
* Shortcut method may be used instead of direct collection assignment (shorter for single record).
*
* Note: asterisk may be used to ignore all classes in package: com.pkg.*
*
* See
* docs for more info.
*/
Collection ignore = []
/**
* Jar names to exclude from classpath. Asterisk should be used to mask version part 'slf4j-*'.
* File names in classpath will be named as artifactId-version (note extension is not counted!).
*
* Pattern name is actually a regexp. Asterisk is just a simplification, which is replaced to '.+' in real
* pattern.
*
* This is required for specific cases when you use 3rd party library signatures and
* need to exclude library jars to correctly check with signature.
*/
Collection excludeJars = []
/**
* Check task has to always load and parse entire classpath. This could be time consuming on large classpath.
* When cache is enabled, classpath is loaded just once and converted to a signature file, which is much faster to
* load.
*
* Cache is disabled by default because of problematic cases when both signature and jars contains the same classes
* (animalsniffer limitation). Moreover, plugin exclude some rarely used classes from the signature which
* could lead to confusion (if would be enabled by default).
*/
CheckCacheExtension cache = new CheckCacheExtension()
/**
* @param cache cache configuration closure
*/
void setCache(@DelegatesTo(value = CheckCacheExtension, strategy = Closure.DELEGATE_FIRST) Closure cache) {
project.configure(this.cache, cache)
}
/**
* Shortcut for {@link #ignore}.
*
* @param classes one or more classes, not mentioned in signatures
*/
@SuppressWarnings('ConfusingMethodName')
void ignore(String... classes) {
ignore.addAll(classes)
}
/**
* Shortcut for {@link #excludeJars}.
*
* @param names jar name patterns to exclude
*/
@SuppressWarnings('ConfusingMethodName')
void excludeJars(String... names) {
excludeJars.addAll(names)
}
}