ruby - 升级到 minitest 5.4.0。现在 must* 和 won't* 在 Minitest::Test 子类中不起作用，但 assert* 仍然有效

Question

我一直在使用 Ruby 2.1 附带的 MiniTest，没有任何问题。我将子类化 MiniTest::Unit:TestCase 创建几个方法，如“test_simple”，一切正常。我会毫无问题地使用 Expectations 和 Asserts。

我已经使用 gem 将 Minitest 升级到 5.4.0。在我使用 Expectations(必须和不会)的任何地方，我都会收到一个扼杀错误。测试类示例。

gem 'minitest'
require "minitest/autorun"
require "rest-client"
require "json"
require "pp"
# require './testcase_addins'


class TestUserKey < Minitest::Test

  def test_simple
    data = 0
    assert( data >= 0 )
    data.must_be :>=,0
  end
end

当我运行它时，assert 行毫无问题地通过了，但是 must_be 行抛出了这个错误:

  1) Error:
TestUserKey#test_simple:
NoMethodError: undefined method `assert_operator' for nil:NilClass
    (eval):4:in `must_be'
    user_key_testcase.rb:14:in `test_simple'

奇怪的是错误中的nil:NilClass can't be nil;是什么意思？它是 0。即使我将 Fixnum 更改为字符串，我仍然会遇到同样的错误。

如果我将测试更改为规范测试，一切都会再次正常。所以我不能在单元测试中使用 Expectations 吗？如果是这样，有人可以解释为什么吗？

Answer 1

简短的回答是，在 5.4.0 中，您的测试类必须继承自 MiniTest::Spec 才能使用期望。

我在通过 RVM 安装了 ruby​​ 2.1.2 的新 ubuntu 机器上测试了这个:

rvm install ruby-2.1.2

此代码适用于普通 ruby​​ 2.1.2(未安装 5.4.0 minitest gem，略微清理了上面的示例代码):

#!/usr/bin/env ruby

require 'minitest/unit'
require "minitest/autorun"

class TestUserKey < MiniTest::Unit::TestCase

  def test_simple
    data = 0
    assert( data >= 0 )
    data.must_be :>=,0
  end

end

运行此代码工作正常。要重现上面列出的错误，请安装 minitest 5.4.0:

gem install minitest -v 5.4.0

现在代码失败，出现“NoMethodError:undefined method ‘assert_operator’ for nil:NilClass”。您现在已经安装了两个版本的 minitest:

~/.rvm/rubies/ruby-2.1.2/lib/ruby/2.1.0/minitest/  # stock ruby version of minitest
~/.rvm/gems/ruby-2.1.2/gems/minitest-5.4.0/        # minitest v5.4.0 installed via rubygems

现在一切都已准备就绪，我们可以深入了解到底发生了什么。期望是通过调用 infect_an_assertion 来定义的，如下所示:

infect_an_assertion :assert_operator, :must_be, :reverse

对于 5.4.0，该调用发生在 ~/.rvm/gems/ruby-2.1.2/gems/minitest-5.4.0/lib/minitest/expectations.rb 中。这两个版本大致相同，只是发生在不同的地方。

两个版本的 infect_an_assertion 也大致相同。对于 :must_be，它最终会进行此调用，这在两个版本的 minitest 之间是相同的:

MiniTest::Spec.current.#{meth}(args.first, self, *args[1..-1])

他们在这里做一些元编程，运行时的调用看起来更像这样，因为 meth 被设置为 assert_operator:

MiniTest::Spec.current.assert_operator(...)

重要的部分是MiniTest::Spec.current。在 5.4.0 中，此方法返回 nil，当它尝试对 nil 调用 assert_operator 时会导致 NoMethodError 异常。

在 ruby​​ 2.1.2 的股票迷你测试中:

这里MiniTest::Spec继承自MiniTest::Unit::TestCase。 TestCase 定义方法 current 并返回在初始化方法中设置的值。您可以在 ~/.rvm/rubies/ruby-2.1.2/lib/ruby/2.1.0/minitest/unit.rb 的第 1303 行看到这一切:

def initialize name # :nodoc:
  @__name__ = name
  @__io__ = nil
  @passed = nil
  @@current = self # FIX: make thread local
end

def self.current # :nodoc:
  @@current # FIX: make thread local
end

因此，当您在您的测试类中使用标准的 minitest 从 MiniTest::Unit::TestCase 继承时，current 被定义为一个方法，并且当上述对 MiniTest::Spec.current 的调用是制作。这就是它在 stock ruby​​ 2.1.2 minitest 中工作的原因。

在 minitest 5.4.0 中

在 5.4.0 中，Minitest::Spec 继承自 Minitest::Test，它没有定义 current(也没有定义它的任何父类)。当前方法直接在 Minitest::Spec 上定义。它只是返回 Thread.current[:current_spec]:

# line 83 of ~/.rvm/gems/ruby-2.1.2/gems/minitest-5.4.0/lib/minitest/spec.rb      
def self.current # :nodoc:
  Thread.current[:current_spec]
end

Thread.current[:current_spec] 的值在同一文件第 87 行的 Minitest::Spec 构造函数中设置:

def initialize name # :nodoc:
  super
  Thread.current[:current_spec] = self
end

问题是，当您的测试类继承自 Minitest::Test 时，Minitest::Spec 构造函数永远不会被调用，并且 Thread.current[:current_spec] 永远不会被初始化。这意味着 infect_an_assertion 中对 Minitest::Spec.current 的调用返回 nil，这会导致您在尝试对 nil 调用 assert_operator 时看到的 NoMethodError。解决方案是让您的测试类继承自 Minitest::Spec，以便调用构造函数并 Thread.current[:current_spec] 获取一个值。

这里是原始代码的略微修改版本，适用于 minitest 5.4.0:

#!/usr/bin/env ruby

gem 'minitest'
require "minitest/autorun"

class TestUserKey < Minitest::Spec

  def test_simple
    data = 0
    assert( data >= 0 )
    data.must_be :>=,0
  end

end

希望这对您有所帮助!