runtime_groups 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 14133d120fc0a29b48cf24973d76504d49c6a3063c09b73c494ebe84d245e929
-  data.tar.gz: 2c149b3ed4d6ddd3bad32063d99abcd8263262b41886649b1ad96e1f7ab812a0
+  metadata.gz: 308e171a14eaf92e5a79f1c809a3aa6cc7f3c58ac9deefbf12bfd919820dde04
+  data.tar.gz: f193266281d48f846fe593788bc4390be97411170b98bd8df69d1aca5def82da
 SHA512:
-  metadata.gz: fb3550fb570bef59d0b61b1c8da6647756b7610b6064571462023936678aff347a9ffd285bab4e0bc6eec9a1dd52b5206496f6ed1bc11bf72139724244330ddb
-  data.tar.gz: 62d5525c8e0ccb1f1ad61d5b77e7352673d0cd7e5b32310f2d95a1ee079b928244178edc098a8ae41b1d1b75fbabc9604efa86b9128b5edffbd2a4667ff95245
+  metadata.gz: 39782fe6ad08614d73ec1f7fb83f1eea133a1cbb471b83aa230feb999caba2fce12ff9d995228e412fba02d61bbd09aae34ee5e87a252ab7546021d72f9bfc63
+  data.tar.gz: bad041bff42c81c31bd9320612cce37e656c66a39c92fc681a8aca484e22fe5260ebe020ff1629ca14ea49c4df2164e50f7e7c6bb6417ae461c69d2abe74fc7c

data/CHANGELOG.md

@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [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 +151,9 @@ 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.2...HEAD
+[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.126-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/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.2"
   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.2
 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.2
+  changelog_uri: https://github.com/galtzo-floss/runtime_groups/blob/v0.1.2/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.2
   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