RuboCop OrderedMethods

Check that methods are defined alphabetically. Note caveats for autocorrection.

# bad
def self.b; end
def self.a; end

def b; end
def a; end

private

def d; end
def c; end

# good
def self.a; end
def self.b; end

def a; end
def b; end

private

def c; end
def d; end

Installation

Add this line to your application's Gemfile:

gem 'rubocop-ordered_methods'

And then execute:

$ bundle

Or install it yourself as:

$ gem install rubocop-ordered_methods

Usage

You need to tell RuboCop to load the OrderedMethods extension. There are two ways to do this:

RuboCop configuration file

Put this into your .rubocop.yml.

require: rubocop-ordered_methods

Now you can run rubocop and it will automatically load the RuboCop OrderedMethods cops together with the standard cops.

Command line

rubocop --require rubocop-ordered_methods

Configurable attributes

Name	Default value	Configurable values
EnforcedStyle	alphabetical	alphabetical
IgnoredMethods	initialize	Array

Corrector

The corrector will attempt to order methods based on the EnforcedStyle. It attempts to include surrounding comments and the qualifiers (e.g., aliases) listed in ::RuboCop::Cop::OrderedMethodsCorrector::QUALIFIERS. The following (monstrous) source is able to be correctly ordered:

# Long
# Preceding
# Comment
# class_b
def self.class_b; end
private_class_method :class_b

def self.class_a; end
# Long
# Succeeding
# Comment
# class_a
public_class_method :class_a

# Preceding comment for instance_b
def instance_b; end
# Long
# Succeeding
# Comment
# instance_b
alias_method :orig_instance_b, :instance_b
module_function :instance_b
private :instance_b
protected :instance_b
public :instance_b

# Long
# Preceding
# Comment
# instance_a
def instance_a; end
# Succeeding comment for instance_a
alias :new_instance_a :instance_a
alias_method :orig_instance_a, :instance_a
module_function :instance_a
private :instance_a
protected :instance_a
public :instance_a

Caveats

• The corrector will warn and refuse to order a method if it were to be defined before its alias

• If there's ambiguity about which method a comment or qualifier belongs to, the corrector might fail to order correctly. For example, in the following, the corrector would incorrectly order the comment as a comment of a:

  def b; end
  # Comment b
  def a; end
  

Development

Setup

bundle install
bundle exec rake

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/shanecav84/rubocop-ordered_methods. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the RuboCop OrderedMethods project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.