略過至內容 略過至搜尋
方法
A
C

執行個體公開的方法

assert_deprecated(deprecator, &block)
assert_deprecated(match, deprecator, &block)

斷言由給定的 deprecator 在執行 yield 區塊期間發出相符的過時警告。

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

match 物件可以是出現在訊息中的 Regexp 或 String。

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

如果省略 match (或明確為 nil)，任何過時警告皆會相符。

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

來源：顯示 | 於 GitHub 上

# File activesupport/lib/active_support/testing/deprecation.rb, line 30
def assert_deprecated(match = nil, deprecator = nil, &block)
  match, deprecator = nil, match if match.is_a?(ActiveSupport::Deprecation)

  unless deprecator
    raise ArgumentError, "No deprecator given"
  end

  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

assert_not_deprecated(deprecator, &block)

斷言由給定的 deprecator 在執行 yield 區塊期間未發出任何過時警告。

assert_not_deprecated(CustomDeprecator) do
  CustomDeprecator.warn "message" # fails assertion
end

assert_not_deprecated(ActiveSupport::Deprecation.new) do
  CustomDeprecator.warn "message" # passes assertion, different deprecator
end

來源：顯示 | 於 GitHub 上

# File activesupport/lib/active_support/testing/deprecation.rb, line 55
def assert_not_deprecated(deprecator, &block)
  result, deprecations = collect_deprecations(deprecator, &block)
  assert deprecations.empty?, "Expected no deprecation warning within the block but received #{deprecations.size}: \n  #{deprecations * "\n  "}"
  result
end

collect_deprecations(deprecator)

傳回區塊的傳回值，以及由給定的 deprecator 在執行 yield 區塊期間發出的所有過時警告陣列。

collect_deprecations(CustomDeprecator) do
  CustomDeprecator.warn "message"
  ActiveSupport::Deprecation.new.warn "other message"
  :result
end # => [:result, ["message"]]

來源：顯示 | 於 GitHub 上

# File activesupport/lib/active_support/testing/deprecation.rb, line 69
def collect_deprecations(deprecator)
  old_behavior = deprecator.behavior
  deprecations = []
  deprecator.behavior = Proc.new do |message, callstack|
    deprecations << message
  end
  result = yield
  [result, deprecations]
ensure
  deprecator.behavior = old_behavior
end