runtime_groups 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14133d120fc0a29b48cf24973d76504d49c6a3063c09b73c494ebe84d245e929
-  data.tar.gz: 2c149b3ed4d6ddd3bad32063d99abcd8263262b41886649b1ad96e1f7ab812a0
+  metadata.gz: fb6eeb7a45ee1a7dae2072cfa6e6d96b03988ce740a97ab00ce69f564b504f95
+  data.tar.gz: ba9764052dd5d0e9ee4987d2e009d7d8ddfd0ec742d4b745cee657c4a7417273
 SHA512:
-  metadata.gz: fb3550fb570bef59d0b61b1c8da6647756b7610b6064571462023936678aff347a9ffd285bab4e0bc6eec9a1dd52b5206496f6ed1bc11bf72139724244330ddb
-  data.tar.gz: 62d5525c8e0ccb1f1ad61d5b77e7352673d0cd7e5b32310f2d95a1ee079b928244178edc098a8ae41b1d1b75fbabc9604efa86b9128b5edffbd2a4667ff95245
+  metadata.gz: 5e83bda062f55d886b6fcd0dbdc0fbc3fe6f6d1ecfc5485904a096f17ea2a66c3674d154d104913c76ae279bf8576afef609fe81c97f181d7f4baa8159fea621
+  data.tar.gz: b33b9766c0390b24146afd41f0bab97450987853a79c4a30b3163032113b8d89dcf2dd33f93ef5850f65fd6c8fb13d4a2e0f1c6fc42b96441b4fce9d2e472f29

data/CHANGELOG.md

@@ -30,6 +30,28 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [0.1.3] - 2026-10-15
+
+- TAG: [v0.1.3][0.1.3t]
+- COVERAGE: 99.22% -- 127/128 lines in 6 files
+- BRANCH COVERAGE: 96.88% -- 31/32 branches in 6 files
+- 93.55% documented
+
+### Fixed
+
+- Pids#to_a tolerates the ledger file vanishing between the existence guard and the read (TOCTOU with concurrent PidFile teardown during worker untracking, seen on truffleruby as Errno::ENOENT mid-suite); returns an empty ledger instead
+
+## [0.1.2] - 2026-10-15
+
+- TAG: [v0.1.2][0.1.2t]
+- COVERAGE: 99.21% -- 125/126 lines in 6 files
+- BRANCH COVERAGE: 96.88% -- 31/32 branches in 6 files
+- 93.55% documented
+
+### Added
+
+- Grouping runtime weights accept unknown_runtime: explicit weight for files missing from the runtime log, instead of the default (average of known runtimes, or 1.0 when nothing is known); parity with parallel_tests' --unknown-runtime, consumed by turbo_tests2's --unknown-runtime flag
+
 ## [0.1.1] - 2026-10-15
 
 - TAG: [v0.1.1][0.1.1t]
@@ -140,7 +162,11 @@ Please file a bug if you notice a violation of semantic versioning.
   legacy manual bundle install path, avoiding setup-time Bundler full-index
   failures against `gem.coop`.
 
-[Unreleased]: https://github.com/galtzo-floss/runtime_groups/compare/v0.1.1...HEAD
+[Unreleased]: https://github.com/galtzo-floss/runtime_groups/compare/v0.1.3...HEAD
+[0.1.3]: https://github.com/galtzo-floss/runtime_groups/compare/v0.1.2...v0.1.3
+[0.1.3t]: https://github.com/galtzo-floss/runtime_groups/releases/tag/v0.1.3
+[0.1.2]: https://github.com/galtzo-floss/runtime_groups/compare/v0.1.1...v0.1.2
+[0.1.2t]: https://github.com/galtzo-floss/runtime_groups/releases/tag/v0.1.2
 [0.1.1]: https://github.com/galtzo-floss/runtime_groups/compare/v0.1.0...v0.1.1
 [0.1.1t]: https://github.com/galtzo-floss/runtime_groups/releases/tag/v0.1.1
 [0.1.0]: https://github.com/galtzo-floss/runtime_groups/compare/e8764d41152b587dbc972e0abe97098794232b36...v0.1.0

data/README.md

@@ -562,7 +562,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.125-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.128-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/galtzo-floss/runtime_groups/blob/main/SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/lib/runtime_groups/grouping.rb

@@ -25,17 +25,20 @@ module RuntimeGroups
     # @param runtime_log [String, nil] runtime log path (for :runtime)
     # @param allowed_missing [Float] fraction of files allowed to be missing
     #   from the runtime log before {RuntimeLogTooSmallError} is raised
+    # @param unknown_runtime [Float, nil] weight for files missing from the
+    #   runtime log; nil (default) uses the average of the known runtimes,
+    #   or 1.0 when nothing is known
     # @return [Hash{String => Float}] file => weight
     # @raise [RuntimeGroups::RuntimeLogTooSmallError] when too many files are
     #   missing from the runtime log
-    def with_size(files, group_by: :runtime, runtime_log: nil, allowed_missing: 1.0)
+    def with_size(files, group_by: :runtime, runtime_log: nil, allowed_missing: 1.0, unknown_runtime: nil)
       case group_by
       when :found
         files.each_with_object({}) { |file, memo| memo[file] = 1.0 }
       when :filesize
         files.each_with_object({}) { |file, memo| memo[file] = File.stat(file).size.to_f }
       when :runtime
-        runtime_weights(files, runtime_log, allowed_missing)
+        runtime_weights(files, runtime_log, allowed_missing, unknown_runtime)
       else
         raise Error, "invalid group-by mode #{group_by.inspect}; expected one of: runtime, filesize, found"
       end
@@ -50,11 +53,19 @@ module RuntimeGroups
     # @param runtime_log [String, nil] runtime log path (for :runtime)
     # @param allowed_missing [Float] fraction of files allowed to be missing
     #   from the runtime log
+    # @param unknown_runtime [Float, nil] weight for files missing from the
+    #   runtime log (nil = average of known, or 1.0 when nothing is known)
     # @return [Array<Array<String>>] exactly `num_groups` arrays of file paths
     # @raise [RuntimeGroups::Error] when num_groups or group_by is invalid
-    def in_groups(files, num_groups, group_by: :runtime, runtime_log: nil, allowed_missing: 1.0)
+    def in_groups(files, num_groups, group_by: :runtime, runtime_log: nil, allowed_missing: 1.0, unknown_runtime: nil)
       groups = Array.new(RuntimeGroups.parse_count!(num_groups)) { {weight: 0.0, files: []} }
-      weights = with_size(files, group_by: group_by, runtime_log: runtime_log, allowed_missing: allowed_missing)
+      weights = with_size(
+        files,
+        group_by: group_by,
+        runtime_log: runtime_log,
+        allowed_missing: allowed_missing,
+        unknown_runtime: unknown_runtime
+      )
 
       files.sort_by { |file| [-weights[file], file] }.each do |file|
         target = groups.min_by { |group| group[:weight] }
@@ -65,11 +76,11 @@ module RuntimeGroups
       groups.map { |group| group[:files] }
     end
 
-    # Runtime weights with the missing-file budget and average-fill semantics
+    # Runtime weights with the missing-file budget and fill semantics
     # retained from `parallel_tests`.
     #
     # @return [Hash{String => Float}]
-    def runtime_weights(files, runtime_log, allowed_missing)
+    def runtime_weights(files, runtime_log, allowed_missing, unknown_runtime = nil)
       budget = files.size * allowed_missing
       runtimes = RuntimeLog.read(runtime_log)
       known, unknown = [], []
@@ -88,7 +99,8 @@ module RuntimeGroups
       end
 
       weights = known.each_with_object({}) { |(file, seconds), memo| memo[file] = seconds }
-      fill = known.empty? ? 1.0 : known.map(&:last).sum / known.size
+      fill = unknown_runtime ||
+        (known.empty? ? 1.0 : known.map(&:last).sum / known.size)
       unknown.each { |file| weights[file] = fill }
       weights
     end

data/lib/runtime_groups/pids.rb

@@ -19,11 +19,19 @@ module RuntimeGroups
     end
 
     # @return [Array<Integer>] the pids currently recorded, deduplicated and
-    #   sorted ascending; empty when the file does not exist yet
+    #   sorted ascending; empty when the file does not exist (or vanishes
+    #   mid-read — a ledger owned by {PidFile.with} is deleted concurrently
+    #   with worker teardown, so the entry guard cannot close that window)
     def to_a
       return [] unless File.file?(@path)
 
-      File.readlines(@path).map do |line|
+      begin
+        lines = File.readlines(@path)
+      rescue Errno::ENOENT
+        return []
+      end
+
+      lines.map do |line|
         begin
           Integer(line.strip, 10)
         rescue ArgumentError

data/lib/runtime_groups/version.rb

@@ -4,7 +4,7 @@ module RuntimeGroups
   # Version namespace for this gem.
   module Version
     # Current gem version.
-    VERSION = "0.1.1"
+    VERSION = "0.1.3"
   end
   # Current gem version exposed at the traditional constant location.
   VERSION = Version::VERSION # Traditional Constant Location

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: runtime_groups
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Peter H. Boling
@@ -284,10 +284,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://github.com/galtzo-floss/runtime_groups
-  source_code_uri: https://github.com/galtzo-floss/runtime_groups/tree/v0.1.1
-  changelog_uri: https://github.com/galtzo-floss/runtime_groups/blob/v0.1.1/CHANGELOG.md
+  source_code_uri: https://github.com/galtzo-floss/runtime_groups/tree/v0.1.3
+  changelog_uri: https://github.com/galtzo-floss/runtime_groups/blob/v0.1.3/CHANGELOG.md
   bug_tracker_uri: https://github.com/galtzo-floss/runtime_groups/issues
-  documentation_uri: https://www.rubydoc.info/gems/runtime_groups/0.1.1
+  documentation_uri: https://www.rubydoc.info/gems/runtime_groups/0.1.3
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/galtzo-floss/runtime_groups/wiki
   news_uri: https://www.railsbling.com/tags/runtime_groups