How Minitest Works Part 2

Minitest.load_plugins

Minitest的插件都是以plugin.rb结尾，放在minitest目录下。比如在Minitest中就有pride_plugin.rb，它就是Minitest默认的 插件。每个Minitest的插件都可以有(不是必须有)一个以该插件名命名的初始化方法plugin[插件名]_init。 比如pride_plugin.rb的插件初始化方法为plugin_pride_init。Minitest的参数是用optparse解析的，它的插件也有一个支持optparse的方法: plugin_pride_options来做一些扩展。

Reporter

这期间还会初始化CompositeReporter、SummaryReporter和ProgressReporter 3 个reporter，并赋值给Minitest的reporter属性，它用来展示测试的结果；它只在init_plugins中可用，在初始化完plugin后就被置为空了。所以如果想要在测试结束后调用reporter相关的操作，可以自己编写plugin（后续文章我们会涉及）。

上面说了3中Reporter。那么这三者有什么区别和联系呢？

Reporter的继承结构是这样的:

AbstractReporter
|__Reporter
|   |__ProgressReporter
|   |__StatisticsReporter
|      |__SummaryReporter
|__CompositeReporter

所有的Reporter都是AbstractReporter子类，AbstractReporter定义了作为一个reporter应该有的方法，它们是start(在启动后开始记录测试结果),record(输出测试的结果；如果测试没有通过，会记录单个测试的结果),report(输出测试的概况),passed?(测试是否通过)。

Reporter默认将标准输出作为默认的输出。

ProgressReporter是一个很简单的reporter，他将测试用点打出.

StatisticsReporter收集单个测试的统计信息，并没有任何IO相关的操作。如果想定制输出类型（比如CI，HTML等等），可以通过修改这个类的一些方法来做到。该类因为是统计测试结果的，所以它里面包含了测试的数量、assert的数量、开始时间、总时间、失败的测试、报错的测试和跳过的测试数量。

SummaryReporter是StatisticsReporter的子类，分别在测试开始时和测试结束的时候打印参数信息和标题、概况、失败的细节信息,类似：

# At the beginning
Run options: --seed 13908

# Running:

# At the end
Finished in 0.003004s, 665.8359 runs/s, 665.8359 assertions/s.

2 runs, 2 assertions, 0 failures, 0 errors, 1 skips

You have skipped tests. Run with --verbose for details.

最后一句只有test中有skip的结果才会输出。

CompositeReporter可以调度多个repoter,将调用passed?、start、record、report的方法代理给所有的reporter。可以认为它是所有reporter的顶级代理类。

runnable.run

它可以按照用户输入的--name参数只跑符合对应正则的方法。里面定义了一个runnable_methods，它里面就会只保留满足子类定义的正则（不是用户输入的）的方法来一个个执行。比如Minitest::Test是Runnable的子类，它要求可执行方法是以test_开头；同样的Minitest::Benchmark要求方法以bench_开头.

保留的测试方法，会逐个执行，调用Minitest.run_one_method klass, method_name, reporter。 它将调用Runnable的initialize方法，将method_name作为参数，作为要调用的方法名。

runnable.new.run

以Minitest::Test为例，执行前它会先后调用before_setup、setup、after_setup几个钩子方法，然后调用上面作为参数传入的method_name。以实例代码为例，就是调用了DogTest.new. test_dog_should_spark，它里面就执行了具体的assert_方法，同样asert的数量就是在此时增加的。方法执行结束后，会调用before_teardown、teardown和after_teardown这几个钩子，你可以做一些你想在测试结束后想做的事情。

这里衍生出个问题：它是如何判断我是Skip还是报错的？

如果正常执行，它会根据test_方法实际的assert_方法的数量增加asserts属性的值。那么如果报错了呢？比如抛了一个异常，如何保证程序不终止，而是继续执行其他的方法呢？

答案是rescue，是的，对代码做保护,详见lib/minitest/test.rb:L204:

def capture_exceptions # :nodoc:
  yield
rescue *PASSTHROUGH_EXCEPTIONS
  raise
rescue Assertion => e
  self.failures << e
rescue Exception => e
  self.failures << UnexpectedError.new(e)
end

Asesrtion的继承关系如下图:

Exception
|__Assertion
   |__Skip
   |__UnexpectedError

如果某个方法是被skip了，那么它会抛出Skip异常，由Assertion捕获；如果方法执行代码错误，则被Exception捕获，并用UnexceptedError包一下。