mutineer 1.5.0 → 1.6.0

data/lib/mutineer/test_runners/rspec.rb

@@ -44,6 +44,7 @@ module Mutineer
         # silenced here: the fork boundary that calls this method has already
         # pointed stdout at File::NULL (see ChildStdout).
         sink = StringIO.new
+        keep_file_order(spec_files) if stop_at_first_failure || record_to
         args = ["--no-color"]
         args << "--fail-fast" if stop_at_first_failure
         status = with_fail_fast_off(record_to) do
@@ -56,6 +57,44 @@ module Mutineer
         KillChannel.write_end(record_to) if record_to && KillFormatter.last&.saw_every_example?
 
         status.zero? ? 0 : 1
+      ensure
+        FileOrder.rank = nil
+      end
+
+      # Runs the top-level example groups in the order of `spec_files` (#203),
+      # after RSpec's own ordering, which then decides the order within a file.
+      #
+      # @api private
+      # @param spec_files [String, Array<String>] the files, in run order.
+      # @return [void]
+      def self.keep_file_order(spec_files)
+        FileOrder.rank = Array(spec_files).each_with_index.to_h { |f, i| [File.expand_path(f), i] }
+        ::RSpec::Core::World.prepend(FileOrder) unless ::RSpec::Core::World <= FileOrder
+      end
+
+      # Prepended on `RSpec::Core::World`: a stable sort of the ordered
+      # top-level groups by their file's position. Does nothing without a rank.
+      module FileOrder
+        class << self
+          # Each spec file's position, keyed by absolute path, or nil.
+          #
+          # @return [Hash{String => Integer}, nil]
+          attr_accessor :rank
+        end
+
+        # The groups RSpec ordered, sorted by file position.
+        #
+        # @return [Array<RSpec::Core::ExampleGroup>]
+        def ordered_example_groups
+          groups = super
+          rank = FileOrder.rank
+          return groups unless rank
+
+          groups.sort_by.with_index do |group, i|
+            file = group.metadata[:absolute_file_path] || File.expand_path(group.file_path)
+            [rank.fetch(file, rank.size), i]
+          end
+        end
       end
 
       # Runs the block with fail-fast forced off when `record_to` is set: a

data/lib/mutineer/version.rb

@@ -2,5 +2,5 @@
 
 module Mutineer
   # Current Mutineer release version.
-  VERSION = "1.5.0"
+  VERSION = "1.6.0"
 end

data/lib/mutineer.rb

@@ -36,6 +36,7 @@ require_relative "mutineer/mutators/operator_assignment"
 require_relative "mutineer/mutator_registry"
 require_relative "mutineer/worker_pool"
 require_relative "mutineer/progress"
+require_relative "mutineer/job_plan"
 require_relative "mutineer/runner"
 require_relative "mutineer/kill_matrix"
 require_relative "mutineer/reporter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mutineer
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - David Teren
@@ -64,6 +64,7 @@ files:
 - lib/mutineer/external_backend.rb
 - lib/mutineer/file_swap.rb
 - lib/mutineer/isolation.rb
+- lib/mutineer/job_plan.rb
 - lib/mutineer/kill_channel.rb
 - lib/mutineer/kill_matrix.rb
 - lib/mutineer/minitest_integration.rb
@@ -93,6 +94,7 @@ files:
 - lib/mutineer/mutators/safe_navigation.rb
 - lib/mutineer/mutators/statement_removal.rb
 - lib/mutineer/mutators/string_literal.rb
+- lib/mutineer/orphan_guard.rb
 - lib/mutineer/pairing.rb
 - lib/mutineer/parser.rb
 - lib/mutineer/progress.rb