kettle-test 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29bb20818a80f275c15b25bef0078baca3d702d7a37e192c58ef9b5cf6363f07
-  data.tar.gz: 9c57bdc7c6fe26a0c2f2889c07c1575042cfeb1eb4bf378669551d84d01c453f
+  metadata.gz: 6e49bb99b463b7e54e6dfb292a94651737aa8fab7bea6ae8c944d0bde946f68f
+  data.tar.gz: '0860f573c33a3a576c9bdb75d63c71ed76efe1183ab749f4c66d5798ad325208'
 SHA512:
-  metadata.gz: 82aa8c0ce12527b49efc55f43ee3d6354ef14b0839b0bc234ef20779c6a6cb780ad536793fbc86229940f44671d288d43bdc902dcb64d336530bd54d7a6f20ba
-  data.tar.gz: de92fabfcfc30947573b6b68ce1818794256d565a06149e2b69d57e7b7327b9f45b474c039c2f0228641cebb5ebb755887178a7b06ebc3fc7062b94b3982b941
+  metadata.gz: 807c6a6eeb21e7ff5a6c8cdd5314bcb4a33cc1dd16e0071f6104e435bb19b189af1f17243533255b12ed7a1ba90f17a513c5935a0be39235f5ba294f0d7c14ff
+  data.tar.gz: 7c54752858ec41862fd60d1f743e0cd905c38158faf17ffc0da58a2a422b36be001904da92d4756e07eab9e0db3e63bfe419ea787790b2c276c0d78a7896a3f3

data/CHANGELOG.md

@@ -30,6 +30,26 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.0.2] - 2026-06-01
+
+- TAG: [v2.0.2][2.0.2t]
+- COVERAGE: 100.00% -- 91/91 lines in 15 files
+- BRANCH COVERAGE: 100.00% -- 2/2 branches in 15 files
+- 90.00% documented
+
+### Changed
+
+- Retemplated project files with the current kettle-jem template, including the
+  StructuredMerge config migration, generated workflow updates, README logo
+  refresh, and updated development dependency floors.
+- Updated the runtime `turbo_tests2` dependency to require v3.1.0 or newer.
+
+### Fixed
+
+- `kettle-test` now resolves Appraisal gemfiles under `gemfiles/` back to the
+  project root before running specs, so coverage and log artifacts stay under
+  root-level `coverage/` and `tmp/` instead of being written inside `gemfiles/`.
+
 ## [2.0.1] - 2026-05-25
 
 - TAG: [v2.0.1][2.0.1t]
@@ -256,7 +276,9 @@ Please file a bug if you notice a violation of semantic versioning.
   - silent_stream
   - timecop-rspec
 
-[Unreleased]: https://github.com/kettle-rb/kettle-test/compare/v2.0.1...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-test/compare/v2.0.2...HEAD
+[2.0.2]: https://github.com/kettle-rb/kettle-test/compare/v2.0.1...v2.0.2
+[2.0.2t]: https://github.com/kettle-rb/kettle-test/releases/tag/v2.0.2
 [2.0.1]: https://github.com/kettle-rb/kettle-test/compare/v2.0.0...v2.0.1
 [2.0.1t]: https://github.com/kettle-rb/kettle-test/releases/tag/v2.0.1
 [2.0.0]: https://github.com/kettle-rb/kettle-test/compare/v1.0.10...v2.0.0

data/CONTRIBUTING.md

@@ -102,11 +102,32 @@ Git hooks and commit message helpers (exe/kettle-commit-msg)
 - GIT_HOOK_FOOTER_SENTINEL: Required when footer append is enabled — a unique first-line sentinel to prevent duplicates
 - GIT_HOOK_FOOTER_APPEND_DEBUG: Extra debug output in the footer template (true/false)
 
+Git diff driver setup
+- Local setup writes repository `.gitattributes` entries and local Git `diff.smorg-*` command config so this checkout uses StructuredMerge semantic diffs.
+- Global setup registers `diff.smorg-*` commands once in the user Git config; use it when you work across several StructuredMerge-enabled repositories.
+- Include-file setup writes `.git/smorg/config` and includes it from local Git config, keeping command registrations out of the repository files.
+- Git hosting forges generally ignore external diff drivers, so pull request views may still show raw textual diffs even when local `git diff` uses semantic drivers.
+
+```console
+K_JEM_TEMPLATING=true bundle exec kettle-jem install
+```
+
+Troubleshooting Git diffs
+- Use `git diff --no-ext-diff` to compare against Git's built-in diff output.
+- Use `git diff --no-textconv` when a textconv projection obscures the raw file bytes you need to inspect.
+- If Git reports a missing `smorg-*` executable, rerun `bundle install` and the setup command above, then check `git config --local --get-regexp '^diff\.smorg-'`.
+- To remove managed local entries, run `K_JEM_TEMPLATING=true bundle exec kettle-jem install --undo`; remove global command registrations with `git config --global --unset-all diff.smorg-ruby.command`.
+
 For a quick starting point, this repository’s `mise.toml` defines the shared defaults, and `.env.local` can override them locally. Copy `.env.local.example` to `.env.local`, use `KEY=value` lines, and either activate `mise` in your shell or run commands through `mise exec -C /path/to/project -- ...`.
 
 ## Appraisals
 
 From time to time the [appraisal2][🚎appraisal2] gemfiles in `gemfiles/` will need to be updated.
+Generated appraisal and CI workflow floors are controlled by `ruby.test_minimum`
+in `.structuredmerge/kettle-jem.yml`; this project was templated with `ruby.test_minimum: 2.4`.
+That value describes the lowest Ruby version expected to run the test/development
+toolchain, and it may be higher than the gemspec runtime floor.
+
 They are created and updated with the commands:
 
 ```console

data/README.md

@@ -1,17 +1,10 @@
-[![Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0][🖼️galtzo-floss-i]][🖼️galtzo-floss] [![ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5][🖼️ruby-lang-i]][🖼️ruby-lang] [![kettle-rb Logo by Aboling0, CC BY-SA 4.0][🖼️kettle-rb-i]][🖼️kettle-rb]
-
-[🖼️galtzo-floss-i]: https://logos.galtzo.com/assets/images/galtzo-floss/avatar-192px.svg
-[🖼️galtzo-floss]: https://discord.gg/3qme4XHNKN
-[🖼️ruby-lang-i]: https://logos.galtzo.com/assets/images/ruby-lang/avatar-192px.svg
-[🖼️ruby-lang]: https://www.ruby-lang.org/
-[🖼️kettle-rb-i]: https://logos.galtzo.com/assets/images/kettle-rb/avatar-192px.svg
-[🖼️kettle-rb]: https://github.com/kettle-rb
+<a href="https://github.com/kettle-rb"><img alt="kettle-rb Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/kettle-rb/avatar-128px.svg" width="14%" align="right"/></a>
 
 # 🍲 Kettle::Test
 
-[![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: AGPL-3.0-only OR PolyForm-Small-Business-1.0.0][📄license-img]][📄license] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![CodeCov Test Coverage][🏀codecovi]][🏀codecov] [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls] [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov] [![QLTY Maintainability][🏀qlty-mnti]][🏀qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![CodeQL][🖐codeQL-img]][🖐codeQL]
+[![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: AGPL-3.0-only OR PolyForm-Small-Business-1.0.0][📄license-img]][📄license] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![CodeCov Test Coverage][🏀codecovi]][🏀codecov] [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls] [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov] [![QLTY Maintainability][🏀qlty-mnti]][🏀qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf]
 
-`if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][🖼️galtzo-floss], as I may have missed the [discord notification][🖼️galtzo-floss].
+`if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][✉️discord-invite], as I may have missed the [discord notification][✉️discord-invite].
 
 ---
 
@@ -26,7 +19,7 @@ I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-ta
 
 </details>
 
-## 🌻 Synopsis
+## 🌻 Synopsis <a href="https://discord.gg/3qme4XHNKN"><img alt="Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px.svg" width="8%" align="right"/></a> <a href="https://ruby-toolbox.com"><img alt="ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5" src="https://logos.galtzo.com/assets/images/ruby-lang/avatar-128px.svg" width="8%" align="right"/></a>
 
 Add to your `spec/spec_helper.rb`:
 
@@ -78,6 +71,10 @@ and concordant releases of JRuby, and TruffleRuby.
 ### Compatibility
 
 Compatible with MRI Ruby 2.4.0+, and concordant releases of JRuby, and TruffleRuby.
+CI workflows and Appraisals are generated for MRI Ruby 2.4+.
+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.
 
 | 🚚 _Amazing_ test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚 |
 |------------------------------------------------|--------------------------------------------------------|
@@ -404,7 +401,7 @@ RSpec.describe("version-specific behavior") do
   it "pends for MRI >= 2.6.0 and <= 3.0.0" do
     pending_for(
       engine: :ruby,
-      versions: (Gem::Version.new("2.6.0")..Gem::Version.new("3.0.0")),
+      versions: (Gem::Version.new("2.6.0")..Gem::Version.new("3.0.0"))
     )
   end
 
@@ -412,7 +409,7 @@ RSpec.describe("version-specific behavior") do
   it "skips for MRI >= 3.1.0 and < 3.3.0" do
     skip_for(
       engine: :ruby,
-      versions: (Gem::Version.new("3.1.0")...Gem::Version.new("3.3.0")),
+      versions: (Gem::Version.new("3.1.0")...Gem::Version.new("3.3.0"))
     )
   end
 
@@ -435,7 +432,7 @@ RSpec.configure do |config|
   config.before(:each, :requires_ruby_32) do
     skip_for(
       reason: "Requires Ruby >= 3.2",
-      versions: %w[2.7 3.0 3.1],
+      versions: %w[2.7 3.0 3.1]
     )
   end
 end
@@ -603,6 +600,8 @@ To say "thanks!" ☝️ Join the Discord or 👇️ send money.
 
 ### Please give the project a star ⭐ ♥.
 
+Many parts of this project are actively managed by a [kettle-jem](https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/kettle-jem) smart template utilizing [StructuredMerge.org](https://structuredmerge.org) merge contracts.
+
 Thanks for RTFM. ☺️
 
 [⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
@@ -705,8 +704,6 @@ Thanks for RTFM. ☺️
 [🏀codecovi]: https://codecov.io/gh/kettle-rb/kettle-test/graph/badge.svg
 [🏀coveralls]: https://coveralls.io/github/kettle-rb/kettle-test?branch=main
 [🏀coveralls-img]: https://coveralls.io/repos/github/kettle-rb/kettle-test/badge.svg?branch=main
-[🖐codeQL]: https://github.com/kettle-rb/kettle-test/security/code-scanning
-[🖐codeQL-img]: https://github.com/kettle-rb/kettle-test/actions/workflows/codeql-analysis.yml/badge.svg
 [🚎ruby-2.4-wf]: https://github.com/kettle-rb/kettle-test/actions/workflows/ruby-2.4.yml
 [🚎ruby-2.5-wf]: https://github.com/kettle-rb/kettle-test/actions/workflows/ruby-2.5.yml
 [🚎ruby-2.6-wf]: https://github.com/kettle-rb/kettle-test/actions/workflows/ruby-2.6.yml
@@ -800,6 +797,7 @@ Thanks for RTFM. ☺️
 [📄license-img]: https://img.shields.io/badge/License-AGPL--3.0--only_OR_PolyForm--Small--Business--1.0.0-259D6C.svg
 [📄license-compat]: https://www.apache.org/legal/resolved.html#category-x
 [📄license-compat-img]: https://img.shields.io/badge/Apache_Incompatible:_Category_X-✗-C0392B.svg?style=flat&logo=Apache
+
 [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
 [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
 [🚎yard-current]: http://rubydoc.info/gems/kettle-test

data/exe/kettle-test.sh

@@ -80,13 +80,33 @@ RESET='\033[0m'
 hr() { printf '%s\n' "────────────────────────────────────────────────────────────────"; }
 
 # ── Project root ──────────────────────────────────────────────────────────────
-# When run via `bundle exec`, BUNDLE_GEMFILE points to the project's Gemfile.
-# Fall back to the current working directory.
+# When run via `bundle exec`, BUNDLE_GEMFILE can point at an Appraisal gemfile
+# under gemfiles/. Walk upward to the real project root so relative paths such
+# as coverage/ and tmp/ are never anchored under gemfiles/.
+
+find_project_root() {
+  local dir="$1"
+
+  dir="$(cd "$dir" && pwd)"
+  while [ "$dir" != "/" ]; do
+    if compgen -G "$dir/*.gemspec" >/dev/null ||
+      [ -f "$dir/Appraisal.root.gemfile" ] ||
+      [ -f "$dir/Gemfile" ] ||
+      [ -d "$dir/.git" ]; then
+      printf '%s\n' "$dir"
+      return 0
+    fi
+
+    dir="$(dirname "$dir")"
+  done
+
+  pwd
+}
 
 if [ -n "${BUNDLE_GEMFILE:-}" ]; then
-  PROJECT_ROOT="$(cd "$(dirname "$BUNDLE_GEMFILE")" && pwd)"
+  PROJECT_ROOT="$(find_project_root "$(dirname "$BUNDLE_GEMFILE")")"
 else
-  PROJECT_ROOT="$(pwd)"
+  PROJECT_ROOT="$(find_project_root "$(pwd)")"
 fi
 
 LOG_DIR="$PROJECT_ROOT/tmp/kettle-test"

data/lib/kettle/test/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Test
     module Version
-      VERSION = "2.0.1"
+      VERSION = "2.0.2"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

data/sig/kettle/test/version.rbs

@@ -6,4 +6,3 @@ module Kettle
     VERSION: String
   end
 end
-

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-test
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Peter H. Boling
@@ -205,14 +205,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.1.0
   type: :runtime
   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.1.0
 - !ruby/object:Gem::Dependency
   name: version_gem
   requirement: !ruby/object:Gem::Requirement
@@ -240,6 +246,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.6
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -247,6 +256,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.6
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -295,26 +307,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.4
-- !ruby/object:Gem::Dependency
-  name: appraisal2
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.6
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.6
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -355,20 +347,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 2.0.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 2.0.1
 description: "\U0001F372 Kettle::Test is a meta tool from kettle-rb to streamline
   testing. Acts as a shim dependency, pulling in many other dependencies, to give
   you OOTB productivity with a RubyGem, or Ruby app project. Configures RSpec w/ syntactic
@@ -428,10 +420,10 @@ licenses:
 - PolyForm-Small-Business-1.0.0
 metadata:
   homepage_uri: https://kettle-test.galtzo.com
-  source_code_uri: https://github.com/kettle-rb/kettle-test/tree/v2.0.1
-  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v2.0.1/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-test/tree/v2.0.2
+  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v2.0.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-test/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-test/2.0.1
+  documentation_uri: https://www.rubydoc.info/gems/kettle-test/2.0.2
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-test/wiki
   news_uri: https://www.railsbling.com/tags/kettle-test