did_you_mean

'Did you mean?' experience in Ruby. No, Really.

For those who are still using 0.6.0, 0.7.0 and 0.8.0, please upgrade to the latest version (0.9.4) as they have a serious bug with Ruby 2.1.3 and 2.1.4 installed on Max OS X.

Installation

Add this line to your application's Gemfile:

gem 'did_you_mean', group: [:development, :test]

Examples

NameError

Correcting a Misspelled Method Name

class User
  attr_accessor :first_name, :last_name

  def to_s
    "#{f1rst_name} #{last_name}" # f1rst_name ???
  end
end

user.to_s
# => NameError: undefined local variable or method `f1rst_name' for #<User:0x0000000928fad8>
#
#     Did you mean? #first_name
#

Correcting a Misspelled Class Name

class Book
  class TableOfContents
    # ...
  end
end

Book::TableofContents # TableofContents ???
# => NameError: uninitialized constant Book::TableofContents
#
#     Did you mean? Book::TableOfContents
#

Suggesting an instance variable name

@full_name = "Yuki Nishijima"
first_name, last_name = full_name.split(" ")
# => NameError: undefined local variable or method `full_name' for main:Object
#
#     Did you mean? @full_name
#

NoMethodError

# In a Rails controller:
params.with_inddiferent_access
# => NoMethodError: undefined method `with_inddiferent_access' for {}:Hash
#
#     Did you mean? #with_indifferent_access
#

ActiveRecord::UnknownAttributeError

User.new(nmee: "wrong flrst name")
# => ActiveRecord::UnknownAttributeError: unknown attribute: nmee
#
#     Did you mean? name: string
#

'Did You Mean' Experience is Everywhere

did_you_mean gem automagically puts method suggestions into the error message. This means you'll have the "Did you mean?" experience almost everywhere:

Support

did_you_mean gem supports the following implementations:

MRI 1.9.3, 2.0.0, 2.1.x, 2.2.0-preview1 and ruby-head
JRuby (tested against 1.7.16)

Any other implementations are NOT supported (Rubinius support is work in progress).

Contributing

Fork it (http://github.com/yuki24/did_you_mean/fork)
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

betweenparentheses/did_you_mean