Skip to content

Latest commit

 

History

History
62 lines (47 loc) · 1.4 KB

Naming-UncommunicativeMethodParamName.md

File metadata and controls

62 lines (47 loc) · 1.4 KB

Pattern: Malformed method parameter name

Issue: -

Description

This rule checks method parameter names for how descriptive they are. It is highly configurable.

The MinNameLength config option takes an integer. It represents the minimum amount of characters the name must be. Its default is 3. The AllowNamesEndingInNumbers config option takes a boolean. When set to false, this rule will register offenses for names ending with numbers. Its default is false. The AllowedNames config option takes an array of whitelisted names that will never register an offense. The ForbiddenNames config option takes an array of blacklisted names that will always register an offense.

Examples

# bad
def bar(varOne, varTwo)
  varOne + varTwo
end

# With `AllowNamesEndingInNumbers` set to false
def foo(num1, num2)
  num1 * num2
end

# With `MinArgNameLength` set to number greater than 1
def baz(a, b, c)
  do_stuff(a, b, c)
end

# good
def bar(thud, fred)
  thud + fred
end

def foo(speed, distance)
  speed * distance
end

def baz(age_a, height_b, gender_c)
  do_stuff(age_a, height_b, gender_c)
end

Default configuration

Attribute Value
MinNameLength 3
AllowNamesEndingInNumbers true
AllowedNames io, id
ForbiddenNames []

Further Reading