Rule

A Scalafix Rule.

To provide automatic fixes for this rule, override the fix method. Example:

object ReverseNames extends Rule("ReverseNames") {
  override def fix(ctx: RuleCtx) =
    ctx.tree.collect {
      case name @ Name(value) => ctx.replaceTree(name, value.reverse)
    }.asPatch
}

To report violations of this rule (without automatic fix), override the check method. Example:

// example syntactic linter
object NoVars extends Rule("NoVars") {
  val varDefinition = LintCategory.error("varDefinition", "Var is bad!")
  override def check(ctx: RuleCtx) = ctx.tree.collect {
    case definition @ q"$_ var $_ = $_" => varDefinition.at(definition.pos)
  }
}
// example semantic linter
case class NeverInferProduct(index: SemanticdbIndex)
    extends SemanticRule(index, "NeverInferProduct")
    with Product {
  val product = SymbolMatcher.exact(Symbol("_root_.scala.Product#"))
  val inferredProduct: LintCategory =
    LintCategory.error("inferredProduct", "Don't infer Product!")
  override def check(ctx: RuleCtx) =
    ctx.index.synthetics.flatMap {
      case Synthetic(pos, text, names) =>
        names.collect {
          case ResolvedName(_, product(_), _) =>
            inferredProduct.at(pos)
        }
    }
}

Self Type: Rule

Linear Supertypes

AnyRef, Any

Known Subclasses

DottyKeywords, DottyVarArgPattern, DottyVolatileLazyVal, ExplicitResultTypes, ExplicitUnit, NoAutoTupling, NoValInForComprehension, ProcedureSyntax, RemoveUnusedImports, RemoveXmlLiterals, Rewrite, Sbt1, SemanticRewrite, SemanticRule

Instance Constructors

new Rule(ruleName: RuleName)

ruleName
Name of this rule that users call via .scalafix.conf or in the sbt shell. By convention, a name should be PascalCase matching the class name of the rule. Example good name: NoVars, ExplicitUnit. Example bad name: no-vars, noVars, FixVars.

Value Members

final def !=(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: Any): Boolean

Definition Classes
AnyRef → Any
final def apply(ctx: RuleCtx, patch: Patch): String
final def apply(input: String): String
final def apply(input: scala.meta.Input, config: internal.config.ScalafixConfig = ScalafixConfig.default): String
final def apply(ctx: RuleCtx): String

Returns string output of applying this single patch.
final def asInstanceOf[T0]: T0

Definition Classes
Any
def check(ctx: RuleCtx): Seq[LintMessage]

Returns linter messages to report violations of this rule.
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
final def diff(ctx: RuleCtx, patch: Patch): String

Attributes
protected
final def diff(ctx: RuleCtx): String

Returns unified diff from applying this patch
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
def fix(ctx: RuleCtx): Patch

Returns a patch to fix violations of this rule.
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
def init(config: Conf): Configured[Rule]

Initialize this rule with the given user configuration.
Initialize this rule with the given user configuration.
This method is called once by scalafix before rule is called. Use this method to either read custom configuration or to build expensive indices.
config
The .scalafix.conf configuration.
returns
the initialized rule or an error. If no initialization is needed, return Configured.Ok(this).
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
final def merge(other: Rule): Rule

Combine this rule with another rule.
final def name: RuleName
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
def semanticOption: Option[SemanticdbIndex]

Attributes
protected[scalafix]
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
final def toString(): String

Definition Classes
Rule → AnyRef → Any
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )

Deprecated Value Members

final def andThen(other: Rule): Rule

Annotations
@deprecated
Deprecated
(Since version 0.5.0) Renamed to merge.

Related Docs: object Rule | package rule

abstract class Rule extends AnyRef

Instance Constructors

new Rule(ruleName: RuleName)

Value Members

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: Any): Boolean

final def apply(ctx: RuleCtx, patch: Patch): String

final def apply(input: String): String

final def apply(input: scala.meta.Input, config: internal.config.ScalafixConfig = ScalafixConfig.default): String

final def apply(ctx: RuleCtx): String

final def asInstanceOf[T0]: T0

def check(ctx: RuleCtx): Seq[LintMessage]

def clone(): AnyRef

final def diff(ctx: RuleCtx, patch: Patch): String

final def diff(ctx: RuleCtx): String

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def finalize(): Unit

def fix(ctx: RuleCtx): Patch

final def getClass(): Class[_]

def hashCode(): Int

def init(config: Conf): Configured[Rule]

final def isInstanceOf[T0]: Boolean

final def merge(other: Rule): Rule

final def name: RuleName

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit

final def notifyAll(): Unit

def semanticOption: Option[SemanticdbIndex]

final def synchronized[T0](arg0: ⇒ T0): T0

final def toString(): String

final def wait(): Unit

final def wait(arg0: Long, arg1: Int): Unit

final def wait(arg0: Long): Unit

Deprecated Value Members

final def andThen(other: Rule): Rule

Inherited from AnyRef

Inherited from Any

Ungrouped