parallel_rspec 2.5.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f3c6e266c19722af5f9372b3d27e31976e0d4ba1edfe1b923a9a475c1932225
-  data.tar.gz: d971168027f0b8f775607351ceb8c590886954a8a4612b00cf731560e9d54332
+  metadata.gz: fad2da0cd1720dc8803b2bf06d3ad7b0b4c71e0856667dd761e449b8c3b3ed5d
+  data.tar.gz: 61daddf9f3a36ad24353c487a029d77f7fefd87cf1207a7e79d7326500eb99be
 SHA512:
-  metadata.gz: 89333616f3c86fb6d4009b5a8b741c454f833e95dacc057269b4def04b2ea6c34da1e2494bd185253697720d8adb5178ed78fe46f1ae9a424aa20362dc7ce42d
-  data.tar.gz: 7902f5bb954a23ef452edfc13cc3cdf87611359e959d8cf8b16884840de52b1e8f9d48a5ba24b5685b4bf766baa22314e2cef78923b04bb591bf4779eed2cd6c
+  metadata.gz: e4f6821b9aee63cb2b55a8dcadf20e03a55570b24b2f68ad3e2e7f21f6b2f1cc4404ecddbeb3297c1b308a802876d59801bdd2f6b579e0309c80d8a7d16eeaee
+  data.tar.gz: 392c4adcd45f25706f47f18ee0be112a30bc5f199a0bcd821d4e5531c58b7e4a4cfa0983d9c144bd44bfdfb7bba19b1d7d683a8b4c63911a2d8c6303bde8f7ab

data/CHANGES.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 3.0.0
+
+* Fix reporting of `aggregate_failures` errors.
+* Add this gem's files to the backtrace filter RSpec uses to exclude its own files from failure messages.
+* Implement `--fail-fast` support.
+
+## 2.6.0
+
+* Fix `--profile` support. Thanks @peret.
+
 ## 2.5.0
 
 * Update the RSpec example persistence file after each run. Thanks @bagedevimo.
@@ -14,12 +24,12 @@
 
 ## 2.4.0
 
-* Wrap Exception objects so they can always be dumped and loaded, even if they contain non-marshallable objects such as Procs or anonymous classes.
+* Wrap `Exception` objects so they can always be dumped and loaded, even if they contain non-marshallable objects such as `Proc`s or anonymous classes.
 
 ## 2.3.0
 
 * Increase default workers from 2 to 4.
-* Fix behavioral inconsistency with rspec-core in nested describe blocks on helper methods with clashing let methods.
+* Fix behavioral inconsistency with rspec-core in nested describe blocks on helper methods with clashing `let` methods.
 
 ## 2.2.0
 
@@ -35,13 +45,13 @@
 
 ## 2.1.0
 
-* Add a default parallel_rspec rake task.
-* Add task descriptions for rake --tasks.
+* Add a default `parallel_rspec` rake task.
+* Add task descriptions for `rake --tasks`.
 
 ## 2.0.0
 
 * Remove an unnecessary dev dependency to pacify dependabot.
-* Add after_fork hook and running? method. Thanks @mogest.
+* Add `after_fork` hook and `running?` method. Thanks @mogest.
 * Upgrade for compatibility with Rails 6.1 and RSpec 3.10. Thanks @mogest.
 
 ## 1.2.0

data/README.md

@@ -1,6 +1,6 @@
 # ParallelRSpec
 
-This gem lets you run your RSpec examples in parallel across across your CPUs.  Each worker gets its own database to avoid conflicts.
+This gem lets you run your RSpec examples in parallel across your CPUs.  Each worker gets its own database to avoid conflicts.
 
 ## Installation
 
@@ -96,6 +96,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/willbr
 * Charles Horn (@hornc)
 * Roger Nesbitt (@mogest)
 * Erik Paasonen (@erikpaasonen)
+* Peter Retzlaff (@peret)
 
 
 ## License
@@ -103,4 +104,4 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/willbr
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
 Copyright (c) Powershop New Zealand Ltd, 2015.
-Copyright (c) Will Bryant, 2023.
+Copyright (c) Will Bryant, 2023.

data/lib/parallel_rspec/caller_filter_patch.rb

@@ -0,0 +1,11 @@
+require "rspec/support/caller_filter"
+
+if RSpec.const_defined?(:CallerFilter) && RSpec::CallerFilter.const_defined?(:IGNORE_REGEX)
+  module RSpec
+    class CallerFilter
+      _ignore_regex = Regexp.union(IGNORE_REGEX, "/lib/parallel_rspec", "parallel_rspec/exe/prspec")
+      remove_const :IGNORE_REGEX
+      IGNORE_REGEX = _ignore_regex
+    end
+  end
+end

data/lib/parallel_rspec/client.rb

@@ -1,3 +1,5 @@
+require "rspec/core"
+
 module ParallelRSpec
   # Some Exception objects contain non-marshallable ivars such as Proc objects. This wrapper
   # represents the bits needed by RSpec's ExceptionPresenter, and can be dumped and loaded.
@@ -28,6 +30,20 @@ module ParallelRSpec
     end
   end
 
+  class MultipleExceptionMarshallingWrapper < ExceptionMarshallingWrapper
+    include ::RSpec::Core::MultipleExceptionError::InterfaceTag
+
+    attr_reader :all_exceptions, :aggregation_block_label, :aggregation_metadata, :exception_count_description
+
+    def initialize(class_name, message, backtrace, cause, all_exceptions, aggregation_block_label, aggregation_metadata, exception_count_description)
+      super(class_name, message, backtrace, cause)
+      @all_exceptions = all_exceptions
+      @aggregation_block_label = aggregation_block_label
+      @aggregation_metadata = aggregation_metadata
+      @exception_count_description = exception_count_description
+    end
+  end
+
   class Client
     attr_reader :channel_to_server
 
@@ -35,14 +51,6 @@ module ParallelRSpec
       @channel_to_server = channel_to_server
     end
 
-    def example_group_started(group)
-      # not implemented yet - would need the same extraction/simplification for serialization as Example below
-    end
-
-    def example_group_finished(group)
-      # ditto
-    end
-
     def example_started(example)
       channel_to_server.write([:example_started, example.id, updates_from(example)])
     end
@@ -80,8 +88,30 @@ module ParallelRSpec
     end
 
     def dumpable_exception(exception)
-      return exception if exception.nil? || exception.is_a?(ExceptionMarshallingWrapper)
-      ExceptionMarshallingWrapper.new(exception.class.name, exception.to_s, exception.backtrace, dumpable_exception(exception.cause))
+      case exception
+      when nil
+        nil
+      when ExceptionMarshallingWrapper
+        exception
+      when ::RSpec::Core::MultipleExceptionError::InterfaceTag
+        MultipleExceptionMarshallingWrapper.new(
+          exception.class.name,
+          exception.message,
+          exception.backtrace,
+          dumpable_exception(exception.cause),
+          exception.all_exceptions.map { |exception| dumpable_exception(exception) },
+          exception.aggregation_block_label,
+          exception.aggregation_metadata,
+          exception.exception_count_description,
+        )
+      else
+        ExceptionMarshallingWrapper.new(
+          exception.class.name,
+          exception.message,
+          exception.backtrace,
+          dumpable_exception(exception.cause),
+        )
+      end
     end
 
     def next_example_to_run

data/lib/parallel_rspec/server.rb

@@ -1,6 +1,6 @@
 module ParallelRSpec
   class Server
-    attr_reader :reporter, :remaining_examples_by_group, :running_examples
+    attr_reader :reporter, :remaining_examples_by_group, :running_examples, :top_level_groups
 
     def initialize(reporter)
       @remaining_examples_by_group = RSpec.world.filtered_examples.each_with_object({}) do |(example_group, examples), results|
@@ -9,14 +9,34 @@ module ParallelRSpec
       @reporter = reporter
       @success = true
       @running_examples = {}
+      @top_level_groups = @remaining_examples_by_group.each_with_object({}) do |(group, examples), results|
+        results[top_level(group)] ||= { started: false, count: 0 }
+        results[top_level(group)][:count] += examples.size
+      end
+    end
+
+    def report_example_group_started(group)
+      top_level_group = top_level(group)
+      return if top_level_groups[top_level_group][:started] # already reported as started
+
+      top_level_groups[top_level_group][:started] = true
+      reporter.example_group_started(top_level_group)
+    end
+
+    def report_example_group_finished(group)
+      top_level_group = top_level(group)
+      top_level_groups[top_level_group][:count] -= 1
+      reporter.example_group_finished(top_level_group) if top_level_groups[top_level_group][:count].zero?
     end
 
     def example_started(example_id, example_updates, channel_to_client)
       reporter.example_started(update_example(running_examples[example_id], example_updates))
+      report_example_group_started(running_examples[example_id].example_group)
     end
 
     def example_finished(example_id, example_updates, channel_to_client)
       reporter.example_finished(update_example(running_examples[example_id], example_updates))
+      report_example_group_finished(running_examples[example_id].example_group)
     end
 
     def example_passed(example_id, example_updates, channel_to_client)
@@ -36,7 +56,7 @@ module ParallelRSpec
     end
 
     def next_example_to_run(channel_to_client)
-      if remaining_examples_by_group.empty?
+      if remaining_examples_by_group.empty? || reporter.fail_fast_limit_met?
         channel_to_client.write(nil)
       else
         example_group = remaining_examples_by_group.keys.first
@@ -60,5 +80,11 @@ module ParallelRSpec
       example.metadata.merge!(data[:metadata])
       example
     end
+
+    private
+
+    def top_level(example_group)
+      example_group.parent_groups.last
+    end
   end
 end

data/lib/parallel_rspec/version.rb

@@ -1,3 +1,3 @@
 module ParallelRSpec
-  VERSION = "2.5.0"
+  VERSION = "3.0.0"
 end

data/lib/parallel_rspec.rb

@@ -5,6 +5,7 @@ require "parallel_rspec/workers"
 require "parallel_rspec/example"
 require "parallel_rspec/server"
 require "parallel_rspec/client"
+require "parallel_rspec/caller_filter_patch"
 require "parallel_rspec/rake_task"
 require "parallel_rspec/runner"
 require "parallel_rspec/railtie"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parallel_rspec
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Will Bryant, Powershop New Zealand Ltd
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-03 00:00:00.000000000 Z
+date: 2026-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -57,6 +57,7 @@ files:
 - Rakefile
 - exe/prspec
 - lib/parallel_rspec.rb
+- lib/parallel_rspec/caller_filter_patch.rb
 - lib/parallel_rspec/channel.rb
 - lib/parallel_rspec/client.rb
 - lib/parallel_rspec/config.rb