specwrk 0.21.4 → 0.22.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 794dba7b09d0dcf664f9188a6c79274cd7dcaa7eb513cf002c6f610cc110313a
-  data.tar.gz: cc8e64d775de00bb49eb90f18de7a87f55a62b7b043fb95545b8151e6e0484b6
+  metadata.gz: 1a13b3c3e70f9d783a12f5234fb6d4b1d8c1b1d88f51d9697f577af787992af7
+  data.tar.gz: def9c56c399edf73caf06a8f6c35a66cca2edc78469011b9c590be024a0dbdfa
 SHA512:
-  metadata.gz: c98f4269ee9bdea9a2798d1b98474c430569f656eefe8b30f573f0a221e7e39258bad53904ce2c9994ab0064fdf27c3e0b0b022cfd114297fc0b1325a2b6ba66
-  data.tar.gz: feef8c77b996f164ee491630efe426e3735b6f72616df6ac881af4c21e6ecc796aa0990c405e4060990d1b6e479dffc2f0c8079a2641d4e1ff94ccc2c5ef2bcd
+  metadata.gz: 60533ae109485af8cc632937362e5e03407790ba6bcd985b403811c8183d0e77cbfdcf730f68f1871e3562b02bffb519be733d2f64965b64634b531864adf69a
+  data.tar.gz: 2dd7c656477fe49b58e4ff7ef8b0c74c71ff527e8f0894043861fc8db5b6a4d7ccc0354b69e69c0463e1c5c5e03a7f1392105284fb7297794a251cf97abe0105

data/CHANGELOG.md

@@ -1,7 +1,15 @@
 # Changelog
 
 ## Unreleased
-[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.21.4...main)
+[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.22.1...main)
+
+## v0.22.1 — 2026-11-12
+[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.22.0...v0.22.1)
+- Distinguish seeded runs from runs awaiting their first seed and correct worker status while waiting for work — [#205](https://github.com/danielwestendorf/specwrk/pull/205) by [@danielwestendorf](https://github.com/danielwestendorf)
+
+## v0.22.0 — 2026-11-02
+[Compare](https://github.com/danielwestendorf/specwrk/compare/v0.21.4...v0.22.0)
+- Add an `after_start_complete` lifecycle hook — [#201](https://github.com/danielwestendorf/specwrk/pull/201) by [@danielwestendorf](https://github.com/danielwestendorf)
 
 ## v0.21.4 — 2026-10-12
 [Compare](https://github.com/danielwestendorf/specwrk/compare/v0.21.3...v0.21.4)

data/LICENSE

@@ -1,5 +1,6 @@
 Copyright (c) Daniel Westendorf
 
 Specwrk is an Open Source project licensed under the terms of
-the LGPLv3 license.  Please see <http://www.gnu.org/licenses/lgpl-3.0.html>
+the GNU General Public License, version 3 or (at your option) any later
+version (GPL-3.0-or-later). Please see <https://www.gnu.org/licenses/gpl-3.0.html>
 for license text.

data/README.md

@@ -189,6 +189,7 @@ The hooks file is ordinary Ruby and is loaded into the parent, server, seed, and
 | `Specwrk.after_worker_examples_execute(&blk)` | Runs in a worker after an examples group is executed by the RSpec runner | `examples` RSpec examples in the group |
 | `Specwrk.before_worker_exit(&blk)` | Runs in each worker after work completes and before the process exits | `status` Worker exit status |
 | `Specwrk.after_all_workers_exit(&blk)` | Runs in the parent process after all workers exit | `status` Overall worker exit status |
+| `Specwrk.after_start_complete(&blk)` | Runs in the parent process after `specwrk start` finishes reporting and its server and child processes have exited | `status` Final command exit status |
 
 Response compression is negotiated automatically by HTTP clients and the queue server. Request compression is disabled by default; enable it with `--http-compression` or `SPECWRK_HTTP_COMPRESSION=1` on client commands to gzip seed data and worker results that are at least 1 KiB. Set `SPECWRK_HTTP_COMPRESSION_MINIMUM_SIZE` to change this byte threshold. Upgrade the queue server before enabling request compression because it does not fall back when a server cannot decode gzip.
 
@@ -325,4 +326,4 @@ Maintainers can follow [RELEASING.md](RELEASING.md) to publish the gem and Docke
 
 ## License
 
-The gem is available as open source under the terms of the [LGPLv3 License](http://www.gnu.org/licenses/lgpl-3.0.html).
+The gem is available as open source under the terms of the [GNU General Public License, version 3 or (at your option) any later version](https://www.gnu.org/licenses/gpl-3.0.html) (`GPL-3.0-or-later`).

data/Specwrk.hooks.rb

@@ -66,3 +66,7 @@
 # Specwrk.after_all_workers_exit do |status|
 #   specwrk_hook_log.call("after_all_workers_exit", status: status)
 # end
+#
+# Specwrk.after_start_complete do |status|
+#   specwrk_hook_log.call("after_start_complete", status: status)
+# end

data/lib/specwrk/cli.rb

@@ -353,6 +353,7 @@ module Specwrk
         status = Specwrk::CLIReporter.new.report
 
         Specwrk.wait_for_pids_exit([web_pid, seed_pid])
+        Hooks.run(:after_start_complete, status)
         exit(status)
       end
 

data/lib/specwrk/store/pending_store.rb

@@ -107,6 +107,11 @@ module Specwrk
       bucket_ids.length
     end
 
+    def empty?
+      # The backing store retains configuration even when no work remains.
+      bucket_ids.empty?
+    end
+
     private
 
     def write_bucket(examples)

data/lib/specwrk/version.rb

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

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

@@ -132,11 +132,15 @@ module Specwrk
         end
 
         def worker_status
-          return 0 if worker[:failed].nil? && completed.any? # worker starts after run has completed
+          return 0 if worker[:failed].nil? && seeded?
 
           worker[:failed] || 1
         end
 
+        def seeded?
+          !pending[PendingStore::MAX_RETRIES_KEY].nil?
+        end
+
         def worker_store_for(id)
           WorkerStore.new(ENV.fetch("SPECWRK_SRV_STORE_URI", "memory:///"), File.join(run_id, "workers", id))
         end

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

@@ -11,7 +11,7 @@ module Specwrk
         def with_pop_response
           if examples.any?
             [200, {"content-type" => "application/json"}, [JSON.generate(examples)]]
-          elsif pending.empty? && processing.empty? && completed.empty?
+          elsif !seeded?
             [204, {}, []]
           elsif completed.any? && processing.empty?
             [410, {"content-type" => "text/plain"}, ["That's a good lad. Run along now and go home."]]

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

@@ -15,8 +15,6 @@ module Specwrk
           failure_counts.clear
           completed.clear
 
-          pending.max_retries = payload.fetch(:max_retries, "0").to_i
-
           metadata.delete("report_json")
 
           pending.update_run_time_bucket_maximum(
@@ -26,6 +24,8 @@ module Specwrk
 
           with_lock do
             pending.merge!(examples_with_run_times)
+            # Publish the seed marker only after all pending work has been stored.
+            pending.max_retries = payload.fetch(:max_retries, "0").to_i
           end
 
           Hooks.run(:after_server_seed, payload[:examples])

data/lib/specwrk.rb

@@ -60,6 +60,10 @@ module Specwrk
       Hooks.register(:after_all_workers_exit, &block)
     end
 
+    def after_start_complete(&block)
+      Hooks.register(:after_start_complete, &block)
+    end
+
     def wait_for_pids_exit(pids)
       exited_pids = {}
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: specwrk
 version: !ruby/object:Gem::Version
-  version: 0.21.4
+  version: 0.22.1
 platform: ruby
 authors:
 - Daniel Westendorf
@@ -277,7 +277,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Parallel rspec test runner from a queue of pending jobs.
 test_files: []