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) ⇒ Integer

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.

Parameters:

  • test_files (String, Array<String>) —

    one file or many files.

Returns:

  • (Integer) —

    0 on success, 1 on failure.



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
52
53
54
55
 
# File 'lib/mutineer/minitest_integration.rb', line 26

def self.run(test_files)
  begin
    require "minitest"
  rescue LoadError
    raise Mutineer::FrameworkUnavailable,
          "minitest is not available — add minitest to the project under test, " \
          "or use --framework rspec"
  end

  # 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.

  # 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 }

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

  passed ? 0 : 1
end