module ActiveSupport::Testing::Deprecation

end
ActiveSupport::Deprecation.warn "foo should no longer be used"
assert_deprecated do

If no +deprecator+ is given, defaults to ActiveSupport::Deprecation.

end
CustomDeprecator.warn "foo should no longer be used"
assert_deprecated(nil, CustomDeprecator) do

If the +match+ is omitted (or explicitly +nil+), any deprecation warning will match.

end
CustomDeprecator.warn "foo should no longer be used"
assert_deprecated('foo', CustomDeprecator) do

The +match+ object may be a +Regexp+, or +String+ appearing in the message.

end
CustomDeprecator.warn "foo should no longer be used"
assert_deprecated(/foo/, CustomDeprecator) do

Asserts that a matching deprecation warning was emitted by the given deprecator during the execution of the yielded block.

def assert_deprecated(match = nil, deprecator = nil, &block)
  result, warnings = collect_deprecations(deprecator, &block)
  assert !warnings.empty?, "Expected a deprecation warning within the block but received none"
  if match
    match = Regexp.new(Regexp.escape(match)) unless match.is_a?(Regexp)
    assert warnings.any? { |w| match.match?(w) }, "No deprecation warning matched #{match}: #{warnings.join(', ')}"
  end
  result
end