open class CorrectableCodeSmell(val entity: Entity, val message: String, val references: List<Entity> = emptyList(), val autoCorrectEnabled: Boolean) : CodeSmell

Represents a code smell that can be auto-corrected.

Detektion

interface Detektion : UserDataHolder

Storage for all kinds of findings and additional information which needs to be transferred from the detekt engine to the user.

DetektVisitor

open class DetektVisitor : KtTreeVisitorVoid

Basic visitor which is used inside detekt. Guarantees a better looking name as the extended base class :).

Entity

class Entity(val name: String, val signature: String, val location: Location, val ktElement: KtElement? = null) : Compactable

Stores information about a specific code fragment.

Extension

interface Extension

Defines extension points in detekt. Currently supported extensions are:

FileProcessListener

interface FileProcessListener : Extension

Gather additional metrics about the analyzed kotlin file. Pay attention to the thread policy of each function!

Finding

interface Finding

Represents a detected problem in the source code.

Issue

interface Issue

Represents a problem detected by detekt on the source code

Location

class Location(val source: SourceLocation, val endSource: SourceLocation, val text: TextLocation, val filePath: FilePath) : Compactable

Specifies a position within a source code fragment.

Notification

interface Notification

Any kind of notification which should be printed to the console. For example when using the formatting rule set, any change to your kotlin file is a notification.

OutputReport

abstract class OutputReport : Extension

Translates detekt's result container - Detektion - into an output report which is written inside a file.

ProjectMetric

open class ProjectMetric(val type: String, val value: Int, val priority: Int = -1, val isDouble: Boolean = false, val conversionFactor: Int = DEFAULT_FLOAT_CONVERSION_FACTOR)

Anything that can be expressed as a numeric value for projects.

PropertiesAware

interface PropertiesAware

Properties holder. Allows to store and retrieve any data.

ReportingExtension

interface ReportingExtension : Extension

Allows to intercept detekt's result container by listening to the initial and final state and manipulate the reported issues.

RequiresTypeResolution

@Target(allowedTargets = [AnnotationTarget.CLASS])

annotation class RequiresTypeResolution

Annotated Rule requires type resolution to work.

Rule

open class Rule(val config: Config, val description: String) : DetektVisitor

A rule defines how one specific code structure should look like. If code is found which does not meet this structure, it is considered as harmful regarding maintainability or readability.

RuleSet

class RuleSet(val id: RuleSet.Id, val rules: Map<Rule.Id, (Config) -> Rule>)

A rule set is a collection of rules and must be defined within a rule set provider implementation.

RuleSetProvider

interface RuleSetProvider

A rule set provider, as the name states, is responsible for creating rule sets.

SetupContext

interface SetupContext : PropertiesAware

Context providing useful processing settings to initialize extensions.

Severity

enum Severity : Enum<Severity>

The severity for each Issue. This will be printed to the output, such as XML or Sarif. Depending on the severity of the issues found, the build process result is determined.

SourceLocation

class SourceLocation(val line: Int, val column: Int)

Stores line and column information of a location.

TextLocation

class TextLocation(val start: Int, val end: Int)

Stores character start and end positions of a text file.

ValuesWithReason

class ValuesWithReason : Iterable<ValueWithReason>

ValuesWithReason is essentially the same as List of ValueWithReason. Due to type erasure we cannot use the list directly. Instances of this type should always created using the valuesWithReason factory method.

ValueWithReason

class ValueWithReason(val value: String, val reason: String? = null)

A ValueWithReason represents a single configuration value that may have an explanation as to why it is used.

Properties

modifiedText

var KtFile.modifiedText: String?

Functions

config

fun <T : Any> config(defaultValue: T): ReadOnlyProperty<Rule, T>

Creates a delegated read-only property that can be used in ConfigAware objects. The name of the property is the key that is used during configuration lookup. The value of the property is evaluated only once.

fun <T : Any, U : Any> config(defaultValue: T, transformer: (T) -> U): ReadOnlyProperty<Rule, U>

configWithAndroidVariants

fun <T : Any> configWithAndroidVariants(defaultValue: T, defaultAndroidValue: T): ReadOnlyProperty<Rule, T>

fun <T : Any, U : Any> configWithAndroidVariants(defaultValue: T, defaultAndroidValue: T, transformer: (T) -> U): ReadOnlyProperty<Rule, U>

configWithFallback

fun <T : Any> configWithFallback(fallbackProperty: KProperty0<T>, defaultValue: T): ReadOnlyProperty<Rule, T>

Creates a delegated read-only property that can be used in ConfigAware objects. The name of the property is the key that is used during configuration lookup. If there is no such property, the value of the supplied fallbackProperty is also considered before using the defaultValue. The value of the property is evaluated only once.

fun <T : Any, U : Any> configWithFallback(fallbackProperty: KProperty0<U>, defaultValue: T, transformer: (T) -> U): ReadOnlyProperty<Rule, U>

getOrNull

inline fun <T : Any> PropertiesAware.getOrNull(key: String): T?

Allows to retrieve stored properties in a type safe way.

simplePatternToRegex

fun String.simplePatternToRegex(): Regex

Convert a simple pattern String to a Regex

valuesWithReason

fun valuesWithReason(vararg values: Pair<String, String?>): ValuesWithReason

This factory method can be used by rule authors to specify one or many configuration values along with an explanation for each value. For example:

fun valuesWithReason(values: List<ValueWithReason>): ValuesWithReason

This factory method can be used by rule authors to specify one or many configuration values along with an explanation for each value.