Methods
B
D
S
W
Classes and Modules
Constants
DEFAULT_BEHAVIORS = { :stderr => Proc.new { |message, callstack| $stderr.puts(message) $stderr.puts callstack.join("\n ") if debug }, :log => Proc.new { |message, callstack| logger = if defined?(Rails) && Rails.logger Rails.logger else require 'logger' Logger.new($stderr) end
 

Default warning behaviors per Rails.env.

Attributes
[RW] deprecation_horizon

The version the deprecated behavior will be removed, by default.

[RW] debug

Whether to print a backtrace along with the warning.

[RW] silenced
Class Public methods
behavior()

Returns the set behavior or if one isn’t set, defaults to :stderr

    # File activesupport/lib/active_support/deprecation/behaviors.rb, line 11
11:       def behavior
12:         @behavior ||= [DEFAULT_BEHAVIORS[:stderr]]
13:       end
behavior=(behavior)

Sets the behavior to the specified value. Can be a single value or an array.

Examples

  ActiveSupport::Deprecation.behavior = :stderr
  ActiveSupport::Deprecation.behavior = [:stderr, :log]
    # File activesupport/lib/active_support/deprecation/behaviors.rb, line 21
21:       def behavior=(behavior)
22:         @behavior = Array.wrap(behavior).map { |b| DEFAULT_BEHAVIORS[b] || b }
23:       end
deprecated_method_warning(method_name, message = nil)
    # File activesupport/lib/active_support/deprecation/reporting.rb, line 25
25:       def deprecated_method_warning(method_name, message = nil)
26:         warning = "#{method_name} is deprecated and will be removed from Rails #{deprecation_horizon}"
27:         case message
28:           when Symbol then "#{warning} (use #{message} instead)"
29:           when String then "#{warning} (#{message})"
30:           else warning
31:         end
32:       end
silence()

Silence deprecation warnings within the block.

    # File activesupport/lib/active_support/deprecation/reporting.rb, line 18
18:       def silence
19:         old_silenced, @silenced = @silenced, true
20:         yield
21:       ensure
22:         @silenced = old_silenced
23:       end
warn(message = nil, callstack = caller)

Outputs a deprecation warning to the output configured by ActiveSupport::Deprecation.behavior

  ActiveSupport::Deprecation.warn("something broke!")
  # => "DEPRECATION WARNING: something broke! (called from your_code.rb:1)"
    # File activesupport/lib/active_support/deprecation/reporting.rb, line 10
10:       def warn(message = nil, callstack = caller)
11:         return if silenced
12:         deprecation_message(callstack, message).tap do |m|
13:           behavior.each { |b| b.call(m, callstack) }
14:         end
15:       end