kettle-soup-cover 3.0.13 → 3.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90690c9f248720624b5d0bbd7a5d91710dd681ee7d15be9abdcac1797ae2246d
-  data.tar.gz: fa74ef675e4e73b41dccac1db3440dbf1f240455403f0392adc009e2d1540b55
+  metadata.gz: 3bb6413d706639bbf337f05ae0194e9eadadc4f1895ce15d957e7acf1cebf3c9
+  data.tar.gz: 43bef6d581344f6362fabfc8288f1bb348faf123b922bb2f159fdc5f28ecec35
 SHA512:
-  metadata.gz: c350fc5d77be2ef8f2f53bed322c2525800bc12fe8392553ecece3a5389063a189cc0f6d65afd4942a25544eb3b6484c203b30dcb3976f12081008ea0391d246
-  data.tar.gz: 2dd280932639bd02c9d17dc91566e6f912f2f621a0e3bcec7f51328b683cd5072e2a6d2ec0ad6ddc8302232484a8a6dae8b8ac65b43c419b54a9f474320f3d89
+  metadata.gz: 0d727362c805584e8325ac03027b9ebfba6a13a051a49eb16a0994bb42dbbb6938caa6e6d63745878b25f31b864f000606372a1dd231310c4222e0c7812eaf59
+  data.tar.gz: 324aa2a82800376f0fa641fcebd758d928c819209d0bc346acf8502f77c5b2c8d4c2dcd3860b79a154687e2980a3a1ce91d9387f807e92f54d0b24656ae07200

data/CHANGELOG.md

@@ -22,6 +22,80 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Changed
 
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+## [3.0.15] - 2026-10-25
+
+- TAG: [v3.0.15][3.0.15t]
+- COVERAGE: 99.67% -- 303/304 lines in 13 files
+- BRANCH COVERAGE: 91.11% -- 82/90 branches in 13 files
+- 20.99% documented
+
+### Added
+
+- `K_SOUP_COV_MIN_STRICT=true` opts into strict coverage criteria, enabling branch and
+  method coverage (and eval coverage where supported) and requiring 100% line, branch,
+  and method coverage when hard minimum enforcement is on.
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 9 project files:
+  - dependencies (9)
+
+- [kc] kettle-jem/template: updated 4 project files:
+  - dependencies (2)
+  - documentation (1)
+  - workflows (1)
+
+### Fixed
+
+- Strict branch, method, and supported eval metrics stay enabled in turbo_tests2 workers
+  even though hard threshold enforcement is disabled there, allowing final collation to
+  enforce the 100% line, branch, and method minimums.
+
+- With `K_SOUP_COV_MIN_HARD=true` and `K_SOUP_COV_MIN_STRICT` unset or false,
+  the SimpleCov config and the turbo_tests2 collation now merge
+  `K_SOUP_COV_MIN_LINE` and `K_SOUP_COV_MIN_BRANCH` into the minimums a
+  project already configured (for example with SimpleCov's `strict` profile
+  in `.simplecov`) instead of replacing them. The higher value wins for each
+  criterion, and criteria kettle-soup-cover does not manage, such as method
+  coverage, are kept. Before, a project's method minimum was silently dropped
+  and its line and branch minimums could be lowered, with no way to restore
+  them after collation.
+
+## [3.0.14] - 2026-10-25
+
+- TAG: [v3.0.14][3.0.14t]
+- COVERAGE: 100.00% -- 282/282 lines in 12 files
+- BRANCH COVERAGE: 91.67% -- 77/84 branches in 12 files
+- 20.00% documented
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 19 project files:
+  - dependencies (19)
+
+- [kc] kettle-jem/template: updated 10 project files:
+  - code and tests (2)
+  - dependencies (2)
+  - documentation (1)
+  - workflows (5)
+
+## [3.0.13] - 2026-10-15
+
+- TAG: [v3.0.13][3.0.13t]
+- COVERAGE: 100.00% -- 282/282 lines in 12 files
+- BRANCH COVERAGE: 91.67% -- 77/84 branches in 12 files
+- 20.00% documented
+
+### Changed
+
 - [kc] kettle-jem/prepare: updated 7 project files:
   - configuration (1)
   - dependencies (6)
@@ -31,14 +105,6 @@ Please file a bug if you notice a violation of semantic versioning.
   - documentation (1)
   - workflows (17)
 
-### Deprecated
-
-### Removed
-
-### Fixed
-
-### Security
-
 ## [3.0.12] - 2026-10-10
 
 - TAG: [v3.0.12][3.0.12t]
@@ -800,7 +866,13 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - Initial release
 
-[Unreleased]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.12...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.15...HEAD
+[3.0.15]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.14...v3.0.15
+[3.0.15t]: https://github.com/kettle-dev/kettle-soup-cover/releases/tag/v3.0.15
+[3.0.14]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.13...v3.0.14
+[3.0.14t]: https://github.com/kettle-dev/kettle-soup-cover/releases/tag/v3.0.14
+[3.0.13]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.12...v3.0.13
+[3.0.13t]: https://github.com/kettle-dev/kettle-soup-cover/releases/tag/v3.0.13
 [3.0.12]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.11...v3.0.12
 [3.0.12t]: https://github.com/kettle-dev/kettle-soup-cover/releases/tag/v3.0.12
 [3.0.11]: https://github.com/kettle-dev/kettle-soup-cover/compare/v3.0.10...v3.0.11

data/README.md

@@ -97,6 +97,7 @@ where this library is considered a package of [SOUP](https://en.wikipedia.org/wi
 
 Compatible with MRI Ruby 3.2.0+, JRuby, and TruffleRuby.
 CI workflows and Appraisals are generated for MRI Ruby 3.2.0+.
+The current MRI CI lane runs on Linux and macOS.
 This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
 may be higher than the gem's runtime compatibility floor when legacy Rubies are
 not practical for the current toolchain.
@@ -120,23 +121,6 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
 
 </details>
 
-### Runtime and Platform Support
-
-Support tiers describe what this project's CI actually exercises, not what may
-work in an untested environment:
-
-- **Parallel support**: CI runs the test suite with multiple workers available.
-- **Unsupported**: the engine/platform combination is not covered by CI and is
- not a project compatibility claim.
-
-| Ruby engine/version | Linux | macOS | Windows | Notes |
-|---------------------|-------|-------|---------|-------|
-| MRI 3.2-3.4 | Parallel support | Unsupported | Unsupported | Versioned Ruby workflows run on Linux. |
-| MRI current | Parallel support | Parallel support | Unsupported | Current Ruby workflow covers the declared OS platforms. |
-| MRI head | Parallel support | Unsupported | Unsupported | CI is allowed to fail while Ruby is in development. |
-| JRuby (all CI lanes) | Parallel support | Unsupported | Unsupported | Engine workflows run on Linux; macOS and Windows are not exercised by CI. |
-| TruffleRuby (all CI lanes) | Parallel support | Unsupported | Unsupported | Never shipped a Windows build (zero Windows assets across 66 releases scanned 2026-10-10); setup-ruby hard-fails ([source](https://github.com/ruby/setup-ruby/blob/master/README.md)) |
-
 ### Federated DVCS
 
 <details markdown="1">
@@ -152,29 +136,12 @@ work in an untested environment:
 
 ### Enterprise Support
 
-[![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-soup-cover)](https://tidelift.com/subscription/pkg/rubygems-kettle-soup-cover?utm_source=rubygems-kettle-soup-cover&utm_medium=referral&utm_campaign=readme)
-
-Available as part of the Tidelift Subscription.
-
-<details markdown="1">
- <summary>Need enterprise-level guarantees?</summary>
-
-The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
-
-[![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]
+For enterprise support from the maintainer, use [Upwork][👨🏼‍🏫expsup-upwork] or [CodeMentor][👨🏼‍🏫expsup-codementor].
 
-- 💡Subscribe for support guarantees covering _all_ your FLOSS dependencies
-- 💡Tidelift is part of [Sonar][🏙️entsup-tidelift-sonar]
-- 💡Tidelift pays maintainers to maintain the software you depend on!<br/>📊`@`Pointy Haired Boss: An [enterprise support][🏙️entsup-tidelift] subscription is "[never gonna let you down][🧮kloc]", and *supports* open source maintainers
-
-Alternatively:
+Other support channels:
 
 - [![Ruby Users Forum][✉️ruby-forum-img]][✉️ruby-forum]
 - [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
-- [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork]
-- [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]
-
-</details>
 
 ## ✨ Installation
 
@@ -630,6 +597,7 @@ See [LICENSE.md][📄license] for the official copyright notice.
 <summary>Copyright holders</summary>
 
 - Copyright (c) 2023-2026 Peter H. Boling
+- Copyright (c) 2026 Erik Berlin
 
 </details>
 
@@ -727,9 +695,6 @@ Thanks for RTFM. ☺️
 [👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
 [👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
 [👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
-[🏙️entsup-tidelift]: https://tidelift.com/subscription/pkg/rubygems-kettle-soup-cover?utm_source=rubygems-kettle-soup-cover&utm_medium=referral&utm_campaign=readme
-[🏙️entsup-tidelift-img]: https://img.shields.io/badge/Tidelift_and_Sonar-Enterprise_Support-FD3456?style=for-the-badge&logo=sonar&logoColor=white
-[🏙️entsup-tidelift-sonar]: https://blog.tidelift.com/tidelift-joins-sonar
 [💁🏼‍♂️peterboling]: http://www.peterboling.com
 [🚂railsbling]: http://www.railsbling.com
 [📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
@@ -819,7 +784,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.282-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.304-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-soup-cover/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
@@ -849,5 +814,5 @@ Thanks for RTFM. ☺️
 | Homepage | https://github.com/kettle-dev/kettle-soup-cover |
 | Source | https://github.com/kettle-dev/kettle-soup-cover |
 | License | `AGPL-3.0-only` |
-| Funding | https://github.com/sponsors/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/kettle-dev, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/kettle-soup-cover, https://www.buymeacoffee.com/pboling |
+| Funding | https://github.com/sponsors/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/kettle-dev, https://thanks.dev/u/gh/pboling, https://www.buymeacoffee.com/pboling |
 <!-- kettle-jem:metadata:end -->

data/lib/kettle/soup/cover/config.rb

@@ -20,6 +20,8 @@ require_relative "constants" unless defined?(Kettle::Soup::Cover::Constants)
 require_relative "loaders" unless defined?(Kettle::Soup::Cover::Loaders)
 require_relative "formatters" unless defined?(Kettle::Soup::Cover) && Kettle::Soup::Cover.respond_to?(:configure_formatters!)
 
+require_relative "coverage_thresholds" unless defined?(Kettle::Soup::Cover::CoverageThresholds)
+
 SimpleCov.configure do
   cover("lib/**/*.rb")
 
@@ -54,12 +56,7 @@ SimpleCov.configure do
   # - If explicitly set to false (K_SOUP_COV_MIN_HARD=false), never enforce minimum coverage
   # - If explicitly set to true (K_SOUP_COV_MIN_HARD=true), always enforce minimum coverage
   # - If not set, defaults to IS_CI (enforce in CI, don't enforce locally)
-  if Kettle::Soup::Cover::Constants::MIN_COVERAGE_HARD
-    minimum_coverage(
-      branch: Kettle::Soup::Cover::Constants::MIN_COVERAGE_BRANCH,
-      line: Kettle::Soup::Cover::Constants::MIN_COVERAGE_LINE
-    )
-  end
+  Kettle::Soup::Cover::CoverageThresholds.configure!(self)
 end
 
 # Clean up stale resultset entries from prior runs before SimpleCov.start.

data/lib/kettle/soup/cover/constants.rb

@@ -76,6 +76,7 @@ module Kettle
         end
         MIN_COVERAGE_BRANCH = ENV_GET.call("MIN_BRANCH", "80").to_i
         MIN_COVERAGE_LINE = ENV_GET.call("MIN_LINE", "80").to_i
+        MIN_COVERAGE_STRICT = ENV_GET.call("MIN_STRICT", Constants::FALSE).casecmp?(Constants::TRUE)
         MULTI_FORMATTERS_DEFAULT = if IS_CI
           Constants::TRUE
         else
@@ -147,6 +148,7 @@ module Kettle
             MERGE_TIMEOUT
             MIN_COVERAGE_BRANCH
             MIN_COVERAGE_LINE
+            MIN_COVERAGE_STRICT
             MIN_COVERAGE_HARD
             MIN_COVERAGE_HARD_REQUESTED
             MULTI_FORMATTERS_DEFAULT

data/lib/kettle/soup/cover/coverage_thresholds.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Kettle
+  module Soup
+    module Cover
+      # Applies the selected SimpleCov minimum coverage policy.
+      module CoverageThresholds
+        module_function
+
+        def configure!(configuration)
+          configure_strict_criteria!(configuration)
+          configure_minimum!(configuration) if Constants::MIN_COVERAGE_HARD
+        end
+
+        def configure_strict_criteria!(configuration)
+          return unless Constants::MIN_COVERAGE_STRICT
+
+          configuration.enable_coverage(:branch)
+          configuration.enable_coverage(:method)
+          if SimpleCov::Configuration.method_defined?(:coverage_for_eval_supported?) &&
+              configuration.coverage_for_eval_supported?
+            configuration.enable_coverage(:eval)
+          end
+        end
+
+        def configure_minimum!(configuration)
+          if Constants::MIN_COVERAGE_STRICT
+            configuration.minimum_coverage(line: 100, branch: 100, method: 100)
+          else
+            # SimpleCov's `minimum_coverage(hash)` replaces the whole minimums
+            # Hash, so merge into the minimums already configured (for example
+            # by the project's .simplecov) instead of dropping or lowering them.
+            configuration.minimum_coverage(
+              merge_minimum_coverage(
+                configuration.minimum_coverage,
+                branch: Constants::MIN_COVERAGE_BRANCH,
+                line: Constants::MIN_COVERAGE_LINE
+              )
+            )
+          end
+        end
+
+        # Merges minimums into minimums that are already configured.
+        #
+        # For each criterion the higher of the two values wins, so a minimum
+        # the project set itself is never lowered. Criteria only `existing`
+        # has, such as method coverage, are kept as they are.
+        #
+        # @param existing [Hash{Symbol => Numeric}] the current minimums, as
+        #   answered by SimpleCov's `minimum_coverage` reader (empty when
+        #   nothing is configured)
+        # @param minimums [Hash{Symbol => Numeric}] the minimums to merge in
+        # @return [Hash{Symbol => Numeric}] a new Hash (`existing` is left unmodified)
+        def merge_minimum_coverage(existing, minimums)
+          existing.merge(minimums) do |_criterion, current, minimum|
+            [current, minimum].compact.max
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kettle/soup/cover/version.rb

@@ -6,7 +6,7 @@ module Kettle
       # Version namespace for this gem.
       module Version
         # Current gem version.
-        VERSION = "3.0.13"
+        VERSION = "3.0.15"
       end
       # Current gem version exposed at the traditional constant location.
       VERSION = Version::VERSION # Traditional Constant Location

data/lib/kettle/soup/cover.rb

@@ -29,6 +29,7 @@ require "stringio"
 require_relative "cover/constants"
 require_relative "cover/loaders"
 require_relative "cover/formatters"
+require_relative "cover/coverage_thresholds"
 require_relative "cover/version"
 
 module Kettle
@@ -105,12 +106,7 @@ module Kettle
 
             Kettle::Soup::Cover.configure_formatters!
 
-            if Constants::MIN_COVERAGE_HARD
-              minimum_coverage(
-                branch: Constants::MIN_COVERAGE_BRANCH,
-                line: Constants::MIN_COVERAGE_LINE
-              )
-            end
+            Kettle::Soup::Cover::CoverageThresholds.configure!(self)
           end
         end
 

metadata

@@ -1,10 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: kettle-soup-cover
 version: !ruby/object:Gem::Version
-  version: 3.0.13
+  version: 3.0.15
 platform: ruby
 authors:
 - Peter H. Boling
+- Erik Berlin
 bindir: exe
 cert_chain:
 - |
@@ -46,7 +47,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.10
+        version: 0.1.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -56,7 +57,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.10
+        version: 0.1.13
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -154,7 +155,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.15
+        version: 1.1.17
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -164,7 +165,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.15
+        version: 1.1.17
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
@@ -174,7 +175,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.13
+        version: 3.1.25
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -184,7 +185,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.13
+        version: 3.1.25
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -248,7 +249,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -258,7 +259,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.5
 - !ruby/object:Gem::Dependency
   name: appraisal2
   requirement: !ruby/object:Gem::Requirement
@@ -268,7 +269,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.5
+        version: 3.2.6
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -278,7 +279,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.5
+        version: 3.2.6
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -288,7 +289,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.25
+        version: 2.0.28
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -298,7 +299,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.25
+        version: 2.0.28
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -392,6 +393,7 @@ files:
 - lib/kettle/soup/cover.rb
 - lib/kettle/soup/cover/config.rb
 - lib/kettle/soup/cover/constants.rb
+- lib/kettle/soup/cover/coverage_thresholds.rb
 - lib/kettle/soup/cover/filters/gt_line_filter.rb
 - lib/kettle/soup/cover/filters/lt_line_filter.rb
 - lib/kettle/soup/cover/formatters.rb
@@ -407,10 +409,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-soup-cover.galtzo.com/
-  source_code_uri: https://github.com/kettle-dev/kettle-soup-cover/tree/v3.0.13
-  changelog_uri: https://github.com/kettle-dev/kettle-soup-cover/blob/v3.0.13/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-soup-cover/tree/v3.0.15
+  changelog_uri: https://github.com/kettle-dev/kettle-soup-cover/blob/v3.0.15/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-soup-cover/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-soup-cover/3.0.13
+  documentation_uri: https://www.rubydoc.info/gems/kettle-soup-cover/3.0.15
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-soup-cover/wiki
   news_uri: https://www.railsbling.com/tags/kettle-soup-cover