kettle-dev 1.1.56 → 1.1.57

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62e325c872a074389b37b26430debd850401b38e86d9e21beecde17565beb561
-  data.tar.gz: 9f2698e5f4fd28e0c97cef4c9ca6b41b313cca732bb7b1338ef333e87c2b7240
+  metadata.gz: 3913400a8582c79152894a5c27da0981401d81f08d598061582a95f567ccbb10
+  data.tar.gz: e9f02c0ad8952cba8e30a1fb94872637f175f91eb24ce12c3edb1f731bec773e
 SHA512:
-  metadata.gz: 5799a7e73b2d365f1adedae8a00b66197547727937be9b88cabc16dc17755e8aa96e53ce34c379f88fb917fe7be9b22db7090095500140f592e1372f77006835
-  data.tar.gz: b7dcc7f75644618b7f5294bd94c4ba3157cc64306509ef66ff173a16f25ad7a123b66c0304df0633bbbc8fdfdd69d0db1ab01d0e9bec03e016eb9f830bdf6cac
+  metadata.gz: 6eb29f6e550dcd1bf578ccec78a656928ab8b2171036057cf18e72546ab4e3db2ba137724317f4dfb1fde14eb14d357fd4ef9611b985b586aa219cdf5a0a461c
+  data.tar.gz: fe78f07d2b3fe5fcd542842b213d71447c160ae2f41820acf251879340022aabcb368d7a7a20865714666efdd98ee649fa5ddf221dbfc3141ec4e4d27cea0f63

data/.env.local.example

@@ -25,3 +25,7 @@ export GITHUB_TOKEN=<your GH token for GHA status; NEVER COMMIT>
 export GITLAB_TOKEN=<your GitLab token for pipeline status; NEVER COMMIT>
 # Alternatively:
 # export GL_TOKEN=<your GitLab token>
+
+# If this gem does not have an open source collective uncomment and set these to false.
+# export OPENCOLLECTIVE_HANDLE=false
+# export FUNDING_ORG=false

data/.yardignore

@@ -1,5 +1,13 @@
 # Ignore built gem artifacts and package dir
-pkg/*.gem
+bin/**/*
+certs/**/*
+checksums/**/*
+gemfiles/**/*
+pkg/**/*
+spec/**/*
+spec*/**/*
+test/**/*
+tmp/**/*
 *.gem
 # Also ignore yardoc cache
 .yardoc/

data/CHANGELOG.md

@@ -30,6 +30,22 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.1.57] - 2025-11-13
+
+- TAG: [v1.1.57][1.1.57t]
+- COVERAGE: 94.36% -- 4065/4308 lines in 26 files
+- BRANCH COVERAGE: 78.81% -- 1674/2124 branches in 26 files
+- 79.89% documented
+
+### Added
+
+- New Rake task: `appraisal:reset` — deletes all Appraisal lockfiles (`gemfiles/*.gemfile.lock`).
+- Improved .env.local.example template
+
+### Fixed
+
+- .yardignore more comprehensively ignores directories that are not relevant to documentation
+
 ## [1.1.56] - 2025-11-11
 
 - TAG: [v1.1.56][1.1.56t]
@@ -1394,7 +1410,9 @@ 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.56...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.57...HEAD
+[1.1.57]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.56...v1.1.57
+[1.1.57t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.57
 [1.1.56]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.55...v1.1.56
 [1.1.56t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.56
 [1.1.55]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.54...v1.1.55

data/CONTRIBUTING.md

@@ -96,6 +96,12 @@ They are created and updated with the commands:
 bin/rake appraisal:update
 ```
 
+If you need to reset all gemfiles/*.gemfile.lock files:
+
+```console
+bin/rake appraisal:reset
+```
+
 When adding an appraisal to CI, check the [runner tool cache][🏃‍♂️runner-tool-cache] to see which runner to use.
 
 ## The Reek List

data/CONTRIBUTING.md.example

@@ -89,6 +89,12 @@ They are created and updated with the commands:
 bin/rake appraisal:update
 ```
 
+If you need to reset all gemfiles/*.gemfile.lock files:
+
+```console
+bin/rake appraisal:reset
+```
+
 When adding an appraisal to CI, check the [runner tool cache][🏃‍♂️runner-tool-cache] to see which runner to use.
 
 ## The Reek List

data/README.md

@@ -362,6 +362,11 @@ Common flows
   - `bundle exec rake reek` or `bundle exec rake reek:update`
   - `bundle exec rake yard`
 
+[Appraisals][💎appraisal2] helpers
+- `bundle exec rake appraisal:isntall` — First time Appraisal setup.
+- `bundle exec rake appraisal:update` — Update Appraisal gemfiles and run RuboCop Gradual autocorrect.
+- `bundle exec rake appraisal:reset` — Delete all Appraisal lockfiles in gemfiles/ (*.gemfile.lock). Useful before regenerating appraisals or when switching Ruby versions.
+
 GitHub Actions local runner helper
 - `bundle exec rake ci:act` — interactive menu shows workflows from `.github/workflows` with live status and short codes (first 3 letters of file name). Type a number or short code.
 - Non-interactive: `bundle exec rake ci:act[loc]` (short code), or `bundle exec rake ci:act[locked_deps.yml]` (filename).
@@ -374,7 +379,7 @@ Setup tokens for API status (GitHub and GitLab)
     - Classic (fallback): “Tokens (classic)” → Generate new token
   - Minimum permissions:
     - Fine-grained: Repository access: Read-only for the target repository (or your org); Permissions → Actions: Read
-    - Classic: For public repos, no scopes are strictly required but rate limits are very low; for private repos, include the repo scope
+    - Classic: For public repos, no scopes are strictly required, but rate limits are very low; for private repos, include the repo scope
   - Add to environment (.env.local via direnv):
     - GITHUB_TOKEN=your_token_here  (or GH_TOKEN=…)
 - GitLab token:

data/Rakefile.example

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# kettle-dev Rakefile v1.1.56 - 2025-11-11
+# kettle-dev Rakefile v1.1.57 - 2025-11-13
 # Ruby 2.3 (Safe Navigation) or higher required
 #
 # MIT License (see License.txt)
@@ -11,6 +11,8 @@
 #
 # Sets up tasks for appraisal, floss_funding, rspec, minitest, rubocop, reek, yard, and stone_checksums.
 #
+# rake appraisal:install                      # Install Appraisal gemfiles (initial setup...
+# rake appraisal:reset                        # Delete Appraisal lockfiles (gemfiles/*.gemfile.lock)
 # rake appraisal:update                       # Update Appraisal gemfiles and run RuboCop...
 # rake bench                                  # Run all benchmarks (alias for bench:run)
 # rake bench:list                             # List available benchmark scripts

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

@@ -61,6 +61,43 @@ begin
       run_in_unbundled.call
     end
   end
+
+  # Delete all Appraisal lockfiles in gemfiles/ (*.gemfile.lock)
+  desc("Delete Appraisal lockfiles (gemfiles/*.gemfile.lock)")
+  task("appraisal:reset") do
+    run_in_unbundled = proc do
+      lock_glob = File.join("gemfiles", "*.gemfile.lock")
+      locks = Dir.glob(lock_glob)
+
+      if locks.empty?
+        puts("[kettle-dev][appraisal:reset] no files matching #{lock_glob}")
+      else
+        failures = []
+        locks.each do |f|
+          begin
+            File.delete(f)
+          rescue Errno::ENOENT
+            # Ignore if already gone
+          rescue StandardError => e
+            failures << [f, e]
+          end
+        end
+
+        unless failures.empty?
+          failed_list = failures.map { |(f, e)| "#{f} (#{e.class}: #{e.message})" }.join(", ")
+          abort("appraisal:reset failed: unable to delete #{failed_list}")
+        end
+
+        puts("[kettle-dev][appraisal:reset] deleted #{locks.size} file(s)")
+      end
+    end
+
+    if defined?(Bundler)
+      Bundler.with_unbundled_env(&run_in_unbundled)
+    else
+      run_in_unbundled.call
+    end
+  end
 rescue LoadError
   warn("[kettle-dev][appraisal.rake] failed to load appraisal/tasks") if Kettle::Dev::DEBUGGING
 end

data/lib/kettle/dev/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.1.56
+  version: 1.1.57
 platform: ruby
 authors:
 - Peter H. Boling
@@ -401,10 +401,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.56
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.56/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.57
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.57/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.56
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.57
   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