kitchen-dokken 2.24.0 → 2.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1601bf73b8bb5607d0a279d1d06e3cc5779b581616159b320ee6737210b9bd1d
-  data.tar.gz: 7e92f8c54e09f5746905496fa9388b2fe49f0ec8d7a33f63ac461a0f53c07618
+  metadata.gz: c712b6533f76b28643283d228dad566b0cecc7ad856b0b2e8c0a37a7577f28ee
+  data.tar.gz: 7c84488e75a2d2c05029eea1d2d935d235d266742a0539456a28590bdd512a4b
 SHA512:
-  metadata.gz: f6fee7ac1a7586664f3e67047ad994a22c059f6782c99e737a1792dd3758c778f1c8bd3c6f79f6fe1406725dad6f3c1b8d297de1fb9630c4e326d67b23de5d2c
-  data.tar.gz: 1604d52bffac5be374ac62f2a509b584ff43303a5b6c98aed2ed0c1fdcdaa8ec9a8fc8ec17c65a8c56679574ff878452e6ee587ca5bf28e12e8a005f6d845d36
+  metadata.gz: f0ee27961e74995e48eff9725effcc2c47405bd02136a2adf1d58ab69cce9bf2109cecd12ecef71889a59db6a59845427ee2bc4b5c8d289cde5cf78a81bb9461
+  data.tar.gz: 767e8b79c3e2431605faa15a801a7e14d2507573b80483be4c46283bb29cd7818a80ca9c534acd8208d1ce1a0b0bcab5fe44c04df615de5d8bcda673b3ed3147

data/Gemfile

@@ -21,10 +21,9 @@ group :test do
 end
 
 group :development do
-  gem "pry"
   gem "yard" # `rake doc` -- documentation is not gated in CI
 end
 
 group :cookstyle do
-  gem "cookstyle", "~> 8.4"
+  gem "cookstyle", "~> 9.0"
 end

data/lib/kitchen/driver/dokken.rb

@@ -186,8 +186,54 @@ module Kitchen
         }
       end
 
+      # Checks the two things that stop a dokken run before it starts.
+      #
+      # @param state [Hash] mutable instance and driver state
+      # @return [Boolean] true when a problem was reported
+      def doctor(state) # rubocop:disable Lint/UnusedMethodArgument
+        problems = daemon_problems + creds_file_problems
+
+        problems.each { |problem| warn(problem) }
+        !problems.empty?
+      end
+
       private
 
+      # Confirms the docker daemon is actually reachable, which is the single
+      # most common reason a dokken run fails, and reports the version when it
+      # is so the answer is useful rather than merely green.
+      #
+      # @return [Array<String>] a connectivity problem, or an empty array
+      def daemon_problems
+        version = ::Docker.version(docker_connection)
+        info("docker daemon at #{config[:docker_host_url]} is reachable " \
+             "(version #{version["Version"]}, API #{version["ApiVersion"]})")
+        []
+      rescue ::StandardError => e
+        ["Could not reach the docker daemon at #{config[:docker_host_url]}: " \
+         "#{e.message}"]
+      end
+
+      # A configured creds_file that cannot be read or parsed fails inside
+      # +authenticate!+ on the first line of +create+, before anything is
+      # built, so it is worth catching here.
+      #
+      # @return [Array<String>] a credentials problem, or an empty array
+      def creds_file_problems
+        return [] if config[:creds_file].nil?
+
+        unless File.exist?(config[:creds_file])
+          return ["creds_file #{config[:creds_file]} does not exist."]
+        end
+
+        JSON.parse(IO.read(config[:creds_file]))
+        []
+      rescue JSON::ParserError => e
+        ["creds_file #{config[:creds_file]} is not valid JSON: #{e.message}"]
+      rescue ::StandardError => e
+        ["creds_file #{config[:creds_file]} could not be read: #{e.message}"]
+      end
+
       # Translate a container's `State` into kitchen's status shape.
       #
       # @param container [::Docker::Container] the runner container

data/lib/kitchen/driver/dokken_version.rb

@@ -18,6 +18,6 @@
 module Kitchen
   module Driver
     # Version string for Dokken Kitchen driver
-    DOKKEN_VERSION = "2.24.0".freeze
+    DOKKEN_VERSION = "2.25.0".freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kitchen-dokken
 version: !ruby/object:Gem::Version
-  version: 2.24.0
+  version: 2.25.0
 platform: ruby
 authors:
 - Sean OMeara
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-23 00:00:00.000000000 Z
+date: 2026-10-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: docker-api