2009-04-18 00:29:30 -04:00
|
|
|
module ActiveSupport
|
2012-09-13 02:38:34 -04:00
|
|
|
class Deprecation
|
|
|
|
module Reporting
|
|
|
|
# Whether to print a message (silent mode)
|
|
|
|
attr_accessor :silenced
|
|
|
|
# Name of gem where method is deprecated
|
|
|
|
attr_accessor :gem_name
|
2011-01-12 18:53:25 -05:00
|
|
|
|
2012-09-13 02:38:34 -04:00
|
|
|
# Outputs a deprecation warning to the output configured by
|
|
|
|
# <tt>ActiveSupport::Deprecation.behavior</tt>.
|
|
|
|
#
|
2012-09-14 23:28:56 -04:00
|
|
|
# ActiveSupport::Deprecation.warn('something broke!')
|
2012-09-13 02:38:34 -04:00
|
|
|
# # => "DEPRECATION WARNING: something broke! (called from your_code.rb:1)"
|
2012-10-29 22:23:41 -04:00
|
|
|
def warn(message = nil, callstack = nil)
|
2012-09-13 02:38:34 -04:00
|
|
|
return if silenced
|
2012-10-29 22:23:41 -04:00
|
|
|
|
|
|
|
callstack ||= caller(2)
|
2012-09-13 02:38:34 -04:00
|
|
|
deprecation_message(callstack, message).tap do |m|
|
|
|
|
behavior.each { |b| b.call(m, callstack) }
|
|
|
|
end
|
2009-04-18 00:29:30 -04:00
|
|
|
end
|
|
|
|
|
2012-09-13 02:38:34 -04:00
|
|
|
# Silence deprecation warnings within the block.
|
|
|
|
#
|
2012-09-14 23:28:56 -04:00
|
|
|
# ActiveSupport::Deprecation.warn('something broke!')
|
2012-09-13 02:38:34 -04:00
|
|
|
# # => "DEPRECATION WARNING: something broke! (called from your_code.rb:1)"
|
|
|
|
#
|
|
|
|
# ActiveSupport::Deprecation.silence do
|
2012-09-14 23:28:56 -04:00
|
|
|
# ActiveSupport::Deprecation.warn('something broke!')
|
2012-09-13 02:38:34 -04:00
|
|
|
# end
|
|
|
|
# # => nil
|
|
|
|
def silence
|
|
|
|
old_silenced, @silenced = @silenced, true
|
|
|
|
yield
|
|
|
|
ensure
|
|
|
|
@silenced = old_silenced
|
|
|
|
end
|
2009-04-18 00:29:30 -04:00
|
|
|
|
2012-10-29 22:23:41 -04:00
|
|
|
def deprecation_warning(deprecated_method_name, message = nil, caller_backtrace = nil)
|
|
|
|
caller_backtrace ||= caller(2)
|
2012-09-14 00:49:10 -04:00
|
|
|
deprecated_method_warning(deprecated_method_name, message).tap do |msg|
|
|
|
|
warn(msg, caller_backtrace)
|
2012-09-13 02:38:34 -04:00
|
|
|
end
|
2009-04-18 00:29:30 -04:00
|
|
|
end
|
|
|
|
|
2012-09-13 02:38:34 -04:00
|
|
|
private
|
|
|
|
# Outputs a deprecation warning message
|
2012-09-13 13:02:18 -04:00
|
|
|
#
|
2012-09-13 02:38:34 -04:00
|
|
|
# ActiveSupport::Deprecation.deprecated_method_warning(:method_name)
|
|
|
|
# # => "method_name is deprecated and will be removed from Rails #{deprecation_horizon}"
|
|
|
|
# ActiveSupport::Deprecation.deprecated_method_warning(:method_name, :another_method)
|
|
|
|
# # => "method_name is deprecated and will be removed from Rails #{deprecation_horizon} (use another_method instead)"
|
|
|
|
# ActiveSupport::Deprecation.deprecated_method_warning(:method_name, "Optional message")
|
|
|
|
# # => "method_name is deprecated and will be removed from Rails #{deprecation_horizon} (Optional message)"
|
|
|
|
def deprecated_method_warning(method_name, message = nil)
|
|
|
|
warning = "#{method_name} is deprecated and will be removed from #{gem_name} #{deprecation_horizon}"
|
|
|
|
case message
|
|
|
|
when Symbol then "#{warning} (use #{message} instead)"
|
|
|
|
when String then "#{warning} (#{message})"
|
|
|
|
else warning
|
|
|
|
end
|
|
|
|
end
|
2009-04-18 00:29:30 -04:00
|
|
|
|
2012-09-13 02:38:34 -04:00
|
|
|
def deprecation_message(callstack, message = nil)
|
|
|
|
message ||= "You are using deprecated behavior which will be removed from the next major or minor release."
|
|
|
|
message += '.' unless message =~ /\.$/
|
|
|
|
"DEPRECATION WARNING: #{message} #{deprecation_caller_message(callstack)}"
|
2009-04-18 00:29:30 -04:00
|
|
|
end
|
|
|
|
|
2012-09-13 02:38:34 -04:00
|
|
|
def deprecation_caller_message(callstack)
|
|
|
|
file, line, method = extract_callstack(callstack)
|
|
|
|
if file
|
|
|
|
if line && method
|
|
|
|
"(called from #{method} at #{file}:#{line})"
|
|
|
|
else
|
|
|
|
"(called from #{file}:#{line})"
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
def extract_callstack(callstack)
|
|
|
|
rails_gem_root = File.expand_path("../../../../..", __FILE__) + "/"
|
|
|
|
offending_line = callstack.find { |line| !line.start_with?(rails_gem_root) } || callstack.first
|
|
|
|
if offending_line
|
|
|
|
if md = offending_line.match(/^(.+?):(\d+)(?::in `(.*?)')?/)
|
|
|
|
md.captures
|
|
|
|
else
|
|
|
|
offending_line
|
|
|
|
end
|
|
|
|
end
|
2009-04-18 00:29:30 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|