class

Ameba::Rule::Lint::UnusedBlockArgument

Inherits Ameba::AST::Util < YAML::Serializable < Ameba::Rule::Base < Ameba::Config::RuleConfig < Reference < Object

A rule that reports unused block arguments. For example, this is considered invalid:

def foo(a, b, &block)
  a + b
end

def bar(&block)
  yield 42
end

and should be written as:

def foo(a, b, &_block)
  a + b
end

def bar(&)
  yield 42
end

YAML configuration example:

Lint/UnusedBlockArgument:
  Enabled: true

Constants

MSG_UNUSED = "Unused block argument `%1$s`. If it's necessary, use `_%1$s` as an argument name to indicate that it won't be used."

MSG_YIELDED = "Use `&` as an argument name to indicate that it won't be referenced"

Constructors

new(ctx : YAML::ParseContext, node : YAML::Nodes::Node)

new(config = nil)

A rule that reports unused block arguments. For example, this is considered invalid:

def foo(a, b, &block)
  a + b
end

def bar(&block)
  yield 42
end

and should be written as:

def foo(a, b, &_block)
  a + b
end

def bar(&)
  yield 42
end

YAML configuration example:

Lint/UnusedBlockArgument:
  Enabled: true

Source

new(*, __context_for_yaml_serializable ctx : YAML::ParseContext, __node_for_yaml_serializable node : YAML::Nodes::Node)

Class methods

deprecated?

Returns true if this rule is deprecated, false otherwise.

deprecation_reason

Returns the deprecation reason for this rule, if there is any.

documentation_url

Returns the documentation URL for this rule.

Ameba::Rule::Lint::Syntax.documentation_url
# => "https://crystal-ameba.org/api/master/Ameba/Rule/Lint/Syntax.html"

parsed_doc

Returns the documentation for this rule, if there is any.

module Ameba
  # This is a test rule.
  # Does nothing.
  class Rule::MyRule < Rule::Base
    def test(source)
    end
  end
end

Ameba::Rule::MyRule.parsed_doc # => "This is a test rule.\nDoes nothing."

to_json_schema(builder : JSON::Builder) : Nil

Source

Instance methods

description

description=(description : String)

enabled=(enabled : Bool)

enabled?

excluded

excluded=(excluded : Set(String) | Nil)

severity

severity=(severity : Ameba::Severity)

since_version

Source

since_version=(since_version : String)

test(source, node : Crystal::Def, scope : AST::Scope)

Source

test(source)

Source