rspec-conductor 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '082ad795d53684a33439d9c56e8d4ff175460d6b335bf25dfbc0114f913a764e'
-  data.tar.gz: ddedba7528e3cd7eaa045b55814c1a4d85a09bb69d9dcceb57c843d00244cec8
+  metadata.gz: 880d64a3a408ec26218ffc3d108ef6aa12b14da3a6f8d6b5e6ad5d8599373e0b
+  data.tar.gz: 421c5c55606788739b895d559d6093032454a831f47a18e5d5a616b76d0ccf49
 SHA512:
-  metadata.gz: 9620094891ec8e360d4427f001711ea4b9e2393020f83706ba86840e135d636d04cb13f2442e97b71a8cbc4bbe12b75354ae86c7e3899fa06035a553b2a29377
-  data.tar.gz: 6842b752e4d66f10b5fed3070aa7fcb7edc7470c3b873fc5da9c8ec86f113e36d1743b0d4193c2966c80acb6638c4cb1b3626b1a2060e813334c2c62392b8d14
+  metadata.gz: 2102903198e4025159240b0a3c564831e3a10db533eef4cb1811d5bc20b6122fe10cf7e856a3a523c2bad2076772cd5da848a66a3cb3e6f6d0f93244a0477c3e
+  data.tar.gz: abbaf107a50db30d9ad2e8e87c27dd3188c7afbcd2714ce37a8aef56bf88cc6fdbcb25471c6497137c0e5a5cb15a0cdb53e4516a73f2ccbd7e4055268951ec02

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.0.4] - 2026-02-12
+
+- use Etc.nprocessors to determine the default worker count (reported by @coorasse)
+- use env vars (RSPEC_CONDUCTOR_DEFAULT_WORKER_COUNT, RSPEC_CONDUCTOR_FIRST_IS_1) more consistently between the rake task and the cli. Meaning, if you set these env vars, you should also see the corresponding change in the cli defaults
+- Fix some rake task issues in CI (reported by @cb341)
+- Fix namespace clash with RSpec::Rails in the rake task (reported by @cb341)
+
 ## [1.0.3] - 2026-02-08
 
 - rake tasks for database preparation

data/README.md

@@ -37,7 +37,18 @@ Server process preloads the `rails_helper`, prepares a list of files to work, th
 
 ## Setting up the databases in Rails
 
-In order to bootstrap the test environment, there is a rake task:
+If you want ten workers, you're going to need ten databases. Something like this in your `database.yml` file:
+
+```yaml
+test:
+  primary:
+    <<: *default
+    database: database_test<%= ENV['TEST_ENV_NUMBER'] %>
+```
+
+That means worker number 3 is going to use database `database_test3`, worker number 4 `database_test4` and so on. Worker number 1 is special: with `--first-is-1` flag on it uses `TEST_ENV_NUMBER="1"`, but without it, it uses `TEST_ENV_NUMBER=""` (empty string).
+
+In order to bootstrap the test databases, there is a rake task:
 
 ```bash
 # Recreate and seed test databases with TEST_ENV_NUMBER 1 to 10
@@ -49,6 +60,12 @@ RSPEC_CONDUCTOR_FIRST_IS_1=1 rails rspec_conductor:setup[10]
 
 You can also set the env variable `RSPEC_CONDUCTOR_DEFAULT_WORKER_COUNT` to change the default worker count to avoid typing the quotes for the rake task arguments in zsh.
 
+```bash
+export RSPEC_CONDUCTOR_DEFAULT_WORKER_COUNT=10
+rails rspec_conductor:setup # assumes [10]
+
+```
+
 ## Development notes
 
 * In order to make the CLI executable load and run fast, do not add any dependencies. That includes `active_support`.
@@ -72,6 +89,13 @@ Short answer: it's unsafe. Any file descriptors, such as db connections, redis c
 
 ## Prior Art
 
+### File-based runners (split the load before the launch)
+
+* [parallel-tests](https://github.com/grosser/parallel_tests)
+* [flatware](https://github.com/briandunn/flatware)
+
+### Queue-based runners (feed workers from the queue)
+
 * [test-queue](https://github.com/tmm1/test-queue)
 * [rspecq](https://github.com/skroutz/rspecq/)
 * [ci-queue](https://github.com/Shopify/ci-queue/)

data/lib/rspec/conductor/cli.rb

@@ -6,9 +6,9 @@ module RSpec
   module Conductor
     class CLI
       DEFAULTS = {
-        workers: 4,
+        workers: Conductor.default_worker_count,
         offset: 0,
-        first_is_1: false,
+        first_is_1: Conductor.default_first_is_1?,
         seed: nil,
         fail_fast_after: nil,
         verbose: false,

data/lib/rspec/conductor/server.rb

@@ -26,7 +26,7 @@ module RSpec
         @worker_number_offset = opts.fetch(:worker_number_offset, 0)
         @prefork_require = opts.fetch(:prefork_require, nil)
         @postfork_require = opts.fetch(:postfork_require, nil)
-        @first_is_one = opts.fetch(:first_is_1, false)
+        @first_is_1 = opts.fetch(:first_is_1, Conductor.default_first_is_1?)
         @seed = opts[:seed] || (Random.new_seed % MAX_SEED)
         @fail_fast_after = opts[:fail_fast_after]
         @display_retry_backtraces = opts.fetch(:display_retry_backtraces, false)
@@ -134,7 +134,7 @@ module RSpec
         pid = fork do
           parent_socket.close
 
-          ENV["TEST_ENV_NUMBER"] = if @first_is_one || worker_number != 1
+          ENV["TEST_ENV_NUMBER"] = if @first_is_1 || worker_number != 1
                                      worker_number.to_s
                                    else
                                      ""

data/lib/rspec/conductor/util/ansi.rb

@@ -122,16 +122,22 @@ module RSpec
           string.gsub(ANSI_SEQUENCE_REGEX, '')
         end
 
-        def tty_width(tty = $stdout)
-          return 80 unless tty.tty?
+        def tty_width(io = $stdout)
+          return 80 unless io.tty?
 
-          tty.winsize[1]
+          width = io.winsize[1].to_i
+          return 40 if width < 40 # work around some badly behaved ci environments
+
+          width
         end
 
-        def tty_height(tty = $stdout)
-          return 50 unless tty.tty?
+        def tty_height(io = $stdout)
+          return 50 unless io.tty?
+
+          height = io.winsize[0].to_i
+          return 10 if height < 10 # work around some badly behaved ci environments
 
-          tty.winsize[0]
+          height
         end
       end
     end

data/lib/rspec/conductor/version.rb

@@ -2,6 +2,6 @@
 
 module RSpec
   module Conductor
-    VERSION = "1.0.3"
+    VERSION = "1.0.4"
   end
 end

data/lib/rspec/conductor.rb

@@ -1,6 +1,31 @@
 # frozen_string_literal: true
 
 require "rspec/core"
+require "etc"
+
+module RSpec
+  module Conductor
+    def self.root
+      @root ||= Dir.pwd
+    end
+
+    def self.root=(root)
+      @root = root
+    end
+
+    def self.default_worker_count
+      @default_worker_count ||= if ENV['RSPEC_CONDUCTOR_DEFAULT_WORKER_COUNT'].to_i > 0
+                                  ENV['RSPEC_CONDUCTOR_DEFAULT_WORKER_COUNT'].to_i
+                                else
+                                  Etc.nprocessors
+                                end
+    end
+
+    def self.default_first_is_1?
+      ENV["RSPEC_CONDUCTOR_FIRST_IS_1"] == "1"
+    end
+  end
+end
 
 require_relative "conductor/util/ansi"
 require_relative "conductor/util/terminal"
@@ -16,18 +41,6 @@ require_relative "conductor/formatters/plain"
 require_relative "conductor/formatters/ci"
 require_relative "conductor/formatters/fancy"
 
-module RSpec
-  module Conductor
-    def self.root
-      @root ||= Dir.pwd
-    end
-
-    def self.root=(root)
-      @root = root
-    end
-  end
-end
-
 if defined?(Rails)
   require_relative "conductor/railtie"
 end

data/lib/tasks/rspec_conductor.rake

@@ -4,19 +4,15 @@ module RSpec
   module Conductor
     module DatabaseTasks
       class << self
-        def default_worker_count
-          ENV['RSPEC_CONDUCTOR_DEFAULT_WORKER_COUNT']&.to_i || 4
-        end
-
         def create_databases(count)
           run_for_each_database(count, "Creating") do
-            db_configs.each { |config| ActiveRecord::Tasks::DatabaseTasks.create(config) }
+            db_configs.each { |config| ::ActiveRecord::Tasks::DatabaseTasks.create(config) }
           end
         end
 
         def drop_databases(count)
           run_for_each_database(count, "Dropping") do
-            db_configs.each { |config| ActiveRecord::Tasks::DatabaseTasks.drop(config) }
+            db_configs.each { |config| ::ActiveRecord::Tasks::DatabaseTasks.drop(config) }
           end
         end
 
@@ -25,29 +21,29 @@ module RSpec
 
           run_for_each_database(count, "Setting up") do
             puts "Dropping database(s)"
-            db_configs.each { |config| ActiveRecord::Tasks::DatabaseTasks.drop(config) }
+            db_configs.each { |config| ::ActiveRecord::Tasks::DatabaseTasks.drop(config) }
 
             puts "Creating database(s)"
-            db_configs.each { |config| ActiveRecord::Tasks::DatabaseTasks.create(config) }
+            db_configs.each { |config| ::ActiveRecord::Tasks::DatabaseTasks.create(config) }
 
             puts "Loading schema"
-            db_configs.each { |config| ActiveRecord::Tasks::DatabaseTasks.load_schema(config, schema_format, schema_file) }
+            db_configs.each { |config| ::ActiveRecord::Tasks::DatabaseTasks.load_schema(config, schema_format, schema_file) }
 
             puts "Loading seed"
-            ActiveRecord::Tasks::DatabaseTasks.load_seed
+            ::ActiveRecord::Tasks::DatabaseTasks.load_seed
           end
         end
 
         private
 
         def first_is_1?
-          ENV["RSPEC_CONDUCTOR_FIRST_IS_1"] == "1"
+          RSpec::Conductor.default_first_is_1?
         end
 
         def db_configs
           reload_database_configuration!
 
-          configs = ActiveRecord::Base.configurations.configs_for(env_name: Rails.env)
+          configs = ::ActiveRecord::Base.configurations.configs_for(env_name: Rails.env)
           raise ArgumentError, "could not find or parse configuration for the env #{Rails.env}" unless configs.any?
 
           configs
@@ -58,7 +54,7 @@ module RSpec
 
           puts "#{action} #{count} test databases in parallel..."
           # Close connections before forking to avoid sharing file descriptors
-          ActiveRecord::Base.connection_pool.disconnect!
+          ::ActiveRecord::Base.connection_pool.disconnect!
 
           terminal = Conductor::Util::Terminal.new
           children = count.times.map do |i|
@@ -106,12 +102,12 @@ module RSpec
           parsed_yaml = Rails.application.config.load_database_yaml
           raise ArgumentError, "could not find database yaml or the yaml is empty" if parsed_yaml.empty?
 
-          ActiveRecord::Base.configurations = ActiveRecord::DatabaseConfigurations.new(parsed_yaml)
+          ::ActiveRecord::Base.configurations = ::ActiveRecord::DatabaseConfigurations.new(parsed_yaml)
         end
 
         def schema_format_and_file
-          ruby_schema = File.join(Rails.root, "db", "schema.rb")
-          sql_schema = File.join(Rails.root, "db", "structure.sql")
+          ruby_schema = File.join(::Rails.root, "db", "schema.rb")
+          sql_schema = File.join(::Rails.root, "db", "structure.sql")
 
           if File.exist?(ruby_schema)
             [:ruby, ruby_schema]
@@ -127,21 +123,21 @@ module RSpec
 end
 
 namespace :rspec_conductor do
-  desc "Create parallel test databases (default: #{RSpec::Conductor::DatabaseTasks.default_worker_count})"
+  desc "Create parallel test databases (default: #{RSpec::Conductor.default_worker_count})"
   task :create, [:count] => %w(set_rails_env_to_test environment) do |_t, args|
-    count = (args[:count] || RSpec::Conductor::DatabaseTasks.default_worker_count).to_i
+    count = (args[:count] || RSpec::Conductor.default_worker_count).to_i
     RSpec::Conductor::DatabaseTasks.create_databases(count)
   end
 
-  desc "Drop parallel test databases (default: #{RSpec::Conductor::DatabaseTasks.default_worker_count})"
+  desc "Drop parallel test databases (default: #{RSpec::Conductor.default_worker_count})"
   task :drop, [:count] => %w(set_rails_env_to_test environment) do |_t, args|
-    count = (args[:count] || RSpec::Conductor::DatabaseTasks.default_worker_count).to_i
+    count = (args[:count] || RSpec::Conductor.default_worker_count).to_i
     RSpec::Conductor::DatabaseTasks.drop_databases(count)
   end
 
-  desc "Setup parallel test databases (drop + create + schema load + seed) (default: #{RSpec::Conductor::DatabaseTasks.default_worker_count})"
+  desc "Setup parallel test databases (drop + create + schema load + seed) (default: #{RSpec::Conductor.default_worker_count})"
   task :setup, [:count] => %w(set_rails_env_to_test environment) do |_t, args|
-    count = (args[:count] || RSpec::Conductor::DatabaseTasks.default_worker_count).to_i
+    count = (args[:count] || RSpec::Conductor.default_worker_count).to_i
     RSpec::Conductor::DatabaseTasks.setup_databases(count)
   end
 
@@ -152,8 +148,13 @@ namespace :rspec_conductor do
     if ENV['RAILS_ENV']
       require_relative "../rspec/conductor/util/terminal"
       require_relative "../rspec/conductor/util/child_process"
+
+      unless defined?(::Rails.root) && defined?(::ActiveRecord::Tasks::DatabaseTasks)
+        warn 'rspec-conductor rake tasks need a working rails environment to work with the databases'
+        exit 1
+      end
     else
-      system({ "RAILS_ENV" => "test" }, "rake", *Rake.application.top_level_tasks)
+      system({ "RAILS_ENV" => "test" }, "rake", *::Rake.application.top_level_tasks)
       exit
     end
   end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rspec-conductor
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Mark Abramov
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-core
@@ -67,7 +66,6 @@ metadata:
   homepage_uri: https://github.com/markiz/rspec-conductor
   source_code_uri: https://github.com/markiz/rspec-conductor
   changelog_uri: https://github.com/markiz/rspec-conductor/blob/master/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -82,8 +80,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Queue-based parallel test runner for rspec
 test_files: []