Class: ActiveSupport::Deprecation::DeprecatedConstantProxy

Inherits:
Module
  • Object
show all
Defined in:
activesupport/lib/active_support/deprecation/proxy_wrappers.rb

Overview

DeprecatedConstantProxy transforms a constant into a deprecated one. It takes the full names of an old (deprecated) constant and of a new constant (both in string form) and a deprecator. The deprecated constant now returns the value of the new one.

PLANETS = %w(mercury venus earth mars jupiter saturn uranus neptune pluto)

# (In a later update, the original implementation of `PLANETS` has been removed.)

PLANETS_POST_2006 = %w(mercury venus earth mars jupiter saturn uranus neptune)
PLANETS = ActiveSupport::Deprecation::DeprecatedConstantProxy.new("PLANETS", "PLANETS_POST_2006", ActiveSupport::Deprecation.new)

PLANETS.map { |planet| planet.capitalize }
# => DEPRECATION WARNING: PLANETS is deprecated! Use PLANETS_POST_2006 instead.
     (Backtrace information

Constant Summary

Constants inherited from Module

Module::DELEGATION_RESERVED_KEYWORDS, Module::DELEGATION_RESERVED_METHOD_NAMES, Module::RUBY_RESERVED_KEYWORDS

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Module

#alias_attribute, #anonymous?, #as_json, #attr_internal_accessor, #attr_internal_reader, #attr_internal_writer, #delegate, #delegate_missing_to, #deprecate, #mattr_accessor, #mattr_reader, #mattr_writer, #method_visibility, #module_parent, #module_parent_name, #module_parents, #redefine_method, #redefine_singleton_method, #remove_possible_method, #remove_possible_singleton_method, #silence_redefinition_of_method, #thread_mattr_accessor, #thread_mattr_reader, #thread_mattr_writer

Methods included from Module::Concerning

#concern, #concerning

Constructor Details

#initialize(old_const, new_const, deprecator = nil, message: "#{old_const} is deprecated! Use #{new_const} instead.") ⇒ DeprecatedConstantProxy

Returns a new instance of DeprecatedConstantProxy.



130
131
132
133
134
135
136
137
138
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 130

def initialize(old_const, new_const, deprecator = nil, message: "#{old_const} is deprecated! Use #{new_const} instead.")
  Kernel.require "active_support/inflector/methods"

  @old_const = old_const
  @new_const = new_const
  ActiveSupport.deprecator.warn("DeprecatedConstantProxy without a deprecator is deprecated") unless deprecator
  @deprecator = deprecator || ActiveSupport::Deprecation._instance
  @message = message
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(called, *args, &block) ⇒ Object (private)



186
187
188
189
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 186

def method_missing(called, *args, &block)
  @deprecator.warn(@message, caller_locations)
  target.__send__(called, *args, &block)
end

Class Method Details

.new(*args, **options, &block) ⇒ Object



123
124
125
126
127
128
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 123

def self.new(*args, **options, &block)
  object = args.first

  return object unless object
  super
end

Instance Method Details

#append_features(base) ⇒ Object



161
162
163
164
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 161

def append_features(base)
  @deprecator.warn(@message, caller_locations)
  base.include(target)
end

#classObject

Returns the class of the new constant.

PLANETS_POST_2006 = %w(mercury venus earth mars jupiter saturn uranus neptune)
PLANETS = ActiveSupport::Deprecation::DeprecatedConstantProxy.new('PLANETS', 'PLANETS_POST_2006')
PLANETS.class # => Array


157
158
159
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 157

def class
  target.class
end

#extended(base) ⇒ Object



171
172
173
174
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 171

def extended(base)
  @deprecator.warn(@message, caller_locations)
  base.extend(target)
end

#inspectObject

Don’t give a deprecation warning on inspect since test/unit and error logs rely on it for diagnostics.



144
145
146
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 144

def inspect
  target.inspect
end

#prepend_features(base) ⇒ Object



166
167
168
169
# File 'activesupport/lib/active_support/deprecation/proxy_wrappers.rb', line 166

def prepend_features(base)
  @deprecator.warn(@message, caller_locations)
  base.prepend(target)
end