kettle-dev 2.0.7 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b61c1554f763f345877105472c233b0f29d7d01f5b75cd77e80bd74f24eae14
-  data.tar.gz: e1686a3aa422b0bc1e716c296d07bdb81f0776512c5101737d737bf2a9b7238f
+  metadata.gz: d0939e7fbe918113808390ac5a59aa00eb55ef29f3cc5333e97891f934413027
+  data.tar.gz: ef89c8c3ba19f7da27e08c882f1484d78b40e820371c70cc14d343ca7aa74f17
 SHA512:
-  metadata.gz: 95f94d496c5796b9d66a16c74ed7f2b23ee0dfaa803c3c2bd28d796b29ec5faa02d833b0dcbc82f8987a3f5cc7c4f19a2cb9a793c96d5317ad4a83c467dec666
-  data.tar.gz: 742ef978f70ec542f3f4ca7b7386ccc7db2fcbe386c20830986001a5d15aed2c56f2ed0683712c885d822f64974cae6d600130cc79574a5f329338cfbbf82fe8
+  metadata.gz: 2458f3f267ecf17c4a6badd5ff6e52a2ab5c7480dab066634eb192ded14b551b72681dd7ec3e009d51f2ab51f405e3387c539ad65290e8043a7493ec2852b869
+  data.tar.gz: 75c6af98860bf08b8c807db3bc12dab3aa7a86cb557100b67d195a9630f8d141ca0a50d3e2fec51f715248ded501a46c2dd2fe18b039a840da95134abe97061b

data/CHANGELOG.md

@@ -28,11 +28,38 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
-- Avoided moving mocked CI task input reads into a background thread for
-  non-interactive runs, fixing TruffleRuby v23.0-v23.1 CI stability.
-
 ### Security
 
+## [2.1.0] - 2026-06-06
+
+- TAG: [v2.1.0][2.1.0t]
+- COVERAGE: 93.52% -- 2973/3179 lines in 25 files
+- BRANCH COVERAGE: 77.58% -- 1204/1552 branches in 25 files
+- 75.93% documented
+
+### Changed
+
+- `appraisal:install` now uses `appraisal generate-install`, and
+  `appraisal:update` now uses `appraisal generate-update`, preserving
+  generation-before-resolution behavior after Appraisal2 split pure install and
+  update commands from generation.
+- Appraisal gemfile cleanup is no longer run directly by kettle-dev appraisal
+  tasks; projects that need generated gemfile normalization should load an
+  Appraisal2 plugin hook such as `appraisal2-rubocop`.
+
+## [2.0.8] - 2026-06-02
+
+- TAG: [v2.0.8][2.0.8t]
+- COVERAGE: 92.83% -- 2953/3181 lines in 25 files
+- BRANCH COVERAGE: 76.59% -- 1201/1568 branches in 25 files
+- 75.93% documented
+
+### Fixed
+
+- `appraisal:update` now installs the `Appraisal.root.gemfile` bundle before
+  running `bundle update --bundler`, fixing first-run release failures when the
+  Appraisal root lockfile does not exist yet.
+
 ## [2.0.7] - 2026-06-01
 
 - TAG: [v2.0.7][2.0.7t]
@@ -46,6 +73,11 @@ Please file a bug if you notice a violation of semantic versioning.
 - Generated style Gemfiles now use the current RuboCop-LTS Ruby 2.4 floor.
 - Lint / style updates
 
+### Fixed
+
+- Avoided moving mocked CI task input reads into a background thread for
+  non-interactive runs, fixing TruffleRuby v23.0-v23.1 CI stability.
+
 ## [2.0.6] - 2026-05-31
 
 - TAG: [v2.0.6][2.0.6t]
@@ -545,7 +577,7 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - Template .yardopts now includes yard-yaml plugin (for CITATION.cff)
 - Template now includes a default `.yardopts` file
-  - Excludes *.gem, pkg/*.gem and .yardoc from documentation generation
+  - Excludes _.gem, pkg/_.gem and .yardoc from documentation generation
 
 ## [1.1.52] - 2025-11-08
 
@@ -1044,7 +1076,7 @@ Please file a bug if you notice a violation of semantic versioning.
 - improved documentation
 - better organized readme
 - badges are more clear & new badge for Ruby Friends Squad on Daily.dev
-    - https://app.daily.dev/squads/rubyfriends
+  - https://app.daily.dev/squads/rubyfriends
 
 ### Changed
 
@@ -1530,7 +1562,7 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
-- kettle:dev:install remove "Works with MRI Ruby*" lines with no badges left
+- kettle:dev:install remove "Works with MRI Ruby\*" lines with no badges left
 - kettle:dev:install prefix badge cell replacement with a single space
 
 ## [1.0.17] - 2025-08-29
@@ -1577,7 +1609,7 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
-- include gemfiles/modular/*gemfile.example with packaged gem
+- include gemfiles/modular/\*gemfile.example with packaged gem
 - CI workflow result polling logic revised:
   - includes a delay
   - scopes queries to specific commit SHA
@@ -1654,13 +1686,13 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Added
 
 - Add more .example templates
-    - .github/workflows/coverage.yml.example
-    - .gitlab-ci.yml.example
-    - Appraisals.example
+  - .github/workflows/coverage.yml.example
+  - .gitlab-ci.yml.example
+  - Appraisals.example
 - Kettle::Dev::InputAdapter: Input indirection layer for safe interactive prompts in tests; provides gets and readline; documented with YARD and typed with RBS.
 - install task README improvements
-    - extracts emoji grapheme from H1 to apply to gemspec's summary and description
-    - removes badges for unsupported rubies, and major version MRI row if all badges removed
+  - extracts emoji grapheme from H1 to apply to gemspec's summary and description
+  - removes badges for unsupported rubies, and major version MRI row if all badges removed
 - new exe script: kettle-changelog - transitions a changelog from unreleased to next release
 
 ### Changed
@@ -1672,17 +1704,17 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Removed
 
 - dependency on git gem
-    - git gem is still supported if present and not bypassed by new ENV variable `KETTLE_DEV_DISABLE_GIT_GEM`
-    - no longer a direct dependency
+  - git gem is still supported if present and not bypassed by new ENV variable `KETTLE_DEV_DISABLE_GIT_GEM`
+  - no longer a direct dependency
 
 ### Fixed
 
 - Upgrade stone_checksums for release compatibility with bundler v2.7+
-    - Retains compatibility with older bundler < v2.7
+  - Retains compatibility with older bundler < v2.7
 - Ship all example templates with gem
 - install task README preservation
-    - preserves H1 line, and specific H2 headed sections
-    - preserve table alignment
+  - preserves H1 line, and specific H2 headed sections
+  - preserve table alignment
 
 ## [1.0.10] - 2025-08-24
 
@@ -1705,7 +1737,7 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Removed
 
-- attempts to make exe/* scripts work without bundler. Bundler is required.
+- attempts to make exe/\* scripts work without bundler. Bundler is required.
 
 ### Fixed
 
@@ -1716,14 +1748,14 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - TAG: [v1.0.9][1.0.9t]
 - COVERAGE: 100.00% -- 130/130 lines in 7 files
-- BRANCH COVERAGE:  96.00% -- 48/50 branches in 7 files
+- BRANCH COVERAGE: 96.00% -- 48/50 branches in 7 files
 - 95.35% documented
 
 ### Added
 
 - kettle-release: Add a sanity check for the latest released version of the gem being released, and display it during the confirmation with user that CHANGELOG.md and version.rb have been updated, so they can compare the value in version.rb with the value of the latest released version.
-    - If the value in version.rb is less than the latest released version's major or minor, then check for the latest released version that matches the major + minor of what is in version.rb.
-    - This way a stable branch intended to release patch updates to older versions is able to work use the script.
+  - If the value in version.rb is less than the latest released version's major or minor, then check for the latest released version that matches the major + minor of what is in version.rb.
+  - This way a stable branch intended to release patch updates to older versions is able to work use the script.
 - kettle-release: optional pre-push local CI run using `act`, controlled by env var `K_RELEASE_LOCAL_CI` ("true" to run, "ask" to prompt) and `K_RELEASE_LOCAL_CI_WORKFLOW` to choose a workflow; defaults to `locked_deps.yml` when present; on failure, soft-resets the release prep commit and aborts.
 - template task: now copies `certs/pboling.pem` into the host project when available.
 
@@ -1747,7 +1779,7 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
-- Reproducible builds, with consistent checksums, by *not* using SOURCE_DATE_EPOCH.
+- Reproducible builds, with consistent checksums, by _not_ using SOURCE_DATE_EPOCH.
   - Since bundler v2.7.0 builds are reproducible by default.
 
 ## [1.0.6] - 2025-08-24
@@ -1829,9 +1861,9 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - These were documented but not yet released:
   - `kettle-release` ruby script for safely, securely, releasing a gem.
-      - This may move to its own gem in the future.
+    - This may move to its own gem in the future.
   - `kettle-readme-backers` ruby script for integrating Open Source Collective backers into a README.md file.
-      - This may move to its own gem in the future.
+    - This may move to its own gem in the future.
 
 ## [1.0.0] - 2025-08-24
 
@@ -1849,7 +1881,7 @@ Please file a bug if you notice a violation of semantic versioning.
   - appraisal2
   - gitmoji-regex (& git-hooks to enforce gitmoji commit-style)
   - via kettle-test
-    - Note: rake tasks for kettle-test are added in *this gem* (kettle-dev) because test rake tasks are a development concern
+    - Note: rake tasks for kettle-test are added in _this gem_ (kettle-dev) because test rake tasks are a development concern
     - rspec
       - although rspec is the focus, most tools work with minitest as well
     - rspec-block_is_expected
@@ -1862,7 +1894,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/v2.0.7...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v2.1.0...HEAD
+[2.1.0]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.8...v2.1.0
+[2.1.0t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.1.0
+[2.0.8]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.7...v2.0.8
+[2.0.8t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.8
 [2.0.7]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.6...v2.0.7
 [2.0.7t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.7
 [2.0.6]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.5...v2.0.6

data/LICENSE.md

@@ -9,4 +9,4 @@ If none of the above licenses fit your use case, please [contact us](mailto:flos
 
 ## Copyright Notice
 
-Copyright (c) 2023, 2025-2026 Peter H. Boling
+- Copyright (c) 2023, 2025-2026 Peter H. Boling

data/README.md

@@ -839,7 +839,7 @@ Thanks for RTFM. ☺️
 | Package | kettle-dev |
 | Description | 🍲 Kettle::Dev is a meta tool from kettle-rb to streamline development and testing. Acts as a shim dependency, pulling in many other dependencies, to give you OOTB productivity with a RubyGem, or Ruby app project. Configures a complete set of Rake tasks, for all the libraries is brings in, so they arrive ready to go. Fund overlooked open source projects - bottom of stack, dev/test dependencies: floss-funding.dev |
 | Homepage | https://github.com/kettle-rb/kettle-dev |
-| Source | https://github.com/kettle-rb/kettle-dev/tree/v2.0.6 |
+| Source | https://github.com/kettle-rb/kettle-dev/tree/v2.1.0 |
 | License | `AGPL-3.0-only` |
 | Funding | https://github.com/sponsors/pboling, https://issuehunt.io/u/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/kettle-rb, https://patreon.com/galtzo, https://polar.sh/pboling, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/kettle-dev, https://www.buymeacoffee.com/pboling |
 <!-- kettle-jem:metadata:end -->

data/SECURITY.md

@@ -4,7 +4,7 @@
 
 | Version  | Supported |
 |----------|-----------|
-| 1.latest | ✅         |
+| 2.1.latest | ✅         |
 
 ## Security contact information
 

data/lib/kettle/dev/rakelib/appraisal.rake

@@ -4,24 +4,76 @@
 begin
   require "appraisal/task"
 
-  desc("Install Appraisal gemfiles (initial setup for projects that didn't previously use Appraisal)")
-  task("appraisal:install") do
-    bundle = "bundle"
+  bundle = "bundle"
+  appraisal_env = {"BUNDLE_GEMFILE" => "Appraisal.root.gemfile"}
 
-    run_in_unbundled = proc do
-      env = {"BUNDLE_GEMFILE" => "Appraisal.root.gemfile"}
+  run_command = lambda do |failure_message, *args|
+    ok = system(*args)
+    raise(failure_message) unless ok
+  end
 
-      # 1) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
-      ok = system(env, bundle, "install")
-      abort("appraisal:install failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install") unless ok
+  run_generate_steps = lambda do
+    # 1) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
+    run_command.call(
+      "appraisal:generate failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
+      appraisal_env,
+      bundle,
+      "install"
+    )
+
+    # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate
+    run_command.call(
+      "appraisal:generate failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate",
+      appraisal_env,
+      bundle,
+      "exec",
+      "appraisal",
+      "generate"
+    )
+  end
 
-      # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal install
-      ok = system(env, bundle, "exec", "appraisal", "install")
-      abort("appraisal:install failed: bundle exec appraisal install") unless ok
+  run_appraisal_task = lambda do |task_name, primary_steps = nil|
+    begin
+      if primary_steps
+        begin
+          primary_steps.call
+        rescue RuntimeError => e
+          warn("[kettle-dev][#{task_name}] #{e.message}; falling back to appraisal:generate")
+          run_generate_steps.call
+        end
+      else
+        run_generate_steps.call
+      end
+    rescue RuntimeError => e
+      abort(e.message)
+    end
+  end
 
-      # 3) bundle exec rake rubocop_gradual:autocorrect
-      ok = system(bundle, "exec", "rake", "rubocop_gradual:autocorrect")
-      abort("appraisal:update failed: rubocop_gradual:autocorrect") unless ok
+  desc("Install Appraisal gemfiles (initial setup for projects that didn't previously use Appraisal)")
+  task("appraisal:install") do
+    run_in_unbundled = proc do
+      run_appraisal_task.call(
+        "appraisal:install",
+        lambda do
+          # 1) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
+          run_command.call(
+            "appraisal:install failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
+            appraisal_env,
+            bundle,
+            "install"
+          )
+
+          # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate-install
+          run_command.call(
+            "appraisal:install failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate-install",
+            appraisal_env,
+            bundle,
+            "exec",
+            "appraisal",
+            "generate-install"
+          )
+        end
+      )
     end
 
     if defined?(Bundler)
@@ -33,18 +85,8 @@ begin
 
   desc("Generate Appraisal gemfiles without resolving appraisal locks")
   task("appraisal:generate") do
-    bundle = "bundle"
-
     run_in_unbundled = proc do
-      env = {"BUNDLE_GEMFILE" => "Appraisal.root.gemfile"}
-
-      # 1) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
-      ok = system(env, bundle, "install")
-      abort("appraisal:generate failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install") unless ok
-
-      # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate
-      ok = system(env, bundle, "exec", "appraisal", "generate")
-      abort("appraisal:generate failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate") unless ok
+      run_appraisal_task.call("appraisal:generate")
     end
 
     if defined?(Bundler)
@@ -54,28 +96,48 @@ begin
     end
   end
 
-  desc("Update Appraisal gemfiles and run RuboCop Gradual autocorrect")
+  desc("Generate and update Appraisal gemfiles")
   task("appraisal:update") do
-    bundle = "bundle"
-
     run_in_unbundled = proc do
-      env = {"BUNDLE_GEMFILE" => "Appraisal.root.gemfile"}
-
-      # 1) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle update --bundler
-      ok = system(env, bundle, "update", "--bundler")
-      abort("appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle update --bundler") unless ok
-
-      # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
-      ok = system(env, bundle, "install")
-      abort("appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install") unless ok
-
-      # 3) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal update
-      ok = system(env, bundle, "exec", "appraisal", "update")
-      abort("appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal update") unless ok
-
-      # 4) bundle exec rake rubocop_gradual:autocorrect
-      ok = system(bundle, "exec", "rake", "rubocop_gradual:autocorrect")
-      abort("appraisal:update failed: rubocop_gradual:autocorrect") unless ok
+      run_appraisal_task.call(
+        "appraisal:update",
+        lambda do
+          # 1) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
+          run_command.call(
+            "appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
+            appraisal_env,
+            bundle,
+            "install"
+          )
+
+          # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle update --bundler
+          run_command.call(
+            "appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle update --bundler",
+            appraisal_env,
+            bundle,
+            "update",
+            "--bundler"
+          )
+
+          # 3) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install
+          run_command.call(
+            "appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
+            appraisal_env,
+            bundle,
+            "install"
+          )
+
+          # 4) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate-update
+          run_command.call(
+            "appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate-update",
+            appraisal_env,
+            bundle,
+            "exec",
+            "appraisal",
+            "generate-update"
+          )
+        end
+      )
     end
 
     if defined?(Bundler)

data/lib/kettle/dev/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Dev
     module Version
-      VERSION = "2.0.7"
+      VERSION = "2.1.0"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.0.7
+  version: 2.1.0
 platform: ruby
 authors:
 - Peter H. Boling
@@ -66,7 +66,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.9
+        version: 1.1.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.9
+        version: 1.1.10
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -131,20 +131,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 3.1.0
+- !ruby/object:Gem::Dependency
+  name: turbo_tests2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.1
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -312,10 +332,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.0.7
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.7/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.1.0
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.1.0/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.7
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.1.0
   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