kettle-dev 2.2.9 → 2.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bee699f7f3622c9ae1e63f19cec10ec46a54fe67bd97869169b309bbbcb4bb2
-  data.tar.gz: '099d1ddeab902593baa43b8a1fe6de1b899f1ab3bdff9bd6ddba3363d5627b02'
+  metadata.gz: 9216115bc5448b3e08cfcd393c22029d70e7b6d31bcb80617b44b7d97644b649
+  data.tar.gz: e86c38ac97fbac63e1258bf15d6454f408e62ffe927af628bc5f7090472f98fd
 SHA512:
-  metadata.gz: 7af3f2c8a7a278416c97a9a006d4a45946c371fcf75d11f9e6dc29b2a29fbc629fa53fb647cc3fbab0b7a18436dd4ecfa1139fcb993f51c89c798c7f3e95a6c0
-  data.tar.gz: 78c1377327823ab8ae01bb76f4e318fc501fc0ba8e3c60ffc95dc661a68853a338bc501c9ea631992ea6cc7bf5b31b74865ed3a503770c6c9223e253ece33403
+  metadata.gz: 52d369f7c70a48bf3c2fde5898cc7f99ac9eda0b6e09319d7166976e20057d95360a56f29bf00dbd226976a853dd212e915fd31026b7c647df1f68bee6331cd4
+  data.tar.gz: 7ab61300d6f489ddc25636e10dcea667998a20c5ef3755a9b7773e2ccb0fde69871c8ba5607303a618501a55c2c05289dc3585905c6243e1ca524a7de1cb7c8a

data/CHANGELOG.md

@@ -30,6 +30,19 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.2.10] - 2026-06-16
+
+- TAG: [v2.2.10][2.2.10t]
+- COVERAGE: 92.24% -- 3911/4240 lines in 28 files
+- BRANCH COVERAGE: 73.87% -- 1552/2101 branches in 28 files
+- 64.35% documented
+
+### Changed
+
+- `kettle-pre-release` now caches successful Markdown image URL validations in
+  the global kettle-dev state cache for seven days to avoid repeated network
+  HEAD requests during release readiness checks.
+
 ## [2.2.9] - 2026-06-14
 
 - TAG: [v2.2.9][2.2.9t]
@@ -2126,7 +2139,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-dev/kettle-dev/compare/v2.2.9...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.10...HEAD
+[2.2.10]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.9...v2.2.10
+[2.2.10t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.10
 [2.2.9]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.8...v2.2.9
 [2.2.9t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.9
 [2.2.8]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.7...v2.2.8

data/README.md

@@ -854,7 +854,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-4.173-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.240-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/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

data/lib/kettle/dev/pre_release_cli.rb

@@ -2,9 +2,12 @@
 
 require "optparse"
 require "English"
+require "json"
+require "fileutils"
 require "uri"
 require "net/http"
 require "openssl"
+require "time"
 begin
   require "addressable/uri"
 rescue LoadError
@@ -21,6 +24,8 @@ module Kettle
     #
     # Usage: Kettle::Dev::PreReleaseCLI.new(check_num: 1).run
     class PreReleaseCLI
+      IMAGE_URL_CACHE_TTL_SECONDS = 7 * 24 * 60 * 60
+
       # Simple HTTP helpers for link validation
       module HTTP
         module_function
@@ -93,6 +98,85 @@ module Kettle
         end
       end
 
+      # Persistent cache of successfully validated Markdown image URLs.
+      class ImageUrlCache
+        VERSION = 1
+
+        def self.default_path
+          state_home = ENV["XDG_STATE_HOME"]
+          state_home = File.join(Dir.home, ".local", "state") if state_home.to_s.empty?
+          File.join(state_home, "kettle-dev", "image-url-cache.json")
+        rescue ArgumentError
+          nil
+        end
+
+        def initialize(path:, ttl_seconds: IMAGE_URL_CACHE_TTL_SECONDS, clock: -> { Time.now })
+          @path = path
+          @ttl_seconds = ttl_seconds
+          @clock = clock
+          @data = nil
+        end
+
+        def fresh_success?(url)
+          entry = data.fetch("images")[url.to_s]
+          return false unless entry.is_a?(Hash)
+          return false unless entry["ok"] == true
+
+          fresh_entry?(entry)
+        end
+
+        def write_success(url)
+          return if @path.to_s.empty?
+          return if url.to_s.empty?
+
+          data.fetch("images")[url.to_s] = {
+            "ok" => true,
+            "cached_at" => @clock.call.utc.iso8601
+          }
+          save!
+        end
+
+        def to_h
+          data
+        end
+
+        private
+
+        def data
+          @data ||= load_data
+        end
+
+        def load_data
+          parsed = if @path && File.file?(@path)
+            JSON.parse(File.read(@path))
+          end
+          return empty_data unless parsed.is_a?(Hash)
+          return empty_data unless parsed["version"].to_i == VERSION
+
+          parsed["version"] ||= VERSION
+          parsed["images"] = {} unless parsed["images"].is_a?(Hash)
+          parsed
+        rescue JSON::ParserError, Errno::EACCES
+          empty_data
+        end
+
+        def empty_data
+          {"version" => VERSION, "images" => {}}
+        end
+
+        def save!
+          FileUtils.mkdir_p(File.dirname(@path))
+          File.write(@path, JSON.pretty_generate(data) + "\n")
+        end
+
+        def fresh_entry?(entry)
+          cached_at = Time.iso8601(entry["cached_at"].to_s)
+          cached_at >= @clock.call - @ttl_seconds
+        rescue ArgumentError
+          false
+        end
+      end
+
       # Markdown parsing helpers
       module Markdown
         module_function
@@ -184,6 +268,8 @@ module Kettle
       def initialize(check_num: 1)
         @check_num = (check_num || 1).to_i
         @check_num = 1 if @check_num < 1
+        @image_url_cache_path = configured_image_url_cache_path
+        @refresh_image_url_cache = env_truthy?(ENV["KETTLE_IMAGE_URL_CACHE_REFRESH"])
       end
 
       # Execute configured checks starting from @check_num.
@@ -272,12 +358,19 @@ module Kettle
         puts "[kettle-pre-release] Check 3: Validate Markdown image links (HTTP HEAD)"
         urls = Markdown.extract_image_urls_from_files
         puts "[kettle-pre-release] Found #{urls.size} unique image URL(s)."
+        cache = image_url_cache
         failures = []
         urls.each do |url|
           print("  -> #{url} … ")
+          if cache && !@refresh_image_url_cache && cache.fresh_success?(url)
+            puts "OK (cached)"
+            next
+          end
+
           ok = HTTP.head_ok?(url)
           if ok
             puts "OK"
+            cache&.write_success(url)
           else
             puts "FAIL"
             failures << url
@@ -292,6 +385,26 @@ module Kettle
         end
         nil
       end
+
+      private
+
+      def image_url_cache
+        return nil if @image_url_cache_path.to_s.empty?
+
+        @image_url_cache ||= ImageUrlCache.new(path: @image_url_cache_path)
+      end
+
+      def configured_image_url_cache_path
+        value = ENV.fetch("KETTLE_IMAGE_URL_CACHE", nil)
+        return ImageUrlCache.default_path if value.nil? || value.to_s.strip.empty?
+        return nil if value.to_s.strip.match?(Kettle::Dev::ENV_FALSE_RE)
+
+        value
+      end
+
+      def env_truthy?(value)
+        !!value.to_s.strip.match?(/\A(true|y|yes|1|on)\z/i)
+      end
     end
   end
 end

data/lib/kettle/dev/version.rb

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

data/sig/kettle/dev/pre_release_cli.rbs

@@ -11,6 +11,16 @@ module Kettle
         def self.extract_image_urls_from_files: (?String glob_pattern) -> Array[String]
       end
 
+      class ImageUrlCache
+        VERSION: Integer
+
+        def self.default_path: () -> String?
+        def initialize: (path: String?, ?ttl_seconds: Integer, ?clock: ^() -> Time) -> void
+        def fresh_success?: (String url) -> bool
+        def write_success: (String url) -> void
+        def to_h: () -> Hash[String, untyped]
+      end
+
       def initialize: (?check_num: Integer) -> void
       def run: () -> void
       def check_markdown_uri_normalization!: () -> void

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.2.9
+  version: 2.2.10
 platform: ruby
 authors:
 - Peter H. Boling
@@ -338,10 +338,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.2.9
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.9/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.2.10
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.10/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.9
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.10
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev