turbo_tests2 3.1.14 → 3.2.1

data/lib/turbo_tests/runner.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "json"
+require "fileutils"
 require "parallel_tests/rspec/runner"
 require "rspec/core"
 require "shellwords"
@@ -11,6 +12,9 @@ require_relative "../utils/hash_extension"
 module TurboTests
   class Runner
     using CoreExtensions
+    DEFAULT_RUNTIME_LOG = "tmp/turbo_rspec_runtime.log"
+    DEFAULT_WORKER_OUTPUT_MODE = :warnings
+    WORKER_OUTPUT_MODES = %i[warnings stream buffered quiet].freeze
 
     class << self
       def create(count)
@@ -33,7 +37,7 @@ module TurboTests
         parallel_options = opts[:parallel_options] || {}
 
         start_time = opts.fetch(:start_time) { RSpec::Core::Time.now }
-        runtime_log = opts.fetch(:runtime_log, nil)
+        runtime_log = opts.fetch(:runtime_log, nil) || DEFAULT_RUNTIME_LOG
         example_status_log = opts.fetch(:example_status_log, nil)
         verbose = opts.fetch(:verbose, false)
         fail_fast = opts.fetch(:fail_fast, nil)
@@ -44,17 +48,22 @@ module TurboTests
         seed = generate_seed if seed_used && seed.nil?
         print_failed_group = opts.fetch(:print_failed_group, false)
         nice = opts.fetch(:nice, false)
+        worker_output = normalize_worker_output_mode(
+          opts[:worker_output] || ENV["TURBO_TESTS2_WORKER_OUTPUT"]
+        )
 
         use_runtime_info = default_file_discovery
+        parallel_options[:runtime_log] ||= runtime_log
 
         if example_status_log
           runtime_log = runtime_log_from_example_status(example_status_log)
           parallel_options[:runtime_log] = runtime_log
         elsif use_runtime_info
-          parallel_options[:runtime_log] = runtime_log
+          parallel_options[:runtime_log] ||= runtime_log
         else
-          parallel_options[:group_by] = :filesize
+          parallel_options[:group_by] ||= :filesize
         end
+        parallel_options[:group_by] ||= :filesize if parallel_options[:only_group]
 
         warn("VERBOSE") if verbose
 
@@ -78,10 +87,22 @@ module TurboTests
           print_failed_group: print_failed_group,
           use_runtime_info: use_runtime_info,
           parallel_options: parallel_options,
-          nice: nice
+          nice: nice,
+          worker_output: worker_output
         ).run
       end
 
+      def normalize_worker_output_mode(mode)
+        value = mode.to_s.strip.downcase.tr("-", "_")
+        return DEFAULT_WORKER_OUTPUT_MODE if value.empty?
+
+        normalized = value.to_sym
+        return normalized if WORKER_OUTPUT_MODES.include?(normalized)
+
+        raise ArgumentError,
+          "Unsupported worker output mode #{mode.inspect}; expected one of: #{WORKER_OUTPUT_MODES.join(", ")}"
+      end
+
       def normalize_rspec_file_selection(files)
         selectors = {}
         files.each do |entry|
@@ -156,9 +177,10 @@ module TurboTests
           end
 
           case arg
-          when "--pattern", "-P", "--default-path"
+          when "--pattern", "-P", "--default-path", "--format", "-f", "--out", "-o"
             skip_next = true
-          when /\A--pattern=/, /\A-P.+/, /\A--default-path=/
+          when /\A--pattern=/, /\A-P.+/, /\A--default-path=/,
+            /\A--format=/, /\A-f.+/, /\A--out=/, /\A-o.+/
             next
           else
             filtered << arg
@@ -200,10 +222,10 @@ module TurboTests
 
       # Supports runtime_log as a top level option,
       #   but also nested inside parallel_options
-      @runtime_log = opts[:runtime_log] || "tmp/turbo_rspec_runtime.log"
+      @runtime_log = opts[:runtime_log] || DEFAULT_RUNTIME_LOG
       @parallel_options = opts.fetch(:parallel_options, {})
       @parallel_options[:runtime_log] ||= @runtime_log
-      @record_runtime = @parallel_options[:group_by] == :runtime
+      @record_runtime = true
 
       @messages = Thread::Queue.new
       @threads = []
@@ -214,10 +236,12 @@ module TurboTests
       @deferred_run_options_messages = Hash.new { |hash, message| hash[message] = [] }
       @error = false
       @print_failed_group = opts[:print_failed_group]
+      @worker_output_mode = self.class.normalize_worker_output_mode(opts.fetch(:worker_output, DEFAULT_WORKER_OUTPUT_MODE))
     end
 
     def run
-      tests_with_size = ParallelTests::RSpec::Runner.tests_with_size(@files, {})
+      parallel_tests_options = @parallel_options.reject { |key, _value| key == :only_group }
+      tests_with_size = ParallelTests::RSpec::Runner.tests_with_size(@files, parallel_tests_options.merge(quiet: true))
       @num_processes = [
         ParallelTests.determine_number_of_processes(@count),
         tests_with_size.size
@@ -233,8 +257,9 @@ module TurboTests
         ParallelTests::RSpec::Runner.tests_in_groups(
           @files,
           @num_processes,
-          **@parallel_options
+          **parallel_tests_options
         )
+      tests_in_groups = selected_groups(tests_in_groups) if @parallel_options[:only_group]
       @tests_in_groups = tests_in_groups
 
       subprocess_opts = {
@@ -264,10 +289,11 @@ module TurboTests
           statuses = @wait_threads.map(&:value)
 
           if @reporter.failed_examples.empty? && statuses.all?(&:success?)
+            flush_successful_worker_output
             report_coverage = true
             exit_status = 0
           else
-            flush_worker_output
+            flush_worker_output unless stream_worker_output?
             # From https://github.com/galtzo-floss/turbo_tests2/pull/20/
             exit_status = statuses.map(&:exitstatus).max
           end
@@ -280,6 +306,18 @@ module TurboTests
 
     private
 
+    def selected_groups(tests_in_groups)
+      requested_groups = @parallel_options[:only_group]
+      missing_groups = requested_groups.select { |index| index > tests_in_groups.size }
+      unless missing_groups.empty?
+        raise ArgumentError,
+          "Selected group index(es) out of range: #{missing_groups.join(", ")} " \
+          "(available groups: #{tests_in_groups.size})"
+      end
+
+      requested_groups.map { |index| tests_in_groups[index - 1] }
+    end
+
     def handle_interrupt
       if @interrupt_handled
         Kernel.exit
@@ -337,6 +375,7 @@ module TurboTests
 
         record_runtime_options =
           if record_runtime
+            FileUtils.mkdir_p(File.dirname(@runtime_log))
             [
               "--format",
               "ParallelTests::RSpec::RuntimeLogger",
@@ -483,7 +522,25 @@ module TurboTests
       end
 
       io = (stream == :stderr) ? $stderr : $stdout
-      io.write(msg) if @verbose
+      io.write(msg) if stream_worker_output?
+    end
+
+    def stream_worker_output?
+      @verbose || @worker_output_mode == :stream
+    end
+
+    def flush_successful_worker_output
+      case @worker_output_mode
+      when :warnings
+        flush_worker_warnings unless stream_worker_output?
+      when :buffered
+        flush_worker_output unless stream_worker_output?
+      when :quiet, :stream
+        nil
+      else
+        raise ArgumentError,
+          "Unsupported worker output mode #{@worker_output_mode.inspect}; expected one of: #{WORKER_OUTPUT_MODES.join(", ")}"
+      end
     end
 
     def flush_worker_output
@@ -504,6 +561,43 @@ module TurboTests
       end
     end
 
+    def flush_worker_warnings
+      output_by_process = @worker_output_mutex.synchronize do
+        @worker_output.transform_values(&:dup)
+      end
+
+      output_by_process.each do |process_id, streams|
+        streams.each do |stream, output|
+          warnings = warning_lines(output)
+          next if warnings.empty?
+
+          io = (stream == :stderr) ? $stderr : $stdout
+          io.puts
+          io.puts("TurboTests worker #{process_id} #{stream} warnings:")
+          warnings.each { |line| io.puts(line) }
+        end
+      end
+    end
+
+    def warning_lines(output)
+      output.each_line.each_with_object([]) do |line, warnings|
+        stripped = line.strip
+        next if stripped.empty?
+        next unless warning_line?(stripped)
+        next if coverage_output_line?(stripped)
+
+        warnings << stripped
+      end
+    end
+
+    def warning_line?(line)
+      line.match?(/warning:/i) || line.match?(/deprecat/i)
+    end
+
+    def coverage_output_line?(line)
+      line.start_with?("Coverage report generated for ", "JSON Coverage report generated for ", "Line coverage:", "Branch coverage:", "Line Coverage:", "Branch Coverage:")
+    end
+
     def flush_coverage_summary
       line_coverage = nil
       branch_coverage = nil

data/lib/turbo_tests/version.rb

@@ -2,7 +2,7 @@
 
 module TurboTests
   module Version
-    VERSION = "3.1.14"
+    VERSION = "3.2.1"
   end
   VERSION = Version::VERSION # Traditional Constant Location
 end

data.tar.gz.sig

@@ -1,2 +1,2 @@
-MX™gt#�x(n
-������u�9����6C ��T�d{&B��Ԯ�)���,�O�F§�n=����ѡd���8�S>{(�FZ������=z�B(`�[I�B*bM�1|�0� ��t��:�b��ur@�iLv���Aw� V�h��t�sdy�J���j�=��WXi�I�x9� M��G���2=��&դ;~�L
+�A�c���N_W�O�#Q�V��:
+��9���H1m��
k��`䡮�fd�p��Q��G�a�>��=-P�m�*�c��^��1��-�J�)ړ���v�b��82θ�̨�-���*jFG~��5��S3�ң@�q�kT����<jvm���8�U"I��I�hL���y���P�C�P����BW甔�,��
���3//O_��A�I��V��%���穎(!Sx�9��J0���l�f�:��q%я-� ����9k

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_tests2
 version: !ruby/object:Gem::Version
-  version: 3.1.14
+  version: 3.2.1
 platform: ruby
 authors:
 - Illia
@@ -110,7 +110,7 @@ dependencies:
         version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.5
+        version: 2.3.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -120,7 +120,7 @@ dependencies:
         version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.5
+        version: 2.3.7
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -175,20 +175,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.4
+        version: 3.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.4
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -198,7 +198,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.10
+        version: 2.0.15
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -208,7 +208,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.10
+        version: 2.0.15
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -273,28 +273,11 @@ email:
 executables:
 - turbo_tests2
 extensions: []
-extra_rdoc_files:
-- CHANGELOG.md
-- CITATION.cff
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- FUNDING.md
-- LICENSE.md
-- README.md
-- RUBOCOP.md
-- SECURITY.md
+extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CITATION.cff
-- CODE_OF_CONDUCT.md
-- CONTRIBUTING.md
-- FUNDING.md
 - LICENSE.md
-- MIT.md
 - README.md
-- RUBOCOP.md
-- SECURITY.md
-- certs/pboling.pem
 - exe/turbo_tests2
 - lib/turbo_tests.rb
 - lib/turbo_tests/cli.rb
@@ -306,16 +289,15 @@ files:
 - lib/turbo_tests2.rb
 - lib/turbo_tests2/rspec/shared_contexts/simplecov_spawn.rb
 - lib/utils/hash_extension.rb
-- sig/turbo_tests/version.rbs
 homepage: https://github.com/galtzo-floss/turbo_tests2
 licenses:
 - MIT
 metadata:
   homepage_uri: https://turbo-tests2.galtzo.com
-  source_code_uri: https://github.com/galtzo-floss/turbo_tests2/tree/v3.1.14
-  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.1.14/CHANGELOG.md
+  source_code_uri: https://github.com/galtzo-floss/turbo_tests2/tree/v3.2.1
+  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.2.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/galtzo-floss/turbo_tests2/issues
-  documentation_uri: https://www.rubydoc.info/gems/turbo_tests2/3.1.14
+  documentation_uri: https://www.rubydoc.info/gems/turbo_tests2/3.2.1
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/galtzo-floss/turbo_tests2/wiki
   news_uri: https://www.railsbling.com/tags/turbo_tests2
@@ -345,7 +327,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.17
 specification_version: 4
 summary: "\U0001F680 RSpec parallel test runner built on `parallel_tests`, with incremental
   summarized output"

data/CITATION.cff

@@ -1,20 +0,0 @@
-cff-version: 1.2.0
-title: "turbo_tests2"
-message: >-
-  If you use this work and you want to cite it,
-  then you can use the metadata from this file.
-type: software
-authors:
-  - given-names: "Peter H."
-    family-names: "Boling"
-    email: "floss@galtzo.com"
-    affiliation: "galtzo.com"
-    orcid: 'https://orcid.org/0009-0008-8519-441X'
-identifiers:
-  - type: url
-    value: 'https://github.com/galtzo-floss/turbo_tests2'
-    description: "turbo_tests2"
-repository-code: 'https://github.com/galtzo-floss/turbo_tests2'
-abstract: >-
-  turbo_tests2
-license: See license file

data/CODE_OF_CONDUCT.md

@@ -1,134 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the overall
-  community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or advances of
-  any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email address,
-  without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official email address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
-[![Contact Maintainer][🚂maint-contact-img]][🚂maint-contact].
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of
-actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or permanent
-ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within the
-community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
-
-For answers to common questions about this code of conduct, see the FAQ at
-[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
-[https://www.contributor-covenant.org/translations][translations].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
-[Mozilla CoC]: https://github.com/mozilla/diversity
-[FAQ]: https://www.contributor-covenant.org/faq
-[translations]: https://www.contributor-covenant.org/translations
-[🚂maint-contact]: http://www.railsbling.com/contact
-[🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red