Method: Arrow::Object.deprecate_class_method

Defined in:
lib/arrow/object.rb

.deprecate_class_method(oldSym, newSym = oldSym) ⇒ Object

Like Object.deprecate_method, but for class methods.



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
 
# File 'lib/arrow/object.rb', line 68

def self::deprecate_class_method( oldSym, newSym=oldSym )
  warningMessage = ''

  # If the method is being removed, alias it away somewhere and build
  # an appropriate warning message. Otherwise, just build a warning
  # message.
  if oldSym == newSym
    newSym = ("__deprecated_" + oldSym.to_s + "__").to_sym
    warningMessage = "%s::%s is deprecated" %
      [ self.name, oldSym.to_s ]
    alias_class_method newSym, oldSym
  else
    warningMessage = "%s::%s is deprecated; use %s::%s instead" %
      [ self.name, oldSym.to_s, self.name, newSym.to_s ]
  end

  # Build the method that logs a warning and then calls the true
  # method.
  class_eval %Q{
    def self::#{oldSym.to_s}( *args, &block )
      Arrow::Logger.notice "warning: %s: #{warningMessage}" % [ caller(1) ]
      send( #{newSym.inspect}, *args, &block )
    rescue => err
      # Mangle exceptions to point someplace useful
      Kernel.raise err, err.message, err.backtrace[2..-1]
    end
  }
end