Module Gem::Deprecate
In: lib/rubygems/deprecate.rb

Methods

deprecate   skip_during  

Public Instance methods

deprecate(name, repl, year, month)

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.

[Source]

    # 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
skip_during() {|| ...}

Temporarily turn off warnings. Intended for tests only.

[Source]

    # File lib/rubygems/deprecate.rb, line 37
37:     def skip_during
38:       Gem::Deprecate.skip, original = true, Gem::Deprecate.skip
39:       yield
40:     ensure
41:       Gem::Deprecate.skip = original
42:     end

[Validate]