kettle-dev 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 423e786ae241791214751d2cd3496033ba0986b4279d738d62feda1eb197837b
-  data.tar.gz: 7c7436dcf0a65dea2d9241263bfd6d357c64a5f4a1a12432325fb5aecfe2cd38
+  metadata.gz: c3bad017c27149d9c7bf639bf70347f639d9301b3ce355c9a20eb7466f959df0
+  data.tar.gz: 8c96fb38ea79b64d55d2813725120518e1e3bcf2dda8396c8b2da1e3aa699d23
 SHA512:
-  metadata.gz: 2f7e35c2eedd5a7f4b75bd9ce4bfb0e98e269a05694875a6c53311aaab885d5a3d8839283b3ca986cd3b694f1f48b3bc3ed0dc28171decb1e5391ef61b0df0c2
-  data.tar.gz: abd66bf76d22b3d13303228bf46d22b4fbb7f69c26d0740e54ec6c693f3f31d10b34f9cc4491fb12be0e073777af8ca812d57eb740cd27af65b644bb445bba60
+  metadata.gz: 21ad36073bf15fd42f052958148f8129138e4ab79195d524457ba5c29e206fd261f283b9b6616e7a41cc46b6455c27e1d763167f8b8e75655acf2cdaa1a5c713
+  data.tar.gz: fcef88758871ad5eb760e0671972c6ef389dd3d9037f5006ddd65d2d07c651c7778a86dd344e86815b37b0451833544ba10ef895db28c6fa5dd0221502013d95

data/CHANGELOG.md

@@ -22,6 +22,23 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Changed
 
+### Deprecated
+
+### Removed
+
+### Fixed
+
+### Security
+
+## [2.0.2] - 2026-05-27
+
+- TAG: [v2.0.2][2.0.2t]
+- COVERAGE: 94.71% -- 2937/3101 lines in 23 files
+- BRANCH COVERAGE: 78.23% -- 1200/1534 branches in 23 files
+- 76.40% documented
+
+### Changed
+
 - **BREAKING**: Raised the minimum Ruby version to 2.4.0, matching
   `kettle-test` 2.x and its runtime `turbo_tests2` dependency.
 - `kettle-test` is now declared as a runtime dependency because the shipped rake
@@ -29,14 +46,14 @@ Please file a bug if you notice a violation of semantic versioning.
 - Refreshed generated template output for README badge formatting and
   Ruby 2.4-targeted RuboCop LTS style dependencies.
 
-### Deprecated
-
 ### Removed
 
 - Removed Ruby 2.3 and JRuby 9.1 CI workflows and appraisal gemfiles.
 
 ### Fixed
 
+- `ci:act` and release CI monitoring now detect GitHub and GitLab repositories
+  when remotes use `git+ssh://` or `ssh://` URLs.
 - Appraisal-based CI gemfiles now load the version-appropriate VCR/WebMock
   recording dependencies required by the spec helper without falling back to the
   root Gemfile.
@@ -49,14 +66,15 @@ Please file a bug if you notice a violation of semantic versioning.
   poisoning the process exit status.
 - Coverage CI thresholds now match the repository `mise.toml` thresholds instead
   of requiring unreachable 100% line and branch coverage.
+- `kettle-changelog` now fails closed when `kettle-test` does not produce the
+  expected collated `coverage/coverage.json`, instead of merging worker coverage
+  files itself and hiding a coverage integration failure.
 - Regenerated templating now keeps `kettle-test` as a runtime dependency only
   instead of duplicating it as both runtime and development dependency.
 - Replaced non-capturing `=~` checks with `Regexp#match?` so unlocked/style CI
   stays clean with newer RuboCop performance cops.
 - Cleared the remaining `rubocop_gradual` backlog and removed the lock file.
 
-### Security
-
 ## [2.0.1] - 2026-05-25
 
 - TAG: [v2.0.1][2.0.1t]
@@ -1745,7 +1763,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/v2.0.1...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.2...HEAD
+[2.0.2]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.1...v2.0.2
+[2.0.2t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.2
 [2.0.1]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.0...v2.0.1
 [2.0.1t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.1
 [2.0.0]: https://github.com/kettle-rb/kettle-dev/compare/v1.2.5...v2.0.0

data/CONTRIBUTING.md

@@ -107,6 +107,11 @@ For a quick starting point, this repository’s `mise.toml` defines the shared d
 ## 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 `.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

@@ -228,6 +228,10 @@ tree_haver supports multiple parsing backends, but not all backends work on all
 ### 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 💚 |
 |------------------------------------------------|--------------------------------------------------------|
@@ -1006,7 +1010,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.068-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.101-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-rb/kettle-dev/blob/main/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
@@ -1015,6 +1019,7 @@ Thanks for RTFM. ☺️
 [📄license-img]: https://img.shields.io/badge/License-AGPL--3.0--only-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-%E2%9C%97-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-dev

data/lib/kettle/dev/changelog_cli.rb

@@ -4,6 +4,7 @@ require "open3"
 require "json"
 require "net/http"
 require "uri"
+require "fileutils"
 
 module Kettle
   module Dev
@@ -525,14 +526,11 @@ module Kettle
 
           puts "Coverage generation complete."
 
-          # Check if coverage.json was generated
-          unless File.file?(@coverage_path)
-            raise "Coverage JSON not found at #{Kettle::Dev.display_path(@coverage_path)} after running bundle exec kettle-test"
-          end
+          ensure_changelog_coverage_json!
         else
           # Non-strict mode: check if coverage.json exists, warn if not
           unless File.file?(@coverage_path)
-            warn("Coverage JSON not found at #{Kettle::Dev.display_path(@coverage_path)}.")
+            warn(coverage_json_missing_message)
             warn("Run: K_SOUP_COV_FORMATTERS=json bundle exec kettle-test to generate it")
             return [nil, nil]
           end
@@ -597,26 +595,43 @@ module Kettle
         }
       end
 
+      def ensure_changelog_coverage_json!
+        return if File.file?(@coverage_path)
+
+        raise coverage_json_missing_message
+      end
+
+      def coverage_json_missing_message
+        [
+          "Coverage JSON not found at #{Kettle::Dev.display_path(@coverage_path)} after running bundle exec kettle-test.",
+          "kettle-test runs specs in parallel and is expected to collate parallel SimpleCov results into this canonical file.",
+          "If it is missing, coverage was not enabled in ENV config or the rake/task hooks did not load the coverage integration.",
+        ].join(" ")
+      end
+
       def yard_percent_documented
-        cmd = File.join(@root, "bin", "rake")
-        unless File.executable?(cmd)
+        commands = yard_documentation_commands
+        if commands.empty?
           if @strict
-            raise "bin/rake not found or not executable; ensure rake is installed via bundler"
+            raise "bin/rake and bin/yard not found or not executable; ensure rake and yard are installed via bundler"
           else
-            warn("bin/rake not found or not executable; ensure rake is installed via bundler")
+            warn("bin/rake and bin/yard not found or not executable; ensure rake and yard are installed via bundler")
             return
           end
         end
 
         begin
           # Run the canonical docs task to get the documentation percentage.
-          out, _ = Open3.capture2(cmd, "yard", {chdir: @root})
-          # Look for a line containing e.g., "95.35% documented"
-          line = out.lines.find { |l| /\d+(?:\.\d+)?%\s+documented/.match?(l) }
+          out = +""
+          commands.each do |command|
+            prepare_yard_fence_tmp_files if command == [File.join(@root, "bin", "yard")]
+            output, _status = Open3.capture2(*command, {chdir: @root})
+            out << output
+            line = documented_percent_line(output)
+            return line if line
+          end
 
-          if line
-            line.strip
-          elsif @strict
+          if @strict
             raise "Could not find documented percentage in bin/rake yard output"
           else
             warn("Could not find documented percentage in bin/rake yard output.")
@@ -632,6 +647,38 @@ module Kettle
         end
       end
 
+      def yard_documentation_commands
+        commands = []
+        rake = File.join(@root, "bin", "rake")
+        commands << [rake, "yard"] if File.executable?(rake)
+        yard = File.join(@root, "bin", "yard")
+        commands << [yard] if File.executable?(yard)
+        commands
+      end
+
+      def prepare_yard_fence_tmp_files
+        yardopts = File.join(@root, ".yardopts")
+        return unless File.file?(yardopts)
+        return unless File.read(yardopts).include?("tmp/yard-fence")
+
+        require "yard/fence"
+        outdir = File.join(@root, "tmp", "yard-fence")
+        FileUtils.rm_rf(outdir)
+        FileUtils.mkdir_p(outdir)
+        Dir.glob(File.join(@root, Yard::Fence::GLOB_PATTERN)).each do |src|
+          next unless File.file?(src)
+
+          content = File.read(src)
+          sanitized = Yard::Fence.sanitize_text(content)
+          File.write(File.join(outdir, File.basename(src)), sanitized)
+        end
+      end
+
+      def documented_percent_line(output)
+        line = output.lines.find { |l| /\d+(?:\.\d+)?%\s+documented/.match?(l) }
+        line&.strip
+      end
+
       # Transform legacy release headings that include a tag suffix, e.g.:
       #   "## [1.2.3] 2022-08-29 ([tag][1.2.3t])"
       # into a heading followed by a list item:

data/lib/kettle/dev/ci_helpers.rb

@@ -29,19 +29,13 @@ module Kettle
       end
 
       # Parse the GitHub owner/repo from the configured origin remote.
-      # Supports SSH (git@github.com:owner/repo(.git)) and HTTPS
-      # (https://github.com/owner/repo(.git)) forms.
+      # Supports SSH and HTTPS remote URL forms.
       # @return [Array(String, String), nil] [owner, repo] or nil when unavailable
       def repo_info
         out, status = Open3.capture2("git", "config", "--get", "remote.origin.url")
         return unless status.success?
 
-        url = out.strip
-        if url =~ %r{git@github.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://github.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        end
+        parse_hosted_repo(out.strip, "github.com")
       end
 
       # Current git branch name, or nil when not in a repository.
@@ -160,11 +154,7 @@ module Kettle
         url = origin_url
         return unless url
 
-        if url =~ %r{git@gitlab.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://gitlab.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        end
+        parse_hosted_repo(url, "gitlab.com")
       end
 
       # Default GitLab token from environment
@@ -243,6 +233,29 @@ module Kettle
       def gitlab_failed?(pipeline)
         pipeline && pipeline["status"] == "failed"
       end
+
+      # Parse owner/repo from common hosted Git remote URL shapes.
+      # @param url [String, nil]
+      # @param host [String]
+      # @return [Array(String, String), nil]
+      def parse_hosted_repo(url, host)
+        return unless url
+
+        if url =~ %r{\Agit@#{Regexp.escape(host)}:(.+?)/(.+?)(?:\.git)?\z}
+          return [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
+        end
+
+        uri = URI.parse(url)
+        return unless uri.host == host
+
+        path = uri.path.to_s.sub(%r{\A/}, "")
+        owner, repo = path.split("/", 2)
+        return unless owner && repo && !owner.empty? && !repo.empty?
+
+        [owner, repo.sub(/\.git\z/, "")]
+      rescue URI::InvalidURIError
+        nil
+      end
     end
   end
 end

data/lib/kettle/dev/ci_monitor.rb

@@ -410,15 +410,7 @@ module Kettle
       module_function :preferred_github_remote
 
       def parse_github_owner_repo(url)
-        return [nil, nil] unless url
-
-        if url =~ %r{git@github.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://github.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        else
-          [nil, nil]
-        end
+        Kettle::Dev::CIHelpers.parse_hosted_repo(url, "github.com") || [nil, nil]
       end
       module_function :parse_github_owner_repo
     end

data/lib/kettle/dev/release_cli.rb

@@ -791,15 +791,7 @@ module Kettle
       end
 
       def parse_github_owner_repo(url)
-        return [nil, nil] unless url
-
-        if url =~ %r{git@github.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://github.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        else
-          [nil, nil]
-        end
+        Kettle::Dev::CIHelpers.parse_hosted_repo(url, "github.com") || [nil, nil]
       end
 
       def has_remote?(name)

data/lib/kettle/dev/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Dev
     module Version
-      VERSION = "2.0.1"
+      VERSION = "2.0.2"
     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.1
+  version: 2.0.2
 platform: ruby
 authors:
 - Peter H. Boling
@@ -185,20 +185,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 2.0.0
   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.0
 description: "\U0001F372 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
@@ -312,10 +312,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.1
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.1/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.0.2
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.1
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.2
   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