Module | Gem::Deprecate |
In: |
lib/rubygems/deprecate.rb
|
Simple deprecation method that deprecates name by wrapping it up in a dummy method. It warns on each call to the dummy method telling the user of repl (unless repl is :none) and the year/month that it is planned to go away.
# File lib/rubygems/deprecate.rb, line 50 50: def deprecate name, repl, year, month 51: class_eval { 52: old = "_deprecated_#{name}" 53: alias_method old, name 54: define_method name do |*args, &block| # TODO: really works on 1.8.7? 55: klass = self.kind_of? Module 56: target = klass ? "#{self}." : "#{self.class}#" 57: msg = [ "NOTE: #{target}#{name} is deprecated", 58: repl == :none ? " with no replacement" : ", use #{repl}", 59: ". It will be removed on or after %4d-%02d-01." % [year, month], 60: "\n#{target}#{name} called from #{Gem.location_of_caller.join(":")}", 61: ] 62: warn "#{msg.join}." unless Gem::Deprecate.skip 63: send old, *args, &block 64: end 65: } 66: end