specwrk 0.20.1 → 0.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f54d9828f2a51417c4956185d141b8a3a74876a1379df8701182885ad932c515
-  data.tar.gz: a48f11d3a7977d02a5967e2d674ee68cf54a874a598e48db5b58ca3049ad80ac
+  metadata.gz: 94a0d37170078c212f345df5e4a1b014b5322856ed8f36305014ce55fd690aba
+  data.tar.gz: 2fa1e62b735f22f1342ae7e56634c257db48e9d6f72842328568293d59ecb764
 SHA512:
-  metadata.gz: d013fd261c119d58e7b607c4c9aaddd02c020d45e2ae56776ea111ea3217c248808d1fab8e93b4e440322b1ef9096efdad19de22e79683fa9e5116275ed91ce3
-  data.tar.gz: 2905267a34c6daab6e7f771b61d1bd0c4ffcef368646391ede9e9065e69452c047b4bd88695b930df953a3cbc0beab404cd73185d0f020556c1b09f6c14c5a25
+  metadata.gz: 298ce73183966b8e89ce38e7cee4ee4da184ee0bfccc114574a64ebf1fc55fe76bde02da0189060946db29913c9351e9fd84669ef23967433adb4f3b668a9fce
+  data.tar.gz: 74263602ada554af6970d5f58dc872e744c7517e9fd97141a8eb4ebec725f888440876dee810498be6a9230288325e85f38d8cf4db082a08d6fb94f0b1152f45

data/CHANGELOG.md

@@ -1,7 +1,12 @@
 # Changelog
 
 ## Unreleased  
-[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.20.1...main)  
+[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.20.2...main)  
+
+## v0.20.2 — 2026-08-27  
+[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.20.1...v0.20.2)  
+- Add a seed option for configuring the target bucket timing duration — [#191](https://github.com/danielwestendorf/specwrk/pull/191) by [@danielwestendorf](https://github.com/danielwestendorf)  
+- Print an indicator while workers wait for outstanding examples to finish — [#192](https://github.com/danielwestendorf/specwrk/pull/192) by [@danielwestendorf](https://github.com/danielwestendorf)  
 
 ## v0.20.1 — 2026-08-23  
 [Compare](https://github.com/danielwestendorf/specwrk/compare/v0.20.0...v0.20.1)  

data/README.md

@@ -116,6 +116,7 @@ Options:
   --timeout=VALUE, -t VALUE         # The amount of time to wait for the server to respond. Overrides SPECWRK_TIMEOUT, default: "5"
   --network-retries=VALUE           # The number of times to retry in the event of a network failure. Overrides SPECWRK_NETWORK_RETRIES, default: "1"
   --max-retries=VALUE               # Number of times an example will be re-run should it fail, default: 0
+  --target-bucket-timing-duration=VALUE  # Target runtime duration per bucket in seconds, overriding the average timings calculation. Overrides SPECWRK_TARGET_BUCKET_TIMING_DURATION, default: "0"
   --help, -h                        # Print this help
 ```
 
@@ -172,6 +173,9 @@ adjustments to avoid conflicting port usage or database/state mutations.
 
 `specwrk` workers will have `TEST_ENV_NUMBER={i}` set to help you configure approriately.
 
+Workers print `W` without a newline while waiting for outstanding examples to finish. Set
+`SPECWRK_WAITING_OUTPUT=0` to disable this output.
+
 ### Rails
 Rails has had easy multi-process test setup for a while now by creating unique test databases per process. For my rails v7.2 app which uses PostgreSQL and Capybara, I made these changes to my `spec/rails_helper.rb`:
 

data/lib/specwrk/cli.rb

@@ -167,9 +167,10 @@ module Specwrk
 
       desc "Seed the server with a list of specs for the run"
       option :max_retries, default: 0, desc: "Number of times an example will be re-run should it fail"
+      option :target_bucket_timing_duration, default: ENV.fetch("SPECWRK_TARGET_BUCKET_TIMING_DURATION", "0"), desc: "Target runtime duration per bucket in seconds, overriding the average timings calculation. Overrides SPECWRK_TARGET_BUCKET_TIMING_DURATION"
       argument :dir, type: :array, required: false, desc: "Relative spec directory to run against, default: spec/"
 
-      def call(max_retries:, dir:, **args)
+      def call(max_retries:, dir:, target_bucket_timing_duration:, **args)
         dir = ["spec"] if dir.length.zero?
 
         self.class.setup(**args)
@@ -178,10 +179,12 @@ module Specwrk
         require "specwrk/client"
 
         ENV["SPECWRK_SEED"] = "1"
+        target_bucket_timing_duration = Float(target_bucket_timing_duration)
+        ENV["SPECWRK_TARGET_BUCKET_TIMING_DURATION"] = target_bucket_timing_duration.to_s
         examples = ListExamples.new(dir).examples
 
         Client.wait_for_server!
-        Client.new.seed(examples, max_retries)
+        Client.new.seed(examples, max_retries, target_bucket_timing_duration: target_bucket_timing_duration)
         file_count = examples.group_by { |e| e[:file_path] }.keys.size
         puts "🌱 Seeded #{examples.size} examples across #{file_count} files"
       rescue Errno::ECONNREFUSED

data/lib/specwrk/client.rb

@@ -119,8 +119,12 @@ module Specwrk
       end
     end
 
-    def seed(examples, max_retries)
-      response = post "/seed", body: {max_retries: max_retries, examples: examples}.to_json
+    def seed(examples, max_retries, target_bucket_timing_duration: 0)
+      response = post "/seed", body: {
+        max_retries: max_retries,
+        examples: examples,
+        target_bucket_timing_duration: target_bucket_timing_duration
+      }.to_json
 
       (response.code == "200") ? true : raise(UnhandledResponseError.new("#{response.code}: #{response.body}"))
     end

data/lib/specwrk/store/pending_store.rb

@@ -19,6 +19,17 @@ module Specwrk
       @run_time_bucket_maximum ||= self[RUN_TIME_BUCKET_MAXIMUM_KEY]
     end
 
+    def update_run_time_bucket_maximum(calculated_run_time_bucket_maximum, target_bucket_timing_duration: 0)
+      target_bucket_timing_duration = target_bucket_timing_duration.to_f
+
+      if target_bucket_timing_duration.positive?
+        self.run_time_bucket_maximum = target_bucket_timing_duration
+      else
+        run_time_bucket_maximums = [run_time_bucket_maximum, calculated_run_time_bucket_maximum.to_f].compact
+        self.run_time_bucket_maximum = run_time_bucket_maximums.sum.to_f / run_time_bucket_maximums.length.to_f
+      end
+    end
+
     def max_retries=(val)
       @max_retries = self[MAX_RETRIES_KEY] = val
     end

data/lib/specwrk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Specwrk
-  VERSION = "0.20.1"
+  VERSION = "0.20.2"
 end

data/lib/specwrk/web/endpoints/seed.rb

@@ -16,8 +16,10 @@ module Specwrk
 
           pending.max_retries = payload.fetch(:max_retries, "0").to_i
 
-          new_run_time_bucket_maximums = [pending.run_time_bucket_maximum, @seeds_run_time_bucket_maximum.to_f].compact
-          pending.run_time_bucket_maximum = new_run_time_bucket_maximums.sum.to_f / new_run_time_bucket_maximums.length.to_f
+          pending.update_run_time_bucket_maximum(
+            @seeds_run_time_bucket_maximum,
+            target_bucket_timing_duration: payload.fetch(:target_bucket_timing_duration, 0)
+          )
 
           with_lock do
             pending.merge!(examples_with_run_times)

data/lib/specwrk/worker.rb

@@ -40,6 +40,7 @@ module Specwrk
         # Wait for the other processes (workers) on the same host to finish
         # This will cause workers to 'hang' until all work has been completed
         # TODO: break here if all the other worker processes on this host are done executing examples
+        $stdout.printf "W" unless ENV.fetch("SPECWRK_WAITING_OUTPUT", "1") == "0"
         sleep 0.5
       rescue WaitingForSeedError
         @seed_wait_count ||= 0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: specwrk
 version: !ruby/object:Gem::Version
-  version: 0.20.1
+  version: 0.20.2
 platform: ruby
 authors:
 - Daniel Westendorf