test-kitchen 4.1.2 → 4.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a2d33ad099262a074eb6c0d0a7e76f86d7e4f06d8400263390569e5ca464bcde
-  data.tar.gz: 3bbbe927caee591ad59ae92c676bda2066e2c27730f8f522ef9d7aad6cf5e48a
+  metadata.gz: 35bb40be8e39ac171865c0bd23300293032f6558dbb62d788efcb1441dbbe66c
+  data.tar.gz: d9d9be6360a468f2cd55958e37a21a1f0b1ffa4435a0eb53dc84dae07a219369
 SHA512:
-  metadata.gz: 56befe75562ba39e8e1b5c35e6827fe5fe44c34a62f8bffd02d0b2dbbf80671e269926bcf578c20c4bfcae0ff282616c50e87b2f3d6a0aeb89b1c0f8ab8440aa
-  data.tar.gz: eb059e0f0f76ef6ce30ba1dbd9b09ab28dae4314ac67c83e060a200e7974d26a814e745a2626133a926d2a37f133e1f4d8c46e0ab95597d034eb837f7f3bfe55
+  metadata.gz: 75dce025d9f85c60bb7b07cbc30f809d864eb2cdbf562557e9511376c050ae1b41f488ed3640dddf11c4664fa91ab5a048a7e5d434d0c1172195eaa055289276
+  data.tar.gz: dda50545d44c4c3522f28df5dd89eeeefb1356d3e349abfc22f0899ced79ed58b7eaa300a764a239e182ecec384dc8a39e76ad27cbf5e86dba48c8efbf0c63ea

data/lib/kitchen/base64_stream.rb

@@ -28,7 +28,7 @@ module Kitchen
     # @param io_in [#read] input stream
     # @param io_out [#write] output stream
     def self.strict_encode(io_in, io_out)
-      buffer = ""
+      buffer = +"" # mutable: IO#read writes into this buffer
       io_out.write([buffer].pack("m0")) while io_in.read(3 * 1000, buffer)
       buffer = nil # rubocop:disable Lint/UselessAssignment
     end
@@ -40,7 +40,7 @@ module Kitchen
     # @param io_in [#read] input stream
     # @param io_out [#write] output stream
     def self.strict_decode(io_in, io_out)
-      buffer = ""
+      buffer = +"" # mutable: IO#read writes into this buffer
       io_out.write(buffer.unpack("m0").first) while io_in.read(3 * 1000, buffer)
       buffer = nil # rubocop:disable Lint/UselessAssignment
     end

data/lib/kitchen/configurable.rb

@@ -247,7 +247,7 @@ module Kitchen
       @deprecated_config = deprecated_attributes.delete_if { |attr, obj| !provided_config.key?(attr) || obj.nil? }
 
       unless deprecated_config.empty?
-        warning = Util.outdent!(<<-MSG)
+        warning = Util.outdent(<<-MSG)
           Deprecated configuration detected:
           #{deprecated_config.keys.join("\n")}
           Run 'kitchen doctor' for details.

data/lib/kitchen/instance.rb

@@ -20,6 +20,8 @@ require "fileutils" unless defined?(FileUtils)
 require "securerandom" unless defined?(SecureRandom)
 require "time" unless defined?(Time.zone_offset)
 
+require_relative "logging"
+
 module Kitchen
   # An instance of a suite running on a platform. A created instance may be a
   # local virtual machine, cloud instance, container, or even a bare metal

data/lib/kitchen/provisioner/shell.rb

@@ -62,7 +62,7 @@ module Kitchen
         data = remote_path_join(root, "data")
 
         code = if powershell_shell?
-                 Util.outdent!(<<-POWERSHELL)
+                 Util.outdent(<<-POWERSHELL)
             if (Test-Path "#{data}") {
               Remove-Item "#{data}" -Recurse -Force
             }

data/lib/kitchen/shell_out.rb

@@ -17,6 +17,8 @@
 
 require "mixlib/shellout" unless defined?(Mixlib::ShellOut)
 
+require_relative "errors" # for TransientFailure
+
 module Kitchen
   # Mixin that wraps a command shell out invocation, providing a #run_command
   # method.

data/lib/kitchen/transport/winrm.rb

@@ -247,7 +247,7 @@ module Kitchen
         #   Mac system
         # @api private
         def create_rdp_doc(opts = {})
-          content = Util.outdent!(<<-RDP)
+          content = Util.outdent(<<-RDP)
             full address:s:#{URI.parse(options[:endpoint]).host}:#{rdp_port}
             prompt for credentials:i:1
             username:s:#{options[:user]}

data/lib/kitchen/util.rb

@@ -24,6 +24,17 @@ module Kitchen
   #
   # @author Fletcher Nichol <fnichol@nichol.ca>
   module Util
+    class << self
+      # @return [Mutex] a mutex used to serialize the process-global Dir.chdir
+      attr_accessor :mutex_chdir
+    end
+
+    # Dir.chdir mutates process-global state, so every call has to be
+    # serialized. The mutex is owned here rather than in lib/kitchen.rb
+    # because Util is its only consumer and has to keep working when
+    # "kitchen/util" is required on its own.
+    @mutex_chdir = Mutex.new
+
     # Returns the standard library Logger level constants for a given symbol
     # representation.
     #
@@ -146,6 +157,22 @@ module Kitchen
       string.gsub!(/^ {#{string.index(/[^ ]/)}}/, "")
     end
 
+    # Returns a copy of a string with each line outdented by the indentation
+    # level of its first line.
+    #
+    # Prefer this over {.outdent!} when the input may be a string literal:
+    # Ruby 4 freezes literals, and mutating one raises a FrozenError.
+    #
+    # @param string [String] the string to outdent
+    # @return [String] a new, outdented string
+    # @example
+    #
+    #   string = "    a\n      b\n    c\n"
+    #   Util.outdent(string) # => "a\n  b\nc\n"
+    def self.outdent(string)
+      string.gsub(/^ {#{string.index(/[^ ]/)}}/, "")
+    end
+
     # Returns a set of Bourne Shell (AKA /bin/sh) compatible helper
     # functions. This function is usually called inline in a string that
     # will be executed remotely on a test instance.
@@ -178,7 +205,7 @@ module Kitchen
       # the directory does not exist
       return [] unless Dir.exist?(path)
 
-      Kitchen.mutex_chdir.synchronize do
+      mutex_chdir.synchronize do
         Dir.chdir(path) do
           glob_pattern = if recurse
                            "**/*"
@@ -214,7 +241,7 @@ module Kitchen
     def self.safe_glob(path, pattern, *flags)
       return [] unless Dir.exist?(path)
 
-      Kitchen.mutex_chdir.synchronize do
+      mutex_chdir.synchronize do
         Dir.chdir(path) do
           Dir.glob(pattern, *flags).map { |f| File.join(path, f) }
         end

data/lib/kitchen/verifier/busser.rb

@@ -72,7 +72,7 @@ module Kitchen
         cmd = sudo(config[:busser_bin]).dup
           .tap { |str| str.insert(0, "& ") if powershell_shell? }
 
-        prefix_command(wrap_shell_code(Util.outdent!(<<-CMD)))
+        prefix_command(wrap_shell_code(Util.outdent(<<-CMD)))
           #{busser_env}
 
           #{cmd} suite cleanup
@@ -95,7 +95,7 @@ module Kitchen
         cmd = sudo(config[:busser_bin]).dup
           .tap { |str| str.insert(0, "& ") if powershell_shell? }
 
-        prefix_command(wrap_shell_code(Util.outdent!(<<-CMD)))
+        prefix_command(wrap_shell_code(Util.outdent(<<-CMD)))
           #{busser_env}
 
           #{cmd} test #{plugins.join(" ").gsub!("busser-", "")}

data/lib/kitchen/version.rb

@@ -19,5 +19,5 @@ module Kitchen
   # The currently released version of Test Kitchen.
   #
   # @return [String] a semantic version string
-  VERSION = "4.1.2".freeze
+  VERSION = "4.1.3".freeze
 end

data/lib/kitchen.rb

@@ -57,8 +57,23 @@ module Kitchen
     # @return [Mutex] a common mutex for global coordination
     attr_accessor :mutex
 
+    # Returns the mutex used for Dir.chdir coordination.
+    #
     # @return [Mutex] a mutex used for Dir.chdir coordination
-    attr_accessor :mutex_chdir
+    # @deprecated Use {Kitchen::Util.mutex_chdir}, which owns the mutex and is
+    #   available without loading all of Test Kitchen.
+    def mutex_chdir
+      Kitchen::Util.mutex_chdir
+    end
+
+    # Sets the mutex used for Dir.chdir coordination.
+    #
+    # @param mutex [Mutex] the mutex to use for Dir.chdir coordination
+    # @return [Mutex] the newly set mutex
+    # @deprecated Use {Kitchen::Util.mutex_chdir=}.
+    def mutex_chdir=(mutex)
+      Kitchen::Util.mutex_chdir = mutex
+    end
 
     # @return [String] identifier for the current Kitchen process invocation
     attr_writer :run_id
@@ -164,6 +179,3 @@ Kitchen.logger = Kitchen.default_logger
 
 # Set up a collection of instance crash exceptions for error reporting
 Kitchen.mutex = Mutex.new
-
-# Initialize the mutex for Dir.chdir coordination
-Kitchen.mutex_chdir = Mutex.new

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: test-kitchen
 version: !ruby/object:Gem::Version
-  version: 4.1.2
+  version: 4.1.3
 platform: ruby
 authors:
 - Fletcher Nichol
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-23 00:00:00.000000000 Z
+date: 2026-08-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bcrypt_pbkdf