aboutsummaryrefslogblamecommitdiffstats
path: root/activesupport/lib/active_support/whiny_nil.rb
blob: f614b41fc76cdd939394711b507f394f6d7d2e56 (plain) (tree)
1
2
3
4
5
6
7
8
9
                                                                   



                                                                           
                                                                          

               
              


                                                            
                               
 

                                                                     

                                                                            
     
 
        
                                                                                                                                     
     


                                             
                                                                      

       
                                                                                  
                                                                  
                                                                                        
                                                                                    
 
                                                         
       

   
# Extensions to nil which allow for more helpful error messages for
# people who are new to rails.
#
# The aim is to ensure that when users pass nil to methods where that isn't
# appropriate, instead of NoMethodError and the name of some method used
# by the framework users will see a message explaining what type of object
# was expected.

class NilClass
  WHINERS = [::Array]
  WHINERS << ::ActiveRecord::Base if defined? ::ActiveRecord

  @@method_class_map = Hash.new

  WHINERS.each do |klass|
    methods = klass.public_instance_methods - public_instance_methods
    class_name = klass.name
    methods.each { |method| @@method_class_map[method.to_sym] = class_name }
  end

  def id
    raise RuntimeError, "Called id for nil, which would mistakenly be 4 -- if you really wanted the id of nil, use object_id", caller
  end

  private
    def method_missing(method, *args, &block)
      raise_nil_warning_for @@method_class_map[method], method, caller
    end

    def raise_nil_warning_for(class_name = nil, selector = nil, with_caller = nil)
      message = "You have a nil object when you didn't expect it!"
      message << "\nYou might have expected an instance of #{class_name}." if class_name
      message << "\nThe error occurred while evaluating nil.#{selector}" if selector

      raise NoMethodError, message, with_caller || caller
    end
end