module RSpec::Support::Warnings

def deprecate(deprecated, options={})
  warn_with "DEPRECATION: #{deprecated} is deprecated.", options
end

def warn_deprecation(message, options={})
  warn_with "DEPRECATION: \n #{message}", options
end

def warn_with(message, options={})
  call_site = options.fetch(:call_site) { CallerFilter.first_non_rspec_line }
  message += " Use #{options[:replacement]} instead." if options[:replacement]
  message += " Called from #{call_site}." if call_site
  Support.warning_notifier.call message
end

def warning(text, options={})
  warn_with "WARNING: #{text}.", options
end