class Minitest::Mock

一个简单而干净的模拟对象框架。

所有模拟对象都是 Mock 的实例

公共实例方法

expect(name, retval, args = [], **kwargs, &blk) 点击切换源代码

期望调用方法 name，可以选择使用 args（和 kwargs 或 blk），并返回 retval。

@mock.expect(:meaning_of_life, 42)
@mock.meaning_of_life # => 42

@mock.expect(:do_something_with, true, [some_obj, true])
@mock.do_something_with(some_obj, true) # => true

@mock.expect(:do_something_else, true) do |a1, a2|
  a1 == "buggs" && a2 == :bunny
end

args 使用大小写相等（即 ‘===’ 运算符）与预期参数进行比较，允许更宽松的期望。

@mock.expect(:uses_any_string, true, [String])
@mock.uses_any_string("foo") # => true
@mock.verify  # => true

@mock.expect(:uses_one_string, true, ["foo"])
@mock.uses_one_string("bar") # => raises MockExpectationError

如果一个方法将被多次调用，请为每次调用指定一个新的 expect。它们将按照您定义的顺序使用。

@mock.expect(:ordinal_increment, 'first')
@mock.expect(:ordinal_increment, 'second')

@mock.ordinal_increment # => 'first'
@mock.ordinal_increment # => 'second'
@mock.ordinal_increment # => raises MockExpectationError "No more expects available for :ordinal_increment"

# File minitest-5.25.4/lib/minitest/mock.rb, line 96
def expect name, retval, args = [], **kwargs, &blk
  name = name.to_sym

  if blk then
    raise ArgumentError, "args ignored when block given" unless args.empty?
    raise ArgumentError, "kwargs ignored when block given" unless kwargs.empty?
    @expected_calls[name] << { :retval => retval, :block => blk }
  else
    raise ArgumentError, "args must be an array" unless Array === args

    if ENV["MT_KWARGS_HAC\K"] && (Hash === args.last ||
                                  Hash ==  args.last) then
      if kwargs.empty? then
        kwargs = args.pop
      else
        unless @@KW_WARNED then
          from = caller(1..1).first
          warn "Using MT_KWARGS_HAC\K yet passing kwargs. From #{from}"
          @@KW_WARNED = true
        end
      end
    end

    @expected_calls[name] <<
      { :retval => retval, :args => args, :kwargs => kwargs }
  end
  self
end

verify() 点击切换源代码

验证是否所有方法都按预期调用。如果模拟对象未按预期调用，则引发 MockExpectationError。

# File minitest-5.25.4/lib/minitest/mock.rb, line 145
def verify
  @expected_calls.each do |name, expected|
    actual = @actual_calls.fetch name, nil # defaults to []
    raise MockExpectationError, "Expected #{__call name, expected[0]}" unless actual
    raise MockExpectationError, "Expected #{__call name, expected[actual.size]}, got [#{__call name, actual}]" if
      actual.size < expected.size
  end
  true
end