# See http://www.seejohncode.com/2012/01/09/deprecating-methods-in-ruby/
require 'facets/module/mattr' # gives cattr

module SanitizeEmail
  module Deprecation

    mattr_reader :deprecate_in_silence
    mattr_writer :deprecate_in_silence
    self.deprecate_in_silence = false

    # Define a deprecated alias for a method
    # @param [Symbol] name - name of method to define
    # @param [Symbol] replacement - name of method to (alias)
    def deprecated_alias(name, replacement)
      # Create a wrapped version
      define_method(name) do |*args, &block|
        warn "SanitizeEmail: ##{name} deprecated (please use ##{replacement})" unless @@deprecate_in_silence
        send replacement, *args, &block
      end
    end

    # Deprecate a defined method
    # @param [Symbol] name - name of deprecated method
    # @param [Symbol] replacement - name of the desired replacement
    def deprecated(name, replacement = nil)
      # Replace old method
      old_name = :"#{name}_without_deprecation"
      alias_method old_name, name
      # And replace it with a wrapped version
      define_method(name) do |*args, &block|
        unless @@deprecate_in_silence
          if replacement
            warn "SanitizeEmail: ##{name} deprecated (please use ##{replacement})"
          else
            warn "SanitizeEmail: ##{name} deprecated"
          end
        end
        send old_name, *args, &block
      end
    end

  end
end