sqldelight-check-rule-api/dev.s7a.sqldelight.check.rule.api

Package-level declarations

Types

DiagnosticReporter

fun interface DiagnosticReporter

Receives diagnostics emitted by a rule.

abstract class RegexRule(ruleName: String, pattern: String, message: String, val defaultSeverity: Severity = Severity.Warning, val defaultEnable: Boolean = true, val targetCapability: DialectCapability? = null, hashLineComments: Boolean = false) : Rule

Base implementation for rules that report regular expression matches in masked SQL source text.

interface Rule

Lint or formatting rule contributed by a rule set.

interface RuleContext

Stable analysis view exposed to custom rules.

fun interface RuleProvider

Creates fresh rule instances for thread-safe analysis.

RuleSetProvider

interface RuleSetProvider

Provides a named collection of rules.

class SqlFacts(val statements: List<SqlStatementFacts> = emptyList())

Stable SQL structure facts exposed to custom rules.

class SqlJoinFacts(val range: SourceRange, val kind: String, val table: SqlTableReferenceFacts)

Stable facts for a JOIN clause.

SqlQualifiedReferenceFacts

class SqlQualifiedReferenceFacts(val range: SourceRange, val qualifier: String, val name: String)

Stable facts for a qualified reference such as table.column.

SqlResultColumnFacts

class SqlResultColumnFacts(val range: SourceRange, val alias: String? = null, val wildcard: Boolean = false)

Stable facts for a SELECT result column.

class SqlSelectFacts(val selectListRange: SourceRange, val resultColumns: List<SqlResultColumnFacts>)

Stable facts for a SELECT statement.

SqlStatementFacts

class SqlStatementFacts(val kind: SqlStatementKind, val range: SourceRange, val select: SqlSelectFacts? = null, val tableReferences: List<SqlTableReferenceFacts> = emptyList(), val joins: List<SqlJoinFacts> = emptyList(), val qualifiedReferences: List<SqlQualifiedReferenceFacts> = emptyList())

Stable facts for one top-level SQL statement.

SqlStatementKind

enum SqlStatementKind : Enum<SqlStatementKind>

Coarse statement kinds used by parser-backed rules.

SqlTableReferenceFacts

class SqlTableReferenceFacts(val range: SourceRange, val name: String? = null, val alias: String? = null, val subquery: Boolean = false)

Stable facts for a table or derived-table reference.

class SqlToken(val text: String, val startOffset: Int, val endOffset: Int)

SQL-like source token outside comments and quoted text.

Properties

defaultEnablement

val Rule.defaultEnablement: Enablement

Default enablement derived from Rule.defaultEnable.

Functions

fun Map<String, String>.booleanOption(name: String, defaultValue: Boolean): Boolean

Reads a strict boolean option from rule configuration.

commaSeparatedOption

fun Map<String, String>.commaSeparatedOption(name: String): List<String>

Reads a comma-separated string list from rule configuration.

fun SqlToken.isKeyword(value: String): Boolean

Returns true when this token matches value ignoring case.

maskSqlCommentsAndQuotedText

fun String.maskSqlCommentsAndQuotedText(hashLineComments: Boolean = false): String

Replaces comments and quoted text with spaces while preserving offsets.

fun String.positionAt(offset: Int): SourcePosition

Converts a source offset into a 1-based line/column position.

positiveIntOption

fun Map<String, String>.positiveIntOption(name: String, defaultValue: Int): Int

Reads a positive integer option from rule configuration.

fun String.rangeAtOffsets(startOffset: Int, endOffset: Int): SourceRange

Converts source offsets into a 1-based line/column range.

fun List<SqlToken>.sqlStatements(): List<List<SqlToken>>

Splits a token stream into statements at semicolon tokens.

fun String.sqlTokens(hashLineComments: Boolean = false): Sequence<SqlToken>

Tokenizes SQL-like identifiers and semicolons outside comments and quoted text.