minitest-fork_executor 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b399f50e3a52b2505c2125113c05ab712b1db59d26f00dd1075d7be2346c979b
+  data.tar.gz: a3394aab364af126482879b30badfd400ab2168185b1e746305555c42ef84ff2
+SHA512:
+  metadata.gz: b6014495cb3f12a88165cb983533be9a9b2f4e3188cbb67fa2e355577de3af285fc0ea6bf575e82e194d2526bedfa25ef979482be9377d96e1ca67082994a211
+  data.tar.gz: d887d4b98c08f8c7ba5e5c41687b88875ea431c9dd4ea0fbf5cb546947a524c6326ea5212519c98dcf3c91bceb417cc8feaeb04c1ef6e00cf6face124e8fef62

data/lib/minitest/fork_executor.rb

@@ -0,0 +1,48 @@
+module Minitest
+  class ForkExecutor
+    def start
+      # Minitest runs test cases via Minitest.run_one_method. Each test case
+      # in a test class is run separately. We need to override that method and
+      # fork there. run_one_method is a method on the Minitest module so we need
+      # to *prepend* our version so that it's called first.
+      metaclass = (class << Minitest; self; end)
+      metaclass.prepend ClassMethods
+    end
+
+    def shutdown
+      # Nothing to do here but required by Minitest.
+    end
+
+    module ClassMethods
+      # The updated version of Minitest.run_one_method that forks before
+      # actually running a test case, makes the child run it and send the result
+      # to the parent process.
+      def run_one_method klass, method_name
+        read_io, write_io = IO.pipe
+        read_io.binmode
+        write_io.binmode
+
+        if fork
+          # Parent: load the result sent from the child
+
+          write_io.close
+          result = Marshal.load(read_io)
+          read_io.close
+
+          Process.wait
+        else
+          # Child: just run normally, dump the result, and exit the process to
+          # avoid double-reporting.
+          result = super
+
+          read_io.close
+          Marshal.dump(result, write_io)
+          write_io.close
+          exit
+        end
+
+        result
+      end
+    end
+  end
+end

data/test/minitest/fork_executor_test.rb

@@ -0,0 +1,42 @@
+require 'tempfile'
+
+require 'minitest/autorun'
+require 'minitest/fork_executor'
+
+Minitest.parallel_executor = Minitest::ForkExecutor.new
+
+# This test may seem to be more complicated than necessary but it's actually
+# not. If we had only one test method then an implementation that forked an
+# run *all* tests in the fork would pass the test.
+#
+# We need to ensure that:
+#
+# 1. Different test methods are run in different processes - hence two tests.
+# 2. These processes are different from the parent process that spawned the
+#    test suite - hence recording @@parent_pid at the top.
+class ForkTest < Minitest::Test
+  @@log = Tempfile.new
+  @@parent_pid = Process.pid
+
+  def test_run_in_process_one
+    log_and_assert
+  end
+
+  def test_run_in_process_two
+    log_and_assert
+  end
+
+  private
+
+  def log_and_assert
+    @@log.seek(0, IO::SEEK_END)
+    @@log.write("#{Process.pid}\n")
+    @@log.rewind
+
+    pids = @@log.readlines.map(&:chop).map(&:to_i)
+    if pids.count == 2
+      assert_equal 2, pids.uniq.count
+      refute pids.include?(@@parent_pid)
+    end
+  end
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: minitest-fork_executor
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Greg Navis
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-01-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Run each test_* method in a separate process thus eliminating test case
+  interference.
+email: contact@gregnavis.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/minitest/fork_executor.rb
+- test/minitest/fork_executor_test.rb
+homepage: https://github.com/gregnavis/minitest-fork_executor
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.1
+signing_key: 
+specification_version: 4
+summary: Near-perfect process-level test case isolation.
+test_files:
+- test/minitest/fork_executor_test.rb