kettle-dev 1.1.21 → 1.1.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bda29e9327b5714faa682451c88597ff3a96811155b2876d1db37fe374edc54f
-  data.tar.gz: af0eb8bfe6afdcb896b993fb6fa59d50be21ce047b6fd2e1d34281ad6bcced17
+  metadata.gz: beaae4a405c9356c0b987d0e6c44bbfa914e41a222bf4c249b3dd69948bda155
+  data.tar.gz: 6d38fc925464a056dce98e605a3c6221405434815f0983dbcc72281a911a876c
 SHA512:
-  metadata.gz: 9f76db200b74e6a1438ba735fe81268a674634e327ccb9b74e04645e0305d859c7be166eba1e60f2dec922a0c19697347f49df1a08d4c3e2f5f9d9346aa9f3bc
-  data.tar.gz: 55e4f6763438a9389029843500e5fe5bf6f59954c609899c36673fdc9d9e142c3711b43deaafedd3bc672b0d36bf0e52f5b5f20339d114a557ecd355ae63edcf
+  metadata.gz: fd71a3030195bb3700d3bbb88a0b6ad654ad1c035b5e9307b13d1a267a83da0ef0ea2bd7ff03c86c5b6abeeddeb591b8e4248bded39663ab3799ce1457051fa3
+  data.tar.gz: 9471913ce78cdaae3d988ab526918938084a88381ea555406bf7274f54ee9c822a068a4ae1e5ccb638d29038e2134059933fcaff8eaa6b853a9beaf23b907218

data/.github/workflows/ancient.yml

@@ -13,11 +13,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/ancient.yml.example

@@ -13,11 +13,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/coverage.yml

@@ -25,11 +25,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/coverage.yml.example

@@ -24,11 +24,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/current.yml

@@ -17,11 +17,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 
@@ -50,15 +45,14 @@ jobs:
             rubygems: latest
             bundler: latest
 
-          # truffleruby-24.1
-          #   (according to documentation: targets Ruby 3.3 compatibility)
-          #   (according to runtime: targets Ruby 3.2 compatibility)
-          - ruby: "truffleruby"
-            appraisal: "current"
-            exec_cmd: "rake test"
-            gemfile: "Appraisal.root"
-            rubygems: default
-            bundler: default
+# Turn back on once allow-failures is a feature of GHA.
+#          # truffleruby-24.1 (targets Ruby 3.3 compatibility)
+#          - ruby: "truffleruby"
+#            appraisal: "current"
+#            exec_cmd: "rake test"
+#            gemfile: "Appraisal.root"
+#            rubygems: default
+#            bundler: default
 
           # jruby-10.0 (targets Ruby 3.4 compatibility)
           - ruby: "jruby"

data/.github/workflows/current.yml.example

@@ -0,0 +1,89 @@
+# Targets the evergreen latest release of ruby, truffleruby, and jruby
+name: Current
+
+permissions:
+  contents: read
+
+env:
+  K_SOUP_COV_DO: false
+
+on:
+  push:
+    branches:
+      - 'main'
+      - '*-stable'
+    tags:
+      - '!*' # Do not execute on tags
+  pull_request:
+    branches:
+      - '*'
+  # Allow manually triggering the workflow.
+  workflow_dispatch:
+
+# Cancels all previous workflow runs for the same branch that have not yet completed.
+concurrency:
+  # The concurrency group contains the workflow name and the branch name.
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  test:
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
+    name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}
+    runs-on: ubuntu-latest
+    continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
+    env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
+      BUNDLE_GEMFILE: ${{ github.workspace }}/${{ matrix.gemfile }}.gemfile
+    strategy:
+      matrix:
+        include:
+          # Ruby 3.4
+          - ruby: "ruby"
+            appraisal: "current"
+            exec_cmd: "rake test"
+            gemfile: "Appraisal.root"
+            rubygems: latest
+            bundler: latest
+
+          # truffleruby-24.1 (targets Ruby 3.3 compatibility)
+          - ruby: "truffleruby"
+            appraisal: "current"
+            exec_cmd: "rake test"
+            gemfile: "Appraisal.root"
+            rubygems: default
+            bundler: default
+
+          # jruby-10.0 (targets Ruby 3.4 compatibility)
+          - ruby: "jruby"
+            appraisal: "current"
+            exec_cmd: "rake test"
+            gemfile: "Appraisal.root"
+            rubygems: default
+            bundler: default
+
+    steps:
+      - name: Checkout
+        if: ${{ !(env.ACT && startsWith(matrix.ruby, 'jruby')) }}
+        uses: actions/checkout@v5
+
+      - name: Setup Ruby & RubyGems
+        if: ${{ !(env.ACT && startsWith(matrix.ruby, 'jruby')) }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          rubygems: ${{ matrix.rubygems }}
+          bundler: ${{ matrix.bundler }}
+          bundler-cache: false
+
+      # Raw `bundle` will use the BUNDLE_GEMFILE set to matrix.gemfile (i.e. Appraisal.root)
+      # We need to do this first to get appraisal installed.
+      # NOTE: This does not use the primary Gemfile at all.
+      - name: Install Root Appraisal
+        if: ${{ !(env.ACT && startsWith(matrix.ruby, 'jruby')) }}
+        run: bundle
+      - name: Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}
+        if: ${{ !(env.ACT && startsWith(matrix.ruby, 'jruby')) }}
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle
+      - name: Tests for ${{ matrix.ruby }}@${{ matrix.appraisal }} via ${{ matrix.exec_cmd }}
+        if: ${{ !(env.ACT && startsWith(matrix.ruby, 'jruby')) }}
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle exec ${{ matrix.exec_cmd }}

data/.github/workflows/dep-heads.yml

@@ -18,11 +18,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/heads.yml

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/heads.yml.example

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/jruby.yml

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/jruby.yml.example

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/legacy.yml

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/license-eye.yml

@@ -13,11 +13,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/locked_deps.yml

@@ -43,11 +43,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/style.yml

@@ -13,11 +13,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/supported.yml

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/truffle.yml

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/unlocked_deps.yml

@@ -33,11 +33,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.github/workflows/unsupported.yml

@@ -16,11 +16,6 @@ on:
   pull_request:
     branches:
       - '*'
-  # security - only use workflows from the canonical branches
-  pull_request_target:
-    branches:
-      - 'main'
-      - '*-stable'
   # Allow manually triggering the workflow.
   workflow_dispatch:
 

data/.junie/guidelines.md

@@ -12,7 +12,8 @@ This document captures project-specific knowledge to streamline setup, testing,
     - See .env.local.example for an example of what to put in .env.local.
     - See CONTRIBUTING.md for details on how to set up your local environment.
 - Ruby and Bundler
-  - Runtime supports very old Rubies (>= 1.9.2) but development tooling targets >= 2.3 because of CI/setup-ruby and dev dependencies.
+  - Runtime supports Ruby >= 1.9.2.
+  - Development tooling targets Ruby >= 2.3 (minimum supported by setup-ruby GHA).
   - Use a recent Ruby (>= 3.4 recommended) for fastest setup and to exercise modern coverage behavior.
   - Install dependencies via Bundler in project root:
     - bundle install
@@ -89,7 +90,7 @@ This document captures project-specific knowledge to streamline setup, testing,
   - Place new specs under spec/ mirroring lib/ structure where possible. Do not require "spec_helper" at the top of spec files, as it is automatically loaded by .rspec.
   - If your code relies on environment variables that drive activation (see "Activation env vars" below), prefer using rspec-stubbed_env:
     - it does not support stubbing with blocks, but it does automatically clean up after itself.
-    - outside the example:
+    - the below config is included in all spec scenarios by the kettle-test gem, so no need to do it again; it is here for reference:
       include_context 'with stubbed env'
     - in a before hook, or in an example:
       stub_env("FLOSS_FUNDING_MY_NS" => "Free-as-in-beer")
@@ -133,6 +134,7 @@ Notes
 - Coverage reports: NEVER review the HTML report. Use JSON (preferred), XML, LCOV, or RCOV. For this project, always run tests with K_SOUP_COV_FORMATTERS set to "json".
 - Do NOT modify .envrc in tasks; when running tests locally or in scripts, manually prefix each run, e.g.: K_SOUP_COV_FORMATTERS="json" bin/rspec
 - For all the kettle-soup-cover options, see .envrc and find the K_SOUP_COV_* env vars.
+- NEVER modify ENV variables in tests directly. Always use the stub_env macro from the rspec-stubbed_env gem (more details in the testing section above).
 
 Important documentation rules
 - Do NOT edit files under docs/ manually; they are generated by `bundle exec rake yard` as part of the default rake task.

data/CHANGELOG.md

@@ -20,16 +20,46 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Added
 
+- Replace template tokens with real minimum ruby versions for runtime and development
+
 ### Changed
 
+- consolidated specs
+
 ### Deprecated
 
 ### Removed
 
 ### Fixed
 
+- Leaky state in specs
+
 ### Security
 
+## [1.1.23] - 2025-09-16
+
+- TAG: [v1.1.23][1.1.23t]
+- COVERAGE: 96.71% -- 3673/3798 lines in 26 files
+- BRANCH COVERAGE: 81.57% -- 1509/1850 branches in 26 files
+- 77.97% documented
+
+### Fixed
+
+- GemSpecReader, ReadmeBackers now use shared OpenCollectiveConfig
+  - fixes broken opencollective config handling in GemSPecReader
+
+## [1.1.22] - 2025-09-16
+
+- TAG: [v1.1.22][1.1.22t]
+- COVERAGE: 96.83% -- 3661/3781 lines in 25 files
+- BRANCH COVERAGE: 81.70% -- 1505/1842 branches in 25 files
+- 77.01% documented
+
+### Changed
+
+- Revert "🔒️ Use pull_request_target in workflows"
+  - It's not relevant to my projects (either this gem or the ones templated)
+
 ## [1.1.21] - 2025-09-16
 
 - TAG: [v1.1.21][1.1.21t]
@@ -925,7 +955,11 @@ Please file a bug if you notice a violation of semantic versioning.
   - Selecting will run the selected workflow via `act`
   - This may move to its own gem in the future.
 
-[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.21...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.23...HEAD
+[1.1.23]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.22...v1.1.23
+[1.1.23t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.23
+[1.1.22]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.21...v1.1.22
+[1.1.22t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.22
 [1.1.21]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.20...v1.1.21
 [1.1.21t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.21
 [1.1.20]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.19...v1.1.20

data/README.md

@@ -916,7 +916,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-3.781-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.798-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: 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/README.md.example

@@ -41,7 +41,7 @@
 
 ### Compatibility
 
-Compatible with MRI Ruby 2.3+, and concordant releases of JRuby, and TruffleRuby.
+Compatible with MRI Ruby {K_D_MIN_RUBY}+, and concordant releases of JRuby, and TruffleRuby.
 
 | 🚚 _Amazing_ test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚             |
 |------------------------------------------------|--------------------------------------------------------|
@@ -513,7 +513,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-3.781-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.798-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: 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/Rakefile.example

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# kettle-dev Rakefile v1.1.21 - 2025-09-16
+# kettle-dev Rakefile v1.1.23 - 2025-09-16
 # Ruby 2.3 (Safe Navigation) or higher required
 #
 # MIT License (see License.txt)

data/kettle-dev.gemspec.example

@@ -105,12 +105,11 @@ Gem::Specification.new do |spec|
   #       visibility and discoverability on RubyGems.org.
   #       However, development dependencies in gemspec will install on
   #       all versions of Ruby that will run in CI.
-  #       This gem, and its gemspec runtime dependencies, will install on Ruby down to 2.3.x.
-  #       This gem, and its gemspec development dependencies, will install on Ruby down to 2.3.x.
-  #       This is because in CI easy installation of Ruby, via setup-ruby, is for >= 2.3.
+  #       This gem, and its gemspec runtime dependencies, will install on Ruby down to {K_D_MIN_RUBY}.x.
+  #       This gem, and its gemspec development dependencies, will install on Ruby down to {K_D_MIN_DEV_RUBY}.x.
   #       Thus, dev dependencies in gemspec must have
   #
-  #       required_ruby_version ">= 2.3" (or lower)
+  #       required_ruby_version ">= {K_D_MIN_DEV_RUBY}" (or lower)
   #
   #       Development dependencies that require strictly newer Ruby versions should be in a "gemfile",
   #       and preferably a modular one (see gemfiles/modular/*.gemfile).

data/lib/kettle/dev/gem_spec_reader.rb

@@ -97,40 +97,37 @@ module Kettle
           entrypoint_require = gem_name.to_s.tr("-", "/")
           gem_shield = gem_name.to_s.gsub("-", "--").gsub("_", "__")
 
-          # Funding org detection with bypass support.
-          # By default a funding org must be discoverable, unless explicitly disabled by ENV['FUNDING_ORG'] == 'false'.
-          funding_org_env = ENV["FUNDING_ORG"]
-          funding_org = funding_org_env.to_s.strip
+          # Funding org (Open Collective handle) detection.
+          # Precedence:
+          #   1) ENV["FUNDING_ORG"] when set:
+          #        - value "false" (any case) disables funding (nil)
+          #        - otherwise use the value verbatim
+          #   2) OpenCollectiveConfig.handle(required: false)
+          # Be lenient: allow nil when not discoverable, with a concise warning.
           begin
-            # Handle bypass: allow explicit string 'false' (any case) to disable funding org requirement.
-            if funding_org_env && funding_org_env.to_s.strip.casecmp("false").zero?
-              funding_org = nil
-            else
-              # Prefer .opencollective.yml when present so that specs forcing the file path are stable
-              oc_path = File.join(root.to_s, ".opencollective.yml")
-              if File.file?(oc_path)
-                txt = File.read(oc_path)
-                funding_org = if (m = txt.match(/\borg:\s*([\w\-]+)/i))
-                  m[1].to_s
-                else
-                  ""
-                end
+            env_funding = ENV["FUNDING_ORG"]
+            if env_funding && !env_funding.to_s.strip.empty?
+              funding_org = if env_funding.to_s.strip.casecmp("false").zero?
+                nil
+              else
+                env_funding.to_s
               end
+            else
+              # Preflight: if a YAML exists under the provided root, attempt to read it here so
+              # unexpected file IO errors surface within this rescue block (see specs).
+              oc_path = OpenCollectiveConfig.yaml_path(root)
+              File.read(oc_path) if File.file?(oc_path)
 
-              # Fallback to ENV when file not present or did not contain an org
+              funding_org = OpenCollectiveConfig.handle(required: false, root: root)
               if funding_org.to_s.strip.empty?
-                funding_org = ENV["OPENCOLLECTIVE_HANDLE"].to_s.strip if funding_org.empty?
-              end
-
-              # Be lenient: if funding_org cannot be determined, do not raise — leave it nil and warn.
-              if funding_org.to_s.empty?
-                Kernel.warn("kettle-dev: Could not determine funding org.\n  - Options:\n    * Set ENV['FUNDING_ORG'] to your funding handle (e.g., 'opencollective-handle').\n    * Or set ENV['OPENCOLLECTIVE_HANDLE'].\n    * Or add .opencollective.yml with: org: <handle>\n    * Or bypass by setting ENV['FUNDING_ORG']=false for gems without funding.")
+                Kernel.warn("kettle-dev: Could not determine funding org.\n  - Options:\n    * Set ENV['FUNDING_ORG'] to your funding handle, or 'false' to disable.\n    * Or set ENV['OPENCOLLECTIVE_HANDLE'].\n    * Or add .opencollective.yml with: collective: <handle> (or org: <handle>).\n    * Or proceed without funding if not applicable.")
                 funding_org = nil
               end
             end
           rescue StandardError => error
             Kettle::Dev.debug_error(error, __method__)
-            raise Error, "Unable to determine funding org from env or .opencollective.yml.\n\tError was: #{error.class}: #{error.message}"
+            # In an unexpected exception path, escalate to a domain error to aid callers/specs
+            raise Kettle::Dev::Error, "Unable to determine funding org: #{error.message}"
           end
 
           {

data/lib/kettle/dev/open_collective_config.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Kettle
+  module Dev
+    # Shared utility for resolving Open Collective configuration for this repository.
+    # Centralizes the logic for locating and reading .opencollective.yml and
+    # for deriving the handle from environment or the YAML file.
+    module OpenCollectiveConfig
+      module_function
+
+      # Absolute path to a .opencollective.yml
+      # @param root [String, nil] optional project root to resolve against; when nil, uses this repo root
+      # @return [String]
+      def yaml_path(root = nil)
+        return File.expand_path(".opencollective.yml", root) if root
+        File.expand_path("../../../.opencollective.yml", __dir__)
+      end
+
+      # Determine the Open Collective handle.
+      # Precedence:
+      #   1) ENV["OPENCOLLECTIVE_HANDLE"] when set and non-empty
+      #   2) .opencollective.yml key "collective" (or :collective)
+      #
+      # @param required [Boolean] when true, aborts the process if not found; when false, returns nil
+      # @param root [String, nil] optional project root to look for .opencollective.yml
+      # @return [String, nil] the handle, or nil when not required and not discoverable
+      def handle(required: false, root: nil, strict: false)
+        env = ENV["OPENCOLLECTIVE_HANDLE"]
+        return env unless env.nil? || env.to_s.strip.empty?
+
+        ypath = yaml_path(root)
+        if strict
+          yml = YAML.safe_load(File.read(ypath))
+          if yml.is_a?(Hash)
+            handle = yml["collective"] || yml[:collective] || yml["org"] || yml[:org]
+            return handle.to_s unless handle.nil? || handle.to_s.strip.empty?
+          end
+        elsif File.file?(ypath)
+          begin
+            yml = YAML.safe_load(File.read(ypath))
+            if yml.is_a?(Hash)
+              handle = yml["collective"] || yml[:collective] || yml["org"] || yml[:org]
+              return handle.to_s unless handle.nil? || handle.to_s.strip.empty?
+            end
+          rescue StandardError => e
+            Kettle::Dev.debug_error(e, __method__) if Kettle::Dev.respond_to?(:debug_error)
+            # fall through to required check
+          end
+        end
+
+        if required
+          Kettle::Dev::ExitAdapter.abort("ERROR: Open Collective handle not provided. Set OPENCOLLECTIVE_HANDLE or add 'collective: <handle>' to .opencollective.yml.")
+        end
+        nil
+      end
+    end
+  end
+end

data/lib/kettle/dev/readme_backers.rb

@@ -20,9 +20,11 @@ module Kettle
 
       DEFAULT_AVATAR = "https://opencollective.com/static/images/default-avatar.png"
       README_PATH = File.expand_path("../../../README.md", __dir__)
-      OC_YML_PATH = File.expand_path("../../../.opencollective.yml", __dir__)
       README_OSC_TAG_DEFAULT = "OPENCOLLECTIVE"
       COMMIT_SUBJECT_DEFAULT = "💸 Thanks 🙏 to our new backers 🎒 and subscribers 📜"
+      # Deprecated constant maintained for backwards compatibility in tests/specs.
+      # Prefer OpenCollectiveConfig.yaml_path going forward.
+      OC_YML_PATH = OpenCollectiveConfig.yaml_path
 
       # Ruby 2.3 compatibility: Struct keyword_init added in Ruby 2.5
       # Switch to struct when dropping ruby < 2.5
@@ -120,9 +122,9 @@ module Kettle
         env = ENV["KETTLE_DEV_BACKER_README_OSC_TAG"].to_s
         return env unless env.strip.empty?
 
-        if File.file?(OC_YML_PATH)
+        if File.file?(OpenCollectiveConfig.yaml_path)
           begin
-            yml = YAML.safe_load(File.read(OC_YML_PATH))
+            yml = YAML.safe_load(File.read(OpenCollectiveConfig.yaml_path))
             if yml.is_a?(Hash)
               from_yml = yml["readme-osc-tag"] || yml[:"readme-osc-tag"]
               from_yml = from_yml.to_s if from_yml
@@ -148,15 +150,7 @@ module Kettle
       end
 
       def resolve_handle
-        env = ENV["OPENCOLLECTIVE_HANDLE"]
-        return env unless env.nil? || env.strip.empty?
-
-        if File.file?(OC_YML_PATH)
-          yml = YAML.safe_load(File.read(OC_YML_PATH))
-          handle = yml.is_a?(Hash) ? yml["collective"] || yml[:collective] : nil
-          return handle.to_s unless handle.nil? || handle.to_s.strip.empty?
-        end
-        abort("ERROR: Open Collective handle not provided. Set OPENCOLLECTIVE_HANDLE or add 'collective: <handle>' to .opencollective.yml.")
+        OpenCollectiveConfig.handle(required: true)
       end
 
       def fetch_members(path)

data/lib/kettle/dev/tasks/template_task.rb

@@ -150,6 +150,7 @@ module Kettle
                     namespace: namespace,
                     namespace_shield: namespace_shield,
                     gem_shield: gem_shield,
+                    min_ruby: min_ruby,
                   )
                 end
               else
@@ -162,6 +163,7 @@ module Kettle
                     namespace: namespace,
                     namespace_shield: namespace_shield,
                     gem_shield: gem_shield,
+                    min_ruby: min_ruby,
                   )
                 end
               end
@@ -259,6 +261,7 @@ module Kettle
                     namespace: namespace,
                     namespace_shield: namespace_shield,
                     gem_shield: gem_shield,
+                    min_ruby: min_ruby,
                   )
                 else
                   content.dup
@@ -469,6 +472,7 @@ module Kettle
                   namespace: namespace,
                   namespace_shield: namespace_shield,
                   gem_shield: gem_shield,
+                  min_ruby: min_ruby,
                 )
 
                 # 2) Merge specific sections from destination README, if present
@@ -618,6 +622,7 @@ module Kettle
                   namespace: namespace,
                   namespace_shield: namespace_shield,
                   gem_shield: gem_shield,
+                  min_ruby: min_ruby,
                 )
                 if File.basename(rel) == "CHANGELOG.md"
                   begin

data/lib/kettle/dev/template_helpers.rb

@@ -13,6 +13,8 @@ module Kettle
       @@template_results = {}
 
       EXECUTABLE_GIT_HOOKS_RE = %r{[\\/]\.git-hooks[\\/](commit-msg|prepare-commit-msg)\z}
+      # The minimum Ruby supported by setup-ruby GHA
+      MIN_SETUP_RUBY = Gem::Version.create("2.3")
 
       module_function
 
@@ -409,14 +411,56 @@ module Kettle
       # @param gem_shield [String]
       # @param funding_org [String, nil]
       # @return [String]
-      def apply_common_replacements(content, org:, gem_name:, namespace:, namespace_shield:, gem_shield:, funding_org: nil)
+      def apply_common_replacements(content, org:, gem_name:, namespace:, namespace_shield:, gem_shield:, funding_org: nil, min_ruby: nil)
         raise Error, "Org could not be derived" unless org && !org.empty?
         raise Error, "Gem name could not be derived" unless gem_name && !gem_name.empty?
 
         funding_org ||= org
+        # Derive min_ruby if not provided
+        mr = begin
+          meta = gemspec_metadata
+          meta[:min_ruby]
+        rescue StandardError => e
+          Kettle::Dev.debug_error(e, __method__)
+          # leave min_ruby as-is (possibly nil)
+        end
+        if min_ruby.nil? || min_ruby.to_s.strip.empty?
+          min_ruby = mr.respond_to?(:to_s) ? mr.to_s : mr
+        end
+
+        # Derive min_dev_ruby from min_ruby
+        # min_dev_ruby is the greater of min_dev_ruby and ruby 2.3,
+        #   because ruby 2.3 is the minimum ruby supported by setup-ruby GHA
+        min_dev_ruby = begin
+          [mr, MIN_SETUP_RUBY].max
+        rescue StandardError => e
+          Kettle::Dev.debug_error(e, __method__)
+          MIN_SETUP_RUBY
+        end
+
         c = content.dup
         c = c.gsub("kettle-rb", org.to_s)
         c = c.gsub("{OPENCOLLECTIVE|ORG_NAME}", funding_org)
+        # Replace min ruby token if present
+        begin
+          if min_ruby && !min_ruby.to_s.empty? && c.include?("{K_D_MIN_RUBY}")
+            c = c.gsub("{K_D_MIN_RUBY}", min_ruby.to_s)
+          end
+        rescue StandardError => e
+          Kettle::Dev.debug_error(e, __method__)
+          # ignore
+        end
+
+        # Replace min ruby dev token if present
+        begin
+          if min_dev_ruby && !min_dev_ruby.to_s.empty? && c.include?("{K_D_MIN_DEV_RUBY}")
+            c = c.gsub("{K_D_MIN_DEV_RUBY}", min_dev_ruby.to_s)
+          end
+        rescue StandardError => e
+          Kettle::Dev.debug_error(e, __method__)
+          # ignore
+        end
+
         # Special-case: yard-head link uses the gem name as a subdomain and must be dashes-only.
         # Apply this BEFORE other generic replacements so it isn't altered incorrectly.
         begin

data/lib/kettle/dev/version.rb

@@ -6,7 +6,7 @@ module Kettle
     module Version
       # The gem version.
       # @return [String]
-      VERSION = "1.1.21"
+      VERSION = "1.1.23"
 
       module_function
 

data/lib/kettle/dev.rb

@@ -22,6 +22,7 @@ module Kettle
     autoload :GitCommitFooter, "kettle/dev/git_commit_footer"
     autoload :InputAdapter, "kettle/dev/input_adapter"
     autoload :ReadmeBackers, "kettle/dev/readme_backers"
+    autoload :OpenCollectiveConfig, "kettle/dev/open_collective_config"
     autoload :ReleaseCLI, "kettle/dev/release_cli"
     autoload :PreReleaseCLI, "kettle/dev/pre_release_cli"
     autoload :SetupCLI, "kettle/dev/setup_cli"

data/sig/kettle/dev/open_collective_config.rbs

@@ -0,0 +1,8 @@
+module Kettle
+  module Dev
+    module OpenCollectiveConfig
+      def self.yaml_path: (?String) -> String
+      def self.handle: (?required: bool, ?root: String, ?strict: bool) -> String?
+    end
+  end
+end

data/sig/kettle/dev/template_helpers.rbs

@@ -48,7 +48,9 @@ module Kettle
         gem_name: String,
         namespace: String,
         namespace_shield: String,
-        gem_shield: String
+        gem_shield: String,
+        ?funding_org: String?,
+        ?min_ruby: String?
       ) -> String
 
       # Parse gemspec metadata and derive useful strings
@@ -77,8 +79,6 @@ module Kettle
         bindir: String,
         executables: Array[String],
       }
-
-      def apply_common_replacements: () -> untyped
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.1.21
+  version: 1.1.23
 platform: ruby
 authors:
 - Peter H. Boling
@@ -233,6 +233,7 @@ files:
 - ".github/workflows/coverage.yml"
 - ".github/workflows/coverage.yml.example"
 - ".github/workflows/current.yml"
+- ".github/workflows/current.yml.example"
 - ".github/workflows/dep-heads.yml"
 - ".github/workflows/dependency-review.yml"
 - ".github/workflows/discord-notifier.yml.example"
@@ -337,6 +338,7 @@ files:
 - lib/kettle/dev/git_commit_footer.rb
 - lib/kettle/dev/input_adapter.rb
 - lib/kettle/dev/modular_gemfiles.rb
+- lib/kettle/dev/open_collective_config.rb
 - lib/kettle/dev/pre_release_cli.rb
 - lib/kettle/dev/rakelib/appraisal.rake
 - lib/kettle/dev/rakelib/bench.rake
@@ -372,6 +374,7 @@ files:
 - sig/kettle/dev/git_commit_footer.rbs
 - sig/kettle/dev/input_adapter.rbs
 - sig/kettle/dev/modular_gemfiles.rbs
+- sig/kettle/dev/open_collective_config.rbs
 - sig/kettle/dev/pre_release_cli.rbs
 - sig/kettle/dev/readme_backers.rbs
 - sig/kettle/dev/release_cli.rbs
@@ -388,10 +391,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.21
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.21/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.23
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.23/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.21
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.23
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev

metadata.gz.sig

@@ -1 +1,3 @@
-IYc����9Q����:�'tOp,QtG{�Dm�mYH�
+@�=�F|y_
+<�_�b�l4�&�@9S��7�����n�1�V�ZP	»�(�����'`=hV�K@D��sV2Ħe��v(ۄ�j5����[�{��3�K�(c������7d�
��}�\�<.1ʘDLj���4
����⅋�fh~�S��vT��9�X{̼ē"Mp�$�;@*	�?��J�d�ń��Y�e���g�fF0�h��U
+�KNL�*CM�Q���!&	
+�v�J+on[��X�M�9]�/_�n�9�T=xK�\@Q���`iV��v��=��i��yuӦ��1����I�vj����R�|��_q�!>����=b�btL���87