Class: Mutineer::MinitestIntegration

Inherits:
Object
  • Object
show all
Defined in:
lib/mutineer/minitest_integration.rb

Overview

Child-process-only: loads a test file in the current process and runs it programmatically, returning an exit status integer (0 = all passed, 1 = any failure/error).

Never call this in the parent — it manipulates global Minitest state (autorun, runnables) that only makes sense in a throwaway forked child.

No rescue here: Isolation.run's fork block is the single exception boundary (any exception there becomes exit 2). Adding a rescue would create a second exit-2 path and break this method's 0/1 return contract.

Class Method Summary collapse

Class Method Details

.run(test_files) ⇒ Object

ponytail: tested via runner_test.rb (U6), not in isolation — a direct unit test would require forking and duplicate isolation_test's coverage.

test_files is one path or an Array of paths (M3 coverage selection passes the covering subset); each is loaded before the single Minitest.run.



22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/mutineer/minitest_integration.rb', line 22

def self.run(test_files)
  # minitest is required LAZILY (never at load time) so Mutineer keeps zero
  # runtime gem deps and loads fine in an rspec-only project; a missing
  # minitest raises a clear Mutineer error rather than a LoadError backtrace.
  begin
    require "minitest"
  rescue LoadError
    raise Mutineer::FrameworkUnavailable,
          "minitest is not available — add minitest to the project under test, " \
          "or use --framework rspec"
  end

  # Neutralise autorun so a test file's `require "minitest/autorun"`
  # registers no at_exit hook.
  def Minitest.autorun; end # rubocop:disable Lint/NestedMethodDefinition

  # Drop runnables inherited from the parent suite (this is the child's
  # private copy — the parent is unaffected) so only the target test runs.
  Minitest::Runnable.reset

  Array(test_files).each { |f| load f }

  # Silence the child's test output; the parent only cares about pass/fail.
  orig = $stdout
  $stdout = StringIO.new
  passed = Minitest.run([])
  $stdout = orig

  passed ? 0 : 1
end