kettle-dev 1.0.21 → 1.0.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c207c08e4e9933149728224c355077d0023be3794639f3e9eae9132207fb403b
-  data.tar.gz: 82c963e4d47084fdce04e9951e46b77109d782c2d206cb46b39f0f8965509a6e
+  metadata.gz: 4a2319467e7b37ae135d36dd2d9750de33b700cad93bfbcad890c51002489941
+  data.tar.gz: 30eb41fdaa0a113665d1050d3f24e46ce715b5a019d4987d4391acea8fd62de6
 SHA512:
-  metadata.gz: 422cd88655f41ceff9b98af93024ae86d107f0311238bd79630c88e576b4fc8b0e4023bd4804ec58a334e43a0c89dd21a1fc6ac4e410786298d7ed688ee28317
-  data.tar.gz: 36ee1bd93cc0c8422b292bbd616b277cba903feb5194cdca82167f3e4e40cce086860f76f7a5c8bb748e36e329851abbe843ebcb047cc6aed7e0ae073e80b829
+  metadata.gz: aefe32f787237bc2c1e3a07491eee3a126b4ecff7f76cff3b1a38d14c46e1dd06c0ba37bb88855430b305aa5c9cfd067f6c1bd37d7dd72ff29f62faf55dfe0c1
+  data.tar.gz: 0f9e5277c86c888aba4bb32286646f86a269380f0a1d526810ba2ddc6723d89bbeb405e00a29c8b29b6dbbb7d77248e0e76250f04143f8cf836aef0f9ce6a0ed

data/.github/workflows/heads.yml

@@ -77,9 +77,21 @@ jobs:
       # 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
+      - name: "Install Root Appraisal"
         run: bundle
-      - name: Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}
+
+      - name: "[Attempt 1] Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}"
+        id: bundleAttempt1
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle
+        # Continue to the next step on failure
+        continue-on-error: true
+
+      # Effectively an automatic retry of the previous step.
+      - name: "[Attempt 2] Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}"
+        id: bundleAttempt2
+        # If bundleAttempt1 failed, try again here; Otherwise skip.
+        if: steps.bundleAttempt1.outcome == 'failure'
         run: bundle exec appraisal ${{ matrix.appraisal }} bundle
+
       - name: Tests for ${{ matrix.ruby }}@${{ matrix.appraisal }} via ${{ matrix.exec_cmd }}
         run: bundle exec appraisal ${{ matrix.appraisal }} bundle exec ${{ matrix.exec_cmd }}

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

@@ -0,0 +1,97 @@
+name: Heads
+
+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 }}${{ matrix.name_extra || '' }}
+    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:
+      fail-fast: true
+      matrix:
+        include:
+          # NOTE: Heads use default rubygems / bundler; their defaults are custom, unreleased, and from the future!
+          # ruby-head
+          - ruby: "ruby-head"
+            appraisal: "head"
+            exec_cmd: "rake test"
+            gemfile: "Appraisal.root"
+            rubygems: default
+            bundler: default
+
+          # truffleruby-head
+          - ruby: "truffleruby-head"
+            appraisal: "head"
+            exec_cmd: "rake test"
+            gemfile: "Appraisal.root"
+            rubygems: default
+            bundler: default
+
+          # jruby-head
+          - ruby: "jruby-head"
+            appraisal: "head"
+            exec_cmd: "rake test"
+            gemfile: "Appraisal.root"
+            rubygems: default
+            bundler: default
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Ruby & RubyGems
+        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"
+        run: bundle
+
+      - name: "[Attempt 1] Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}"
+        id: bundleAttempt1
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle
+        # Continue to the next step on failure
+        continue-on-error: true
+
+      # Effectively an automatic retry of the previous step.
+      - name: "[Attempt 2] Appraisal for ${{ matrix.ruby }}@${{ matrix.appraisal }}"
+        id: bundleAttempt2
+        # If bundleAttempt1 failed, try again here; Otherwise skip.
+        if: steps.bundleAttempt1.outcome == 'failure'
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle
+
+      - name: Tests for ${{ matrix.ruby }}@${{ matrix.appraisal }} via ${{ matrix.exec_cmd }}
+        run: bundle exec appraisal ${{ matrix.appraisal }} bundle exec ${{ matrix.exec_cmd }}

data/Appraisals

@@ -32,6 +32,8 @@ end
 # Split into discrete appraisals if one of them needs a dependency locked discretely.
 appraise "head" do
   gem "erb"
+  # See: https://github.com/vcr/vcr/issues/1057
+  gem "cgi", ">= 0.5"
   gem "mutex_m", ">= 0.2"
   gem "stringio", ">= 3.0"
   gem "benchmark", "~> 0.4", ">= 0.4.1"

data/CHANGELOG.md

@@ -24,6 +24,16 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Fixed
 ### Security
 
+## [1.0.22] - 2025-08-30
+- TAG: [v1.0.22][1.0.22t]
+- COVERAGE: 97.82% -- 2375/2428 lines in 20 files
+- BRANCH COVERAGE: 81.34% -- 972/1195 branches in 20 files
+- 76.23% documented
+### Added
+- improved documentation
+- example version of heads workflow
+  - give heads two attempts to succeed
+
 ## [1.0.21] - 2025-08-30
 - TAG: [v1.0.21][1.0.21t]
 - COVERAGE: 97.82% -- 2375/2428 lines in 20 files
@@ -328,7 +338,7 @@ 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.0.21...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.0.22...HEAD
 [1.0.0]: https://github.com/kettle-rb/kettle-dev/compare/a427c302df09cfe4253a7c8d400333f9a4c1a208...v1.0.0
 [1.0.0t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.0.0
 [1.0.1]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.0...v1.0.1
@@ -373,3 +383,5 @@ Please file a bug if you notice a violation of semantic versioning.
 [1.0.20t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.0.20
 [1.0.21]: https://github.com/kettle-rb/kettle-dev/compare/v1.0.20...v1.0.21
 [1.0.21t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.0.21
+[1.0.22]: https://github.com/kettle-rb/kettle-dev/compare/v1.0.21...v1.0.22
+[1.0.22t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.0.22

data/Rakefile.example

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# kettle-dev Rakefile v1.0.21 - 2025-08-30
+# kettle-dev Rakefile v1.0.22 - 2025-08-30
 # Ruby 2.3 (Safe Navigation) or higher required
 #
 # MIT License (see License.txt)

data/kettle-dev.gemspec.example

@@ -31,7 +31,7 @@ Gem::Specification.new do |spec|
 
   # Linux distros often package gems and securely certify them independent
   #   of the official RubyGem certification process. Allowed via ENV["SKIP_GEM_SIGNING"]
-  # Ref: https://gitlab.com/oauth-xx/version_gem/-/issues/3
+  # Ref: https://gitlab.com/ruby-oauth/version_gem/-/issues/3
   # Hence, only enable signing if `SKIP_GEM_SIGNING` is not set in ENV.
   # See CONTRIBUTING.md
   unless ENV.include?("SKIP_GEM_SIGNING")

data/lib/kettle/dev/version.rb

@@ -6,7 +6,7 @@ module Kettle
     module Version
       # The gem version.
       # @return [String]
-      VERSION = "1.0.21"
+      VERSION = "1.0.22"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.0.21
+  version: 1.0.22
 platform: ruby
 authors:
 - Peter H. Boling
@@ -243,6 +243,7 @@ files:
 - ".github/workflows/dependency-review.yml"
 - ".github/workflows/discord-notifier.yml"
 - ".github/workflows/heads.yml"
+- ".github/workflows/heads.yml.example"
 - ".github/workflows/jruby.yml"
 - ".github/workflows/jruby.yml.example"
 - ".github/workflows/legacy.yml"
@@ -345,10 +346,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.0.21
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.0.21/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.0.22
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.0.22/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.0.21
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.0.22
   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