kettle-rb 0.1.18 → 0.1.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 638c9c41bd338ec9c02c5b28242455a9363ffc074c9eea27d56b80f52bd3ef45
-  data.tar.gz: dc85a325a0656c0758f2b28c43f6ffc6d08f617a3158d3d19893f8ef9734645d
+  metadata.gz: 04d9d8008b83d76e859f51940db356e205ec35148ef41cdddea34546f38e55a1
+  data.tar.gz: 2c90edff594720214534f2b6a0fbec46ca666b221224f899317e8ea4ae41f8fc
 SHA512:
-  metadata.gz: ff3a5080c2909dd76134ca64888d976b6de43c7266df8b98b90035adb587a72bd4029fb28c19d6c051ce97e515784e08bc458374b166f67d292bcf3a6eaf6bae
-  data.tar.gz: d48a0590cd5c61339ff4f99a7b973f1dab67338b2b88dc8512c2d2b002a77f4c4a780487091c8a2f885bb36df7ca4428c69ccf444eb1bd9f86ba6adf9870f4e0
+  metadata.gz: ff086713cf25198ba186051ebc52f6234a1ca8812664caf38d70bb9cebd584dcf17ec540a20dbaef585740c5c4b58c7ba21e1f22c21a9f475b1bc385495fd490
+  data.tar.gz: 4555a3e90848db1eef3621b3a7ac5b1030973fddf82ad5e58346527ba842cf40adb43a163a74330c8b3dd2933f873af769c8658b8aee401314401fc987d4bd62

data/CHANGELOG.md

@@ -30,6 +30,41 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [0.1.20] - 2026-10-25
+
+- TAG: [v0.1.20][0.1.20t]
+- COVERAGE: 100.00% -- 421/421 lines in 11 files
+- BRANCH COVERAGE: 98.15% -- 53/54 branches in 11 files
+- 63.08% documented
+
+### Changed
+
+- [kc] kettle-jem/template: updated 1 project file:
+  - code and tests (1)
+
+## [0.1.19] - 2026-10-25
+
+- TAG: [v0.1.19][0.1.19t]
+- COVERAGE: 100.00% -- 421/421 lines in 11 files
+- BRANCH COVERAGE: 98.15% -- 53/54 branches in 11 files
+- 63.08% documented
+
+### Added
+
+- Shared Ruby series bucket range calculation for compatibility matrices and template curation.
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 25 project files:
+  - dependencies (25)
+
+- [kc] kettle-jem/template: updated 13 project files:
+  - code and tests (2)
+  - dependencies (2)
+  - documentation (1)
+  - other (1)
+  - workflows (7)
+
 ## [0.1.18] - 2026-10-15
 
 - TAG: [v0.1.18][0.1.18t]
@@ -382,7 +417,11 @@ Please file a bug if you notice a violation of semantic versioning.
 - Add `Kettle::Rb::CompatMatrix` as the shared Ruby, engine, Rails, RuboCop,
   and RuboCop LTS compatibility source of truth for kettle-dev tooling.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-rb/compare/v0.1.18...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-rb/compare/v0.1.20...HEAD
+[0.1.20]: https://github.com/kettle-dev/kettle-rb/compare/v0.1.19...v0.1.20
+[0.1.20t]: https://github.com/kettle-dev/kettle-rb/releases/tag/v0.1.20
+[0.1.19]: https://github.com/kettle-dev/kettle-rb/compare/v0.1.18...v0.1.19
+[0.1.19t]: https://github.com/kettle-dev/kettle-rb/releases/tag/v0.1.19
 [0.1.18]: https://github.com/kettle-dev/kettle-rb/compare/v0.1.17...v0.1.18
 [0.1.18t]: https://github.com/kettle-dev/kettle-rb/releases/tag/v0.1.18
 [0.1.17]: https://github.com/kettle-dev/kettle-rb/compare/v0.1.15...v0.1.17

data/README.md

@@ -73,6 +73,7 @@ Use it when tooling needs to answer questions like:
 
 Compatible with MRI Ruby 1.8.7+, JRuby, and TruffleRuby.
 CI workflows and Appraisals are generated for MRI Ruby 2.4.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.
@@ -97,23 +98,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.1-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">
@@ -129,29 +113,12 @@ work in an untested environment:
 
 ### Enterprise Support
 
-[![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-rb)](https://tidelift.com/subscription/pkg/rubygems-kettle-rb?utm_source=rubygems-kettle-rb&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.
+For enterprise support from the maintainer, use [Upwork][👨🏼‍🏫expsup-upwork] or [CodeMentor][👨🏼‍🏫expsup-codementor].
 
-[![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]
-
-- 💡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
 
@@ -277,19 +244,18 @@ We welcome both individual and corporate sponsors! We also offer a
 wide array of funding channels to account for your preferences.
 Currently, [Open Collective][🖇osc] is our preferred funding platform.
 
+### Corporate Sponsorship
+
 **If you're working in a company that's making significant use of kettle-dev tools we'd
 appreciate it if you suggest to your company to become a kettle-dev sponsor.**
 
+### Individual Support
+
 You can support the development of kettle-dev tools via
 [GitHub Sponsors][🖇sponsor],
 [Liberapay][⛳liberapay],
-[PayPal][🖇paypal],
-[Open Collective][🖇osc]
-and [Tidelift][🏙️entsup-tidelift].
-
-| 📍 NOTE |
-|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| If doing a sponsorship in the form of donation is problematic for your company <br/> from an accounting standpoint, we'd recommend the use of Tidelift, <br/> where you can get a support-like subscription instead. |
+[Open Collective][🖇osc],
+and [PayPal][🖇paypal].
 
 ### Open Collective for Individuals
 
@@ -504,9 +470,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-rb?utm_source=rubygems-kettle-rb&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
@@ -626,7 +589,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.362-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.421-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-rb/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
@@ -656,5 +619,5 @@ Thanks for RTFM. ☺️
 | Homepage | https://github.com/kettle-dev/kettle-rb |
 | Source | https://github.com/kettle-dev/kettle-rb |
 | License | `MIT` |
-| 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-rb, 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/rb/ruby_series_buckets.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require "rubygems"
+require "set"
+require "kettle/rb/compat_matrix"
+
+module Kettle
+  module Rb
+    # Converts between Ruby minor-version seams and the folder buckets used by
+    # modular Gemfile matrices. A major-only bucket (rN) is the catch-all for
+    # the newest range in that major; rN.M buckets cover the earlier range
+    # ending at M.
+    module RubySeriesBuckets
+      module_function
+
+      # Builds buckets and their Ruby ranges from the seam versions that define
+      # the matrix. This is the shared implementation used by appraisal matrix
+      # generation and by template curation.
+      #
+      # @param minor_versions [Array<String, Gem::Version>]
+      # @return [Hash] bucket names and floor/ceiling ranges
+      def from_minor_versions(minor_versions)
+        by_major = Array(minor_versions).each_with_object({}) do |minor, grouped|
+          version = Gem::Version.new(minor.to_s)
+          major = version.segments[0]
+          grouped[major] ||= []
+          grouped[major] << version
+        end
+
+        buckets = []
+        ranges = {}
+        by_major.each do |major, versions|
+          sorted = versions.uniq.sort
+          sorted.each_with_index do |version, index|
+            if index == sorted.length - 1
+              bucket = "r#{major}"
+              buckets << bucket
+              ranges[bucket] = {:floor => version, :ceiling => Gem::Version.new("#{major}.99")}
+              next
+            end
+
+            next_version = sorted[index + 1]
+            upper = [next_version.segments[1].to_i - 1, version.segments[1].to_i].max
+            bucket = "r#{major}.#{upper}"
+            buckets << bucket
+            ranges[bucket] = {
+              :floor => version,
+              :ceiling => Gem::Version.new("#{major}.#{upper}")
+            }
+          end
+        end
+
+        {:buckets => buckets.uniq, :bucket_ranges => ranges}
+      end
+
+      # Reconstructs the canonical ranges from the complete set of bucket
+      # folder names. Named buckets are upper bounds; the major-only bucket
+      # catches the remaining versions in that major.
+      #
+      # @param buckets [Array<String>] folder names such as r2.4, r2.6, r2
+      # @return [Hash{String => Hash}] ranges keyed by bucket name
+      def ranges_for_buckets(buckets)
+        parsed = Array(buckets).map { |bucket|
+          match = bucket.to_s.match(/\Ar(\d+)(?:\.(\d+))?\z/)
+          [match[1].to_i, match[2] && match[2].to_i, bucket.to_s] if match
+        }.compact
+        parsed.group_by(&:first).each_with_object({}) do |(major, entries), result|
+          named = entries.select { |_major, minor, _bucket| minor }.sort_by { |_major, minor, _bucket| minor }
+          seams = [minimum_ruby_for_major(major)]
+          named.each do |_entry_major, minor, _bucket|
+            seams << Gem::Version.new("#{major}.#{minor + 1}")
+          end
+          seams.uniq!
+          generated = from_minor_versions(seams)
+          requested = entries.map(&:last).to_set
+          generated.fetch(:bucket_ranges).each do |bucket, range|
+            result[bucket] = range if requested.include?(bucket)
+          end
+        end
+      end
+
+      # Keeps every bucket whose Ruby range intersects the destination's
+      # supported Ruby versions (all versions at or above +:minimum+).
+      # Takes an options hash rather than a required keyword so the file parses
+      # on every Ruby the gem supports.
+      def relevant_buckets(buckets, options = {})
+        floor = Gem::Version.new(options.fetch(:minimum).to_s)
+        ranges = ranges_for_buckets(buckets)
+        ranges.map { |bucket, range| bucket if range.fetch(:ceiling) >= floor }
+          .compact
+          .sort_by { |bucket| bucket_sort_key(bucket) }
+      end
+
+      def minimum_ruby_for_major(major)
+        versions = CompatMatrix.entries.map { |key, _entry|
+          match = key.match(/\Aruby-(\d+)\.(\d+)\z/)
+          Gem::Version.new("#{match[1]}.#{match[2]}") if match && match[1].to_i == major
+        }.compact
+        versions.min || Gem::Version.new("#{major}.0")
+      end
+      private_class_method :minimum_ruby_for_major
+
+      def bucket_sort_key(bucket)
+        match = bucket.match(/\Ar(\d+)(?:\.(\d+))?\z/)
+        [match[1].to_i, match[2] ? match[2].to_i : 999]
+      end
+      private_class_method :bucket_sort_key
+    end
+  end
+end

data/lib/kettle/rb/version.rb

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

data/lib/kettle/rb.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "rb/compat_matrix"
+require_relative "rb/ruby_series_buckets"
 require_relative "rb/gem_floors"
 require_relative "rb/gem_dependencies"
 require_relative "rb/platform_support"

data/sig/kettle/rb.rbs

@@ -5,5 +5,11 @@ module Kettle
       VERSION: String
     end
     VERSION: String
+
+    module RubySeriesBuckets
+      def self.from_minor_versions: (Array[String | Gem::Version]) -> { buckets: Array[String], bucket_ranges: Hash[String, { floor: Gem::Version, ceiling: Gem::Version }] }
+      def self.ranges_for_buckets: (Array[String]) -> Hash[String, { floor: Gem::Version, ceiling: Gem::Version }]
+      def self.relevant_buckets: (Array[String], minimum: String | Gem::Version) -> Array[String]
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.18
+  version: 0.1.20
 platform: ruby
 authors:
 - Peter H. Boling
@@ -46,7 +46,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.13
+        version: 3.1.24
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -56,7 +56,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.13
+        version: 3.1.24
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -114,7 +114,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -124,7 +124,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.4
 - !ruby/object:Gem::Dependency
   name: appraisal2
   requirement: !ruby/object:Gem::Requirement
@@ -134,7 +134,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
@@ -144,7 +144,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
@@ -154,7 +154,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.25
+        version: 2.0.27
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -164,7 +164,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.25
+        version: 2.0.27
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -259,6 +259,7 @@ files:
 - lib/kettle/rb/platform_support.rb
 - lib/kettle/rb/platform_support/data.rb
 - lib/kettle/rb/platform_support/generator.rb
+- lib/kettle/rb/ruby_series_buckets.rb
 - lib/kettle/rb/version.rb
 - sig/kettle/rb.rbs
 homepage: https://github.com/kettle-dev/kettle-rb
@@ -266,10 +267,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-rb.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-rb/tree/v0.1.18
-  changelog_uri: https://github.com/kettle-dev/kettle-rb/blob/v0.1.18/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-rb/tree/v0.1.20
+  changelog_uri: https://github.com/kettle-dev/kettle-rb/blob/v0.1.20/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-rb/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-rb/0.1.18
+  documentation_uri: https://www.rubydoc.info/gems/kettle-rb/0.1.20
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-rb/wiki
   news_uri: https://www.railsbling.com/tags/kettle-rb