test-kitchen 1.4.0.beta.2 → 1.4.0.rc.1

data/test-kitchen.gemspec

@@ -26,12 +26,11 @@ Gem::Specification.new do |gem|
   gem.add_dependency "mixlib-shellout", ">= 1.2", "< 3.0"
   gem.add_dependency "net-scp",         "~> 1.1"
   gem.add_dependency "net-ssh",         "~> 2.7"
-  gem.add_dependency "winrm",           "~> 1.3"
   gem.add_dependency "safe_yaml",       "~> 1.0"
   gem.add_dependency "thor",            "~> 0.18"
-  gem.add_dependency "rubyzip",         ">= 1.1.7", "~> 1.1"
 
   gem.add_development_dependency "pry"
+  gem.add_development_dependency "winrm-transport", "~> 1.0"
 
   gem.add_development_dependency "bundler",   "~> 1.3"
   gem.add_development_dependency "rake"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: test-kitchen
 version: !ruby/object:Gem::Version
-  version: 1.4.0.beta.2
+  version: 1.4.0.rc.1
 platform: ruby
 authors:
 - Fletcher Nichol
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-25 00:00:00.000000000 Z
+date: 2015-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mixlib-shellout
@@ -58,20 +58,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.7'
-- !ruby/object:Gem::Dependency
-  name: winrm
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: safe_yaml
   requirement: !ruby/object:Gem::Requirement
@@ -101,39 +87,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.18'
 - !ruby/object:Gem::Dependency
-  name: rubyzip
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.7
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-  type: :runtime
+        version: '0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.7
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: winrm-transport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -396,11 +376,6 @@ files:
 - lib/kitchen/transport/dummy.rb
 - lib/kitchen/transport/ssh.rb
 - lib/kitchen/transport/winrm.rb
-- lib/kitchen/transport/winrm/command_executor.rb
-- lib/kitchen/transport/winrm/file_transporter.rb
-- lib/kitchen/transport/winrm/logging.rb
-- lib/kitchen/transport/winrm/template.rb
-- lib/kitchen/transport/winrm/tmp_zip.rb
 - lib/kitchen/util.rb
 - lib/kitchen/verifier.rb
 - lib/kitchen/verifier/base.rb
@@ -443,11 +418,6 @@ files:
 - spec/kitchen/suite_spec.rb
 - spec/kitchen/transport/base_spec.rb
 - spec/kitchen/transport/ssh_spec.rb
-- spec/kitchen/transport/winrm/command_executor_spec.rb
-- spec/kitchen/transport/winrm/file_transporter_spec.rb
-- spec/kitchen/transport/winrm/logging_spec.rb
-- spec/kitchen/transport/winrm/template_spec.rb
-- spec/kitchen/transport/winrm/tmp_zip_spec.rb
 - spec/kitchen/transport/winrm_spec.rb
 - spec/kitchen/transport_spec.rb
 - spec/kitchen/util_spec.rb
@@ -460,7 +430,6 @@ files:
 - spec/support/powershell_max_size_spec.rb
 - support/busser_install_command.ps1
 - support/busser_install_command.sh
-- support/check_files.ps1.erb
 - support/chef-client-zero.rb
 - support/chef_base_init_command.ps1
 - support/chef_base_init_command.sh
@@ -468,7 +437,6 @@ files:
 - support/chef_base_install_command.sh
 - support/chef_zero_prepare_command_legacy.ps1
 - support/chef_zero_prepare_command_legacy.sh
-- support/decode_files.ps1.erb
 - support/download_helpers.sh
 - support/dummy-validation.pem
 - templates/driver/CHANGELOG.md.erb
@@ -565,11 +533,6 @@ test_files:
 - spec/kitchen/suite_spec.rb
 - spec/kitchen/transport/base_spec.rb
 - spec/kitchen/transport/ssh_spec.rb
-- spec/kitchen/transport/winrm/command_executor_spec.rb
-- spec/kitchen/transport/winrm/file_transporter_spec.rb
-- spec/kitchen/transport/winrm/logging_spec.rb
-- spec/kitchen/transport/winrm/template_spec.rb
-- spec/kitchen/transport/winrm/tmp_zip_spec.rb
 - spec/kitchen/transport/winrm_spec.rb
 - spec/kitchen/transport_spec.rb
 - spec/kitchen/util_spec.rb

data/lib/kitchen/transport/winrm/command_executor.rb

@@ -1,188 +0,0 @@
-# -*- encoding: utf-8 -*-
-#
-# Author:: Matt Wrock (<matt@mattwrock.com>)
-#
-# Copyright (C) 2014, Matt Wrock
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require "kitchen/transport/winrm/logging"
-
-module Kitchen
-
-  module Transport
-
-    class Winrm < Kitchen::Transport::Base
-
-      # Object which can execute multiple commands and Powershell scripts in
-      # one shared remote shell session. The maximum number of commands per
-      # shell is determined by interrogating the remote host when the session
-      # is opened and the remote shell is automatically recycled before the
-      # threshold is reached.
-      #
-      # @author Matt Wrock <matt@mattwrock.com>
-      # @author Fletcher Nichol <fnichol@nichol.ca>
-      class CommandExecutor
-
-        include Logging
-
-        # @return [Integer,nil] the safe maximum number of commands that can
-        #   be executed in one remote shell session, or `nil` if the
-        #   threshold has not yet been determined
-        attr_reader :max_commands
-
-        # @return [String,nil] the identifier for the current open remote
-        #   shell session, or `nil` if the session is not open
-        attr_reader :shell
-
-        # Creates a CommandExecutor given a `WinRM::WinRMWebService` object.
-        #
-        # @param service [WinRM::WinRMWebService] a winrm web service object
-        # @param logger [#debug,#info] an optional logger/ui object that
-        #   responds to `#debug` and `#info` (default: `nil`)
-        def initialize(service, logger = nil)
-          @service        = service
-          @logger         = logger
-          @command_count  = 0
-        end
-
-        # Closes the open remote shell session. This method can be called
-        # multiple times, even if there is no open session.
-        def close
-          return if shell.nil?
-
-          service.close_shell(shell)
-          @shell = nil
-        end
-
-        # Opens a remote shell session for reuse. The maxiumum
-        # command-per-shell threshold is also determined the first time this
-        # method is invoked and cached for later invocations.
-        #
-        # @return [String] the remote shell session indentifier
-        def open
-          close
-          @shell = service.open_shell
-          @command_count = 0
-          determine_max_commands unless max_commands
-          shell
-        end
-
-        # Runs a CMD command.
-        #
-        # @param command [String] the command to run on the remote system
-        # @param arguments [Array<String>] arguments to the command
-        # @yield [stdout, stderr] yields more live access the standard
-        #   output and standard error streams as they are returns, if
-        #   streaming behavior is desired
-        # @return [WinRM::Output] output object with stdout, stderr, and
-        #   exit code
-        def run_cmd(command, arguments = [], &block)
-          reset if command_count_exceeded?
-          ensure_open_shell!
-
-          @command_count += 1
-          result = nil
-          service.run_command(shell, command, arguments) do |command_id|
-            result = service.get_command_output(shell, command_id, &block)
-          end
-          result
-        end
-
-        # Run a Powershell script that resides on the local box.
-        #
-        # @param script_file [IO,String] an IO reference for reading the
-        #   Powershell script or the actual file contents
-        # @yield [stdout, stderr] yields more live access the standard
-        #   output and standard error streams as they are returns, if
-        #   streaming behavior is desired
-        # @return [WinRM::Output] output object with stdout, stderr, and
-        #   exit code
-        def run_powershell_script(script_file, &block)
-          # this code looks overly compact in an attempt to limit local
-          # variable assignments that may contain large strings and
-          # consequently bloat the Ruby VM
-          run_cmd(
-            "powershell",
-            [
-              "-encodedCommand",
-              WinRM::PowershellScript.new(
-                script_file.is_a?(IO) ? script_file.read : script_file
-              ).encoded
-            ],
-            &block
-          )
-        end
-
-        private
-
-        LEGACY_LIMIT = 15
-
-        MODERN_LIMIT = 1500
-
-        PS1_OS_VERSION = "[environment]::OSVersion.Version.tostring()".freeze
-
-        # @return [Integer] the number of executed commands on the remote
-        #   shell session
-        # @api private
-        attr_accessor :command_count
-
-        # @return [#debug,#info] the logger
-        # @api private
-        attr_reader :logger
-
-        # @return [WinRM::WinRMWebService] a WinRM web service object
-        # @api private
-        attr_reader :service
-
-        # @return [true,false] whether or not the number of exeecuted commands
-        #   have exceeded the maxiumum threshold
-        # @api private
-        def command_count_exceeded?
-          command_count > max_commands.to_i
-        end
-
-        # Ensures that there is an open remote shell session.
-        #
-        # @raise [WinRM::WinRMError] if there is no open shell
-        # @api private
-        def ensure_open_shell!
-          if shell.nil?
-            raise WinRM::WinRMError, "#{self.class}#open must be called " \
-              "before any run methods are invoked"
-          end
-        end
-
-        # Determines the safe maximum number of commands that can be executed
-        # on a remote shell session by interrogating the remote host.
-        #
-        # @api private
-        def determine_max_commands
-          os_version = run_powershell_script(PS1_OS_VERSION).stdout.chomp
-          @max_commands = os_version < "6.2" ? LEGACY_LIMIT : MODERN_LIMIT
-          @max_commands -= 2 # to be safe
-        end
-
-        # Closes the remote shell session and opens a new one.
-        #
-        # @api private
-        def reset
-          debug {
-            "Resetting WinRM shell (Max command limit is #{max_commands})"
-          }
-          open
-        end
-      end
-    end
-  end
-end

data/lib/kitchen/transport/winrm/file_transporter.rb

@@ -1,454 +0,0 @@
-# -*- encoding: utf-8 -*-
-#
-# Author:: Fletcher (<fnichol@nichol.ca>)
-#
-# Copyright (C) 2015, Fletcher Nichol
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require "benchmark"
-require "csv"
-require "digest"
-require "securerandom"
-require "stringio"
-
-require "kitchen/transport/winrm/logging"
-require "kitchen/transport/winrm/template"
-require "kitchen/transport/winrm/tmp_zip"
-
-module Kitchen
-
-  module Transport
-
-    class Winrm < Kitchen::Transport::Base
-
-      # Wrapped exception for any internally raised WinRM-related errors.
-      #
-      # @author Fletcher Nichol <fnichol@nichol.ca>
-      class FileTransporterFailed < ::WinRM::WinRMError; end
-
-      # Object which can upload one or more files or directories to a remote
-      # host over WinRM using PowerShell scripts and CMD commands. Note that
-      # this form of file transfer is *not* ideal and extremely costly on both
-      # the local and remote sides. Great pains are made to minimize round
-      # trips to  the remote host and to minimize the number of PowerShell
-      # sessions being invoked which can be 2 orders of magnitude more
-      # expensive than vanilla CMD commands.
-      #
-      # This object is supported by either a `WinRM::WinRMWebService` or
-      # `Winrm::CommandExecutor` instance as it depends on the `#run_cmd` and
-      # `#run_powershell_script` API contracts.
-      #
-      # An optional logger can be supplied, assuming it can respond to the
-      # `#debug` and `#debug?` messages.
-      #
-      # @author Fletcher Nichol <fnichol@nichol.ca>
-      # @author Matt Wrock <matt@mattwrock.com>
-      class FileTransporter
-
-        include Logging
-
-        # Creates a FileTransporter given a service object and optional logger.
-        # The service object may be a `WinRM::WinRMWebService` or
-        # `Winrm::CommandExecutor` instance.
-        #
-        # @param service [WinRM::WinRMWebService,Winrm::CommandExecutor] a
-        #   winrm web service object
-        # @param logger [#debug,#debug?] an optional logger/ui object that
-        #   responds to `#debug` and `#debug?` (default: `nil`)
-        def initialize(service, logger = nil, opts = {})
-          @service  = service
-          @logger   = logger
-          @id_generator = opts.fetch(:id_generator) { -> { SecureRandom.uuid } }
-        end
-
-        # Uploads a collection of files and/or directories to the remote host.
-        #
-        # **TODO Notes:**
-        # * options could specify zip mode, zip options, etc.
-        # * maybe option to set tmpfile base dir to override $env:PATH?
-        # * progress yields block like net-scp progress
-        # * final API: def upload(locals, remote, _options = {}, &_progress)
-        #
-        # @param locals [Array<String>,String] one or more local file or
-        #   directory paths
-        # @param remote [String] the base destination path on the remote host
-        # @return [Hash] report hash, keyed by the local MD5 digest
-        def upload(locals, remote)
-          files = nil
-
-          elapsed = Benchmark.measure do
-            files = make_files_hash(Array(locals), remote)
-
-            report = check_files(files)
-            merge_with_report!(files, report)
-
-            report = stream_upload_files(files)
-            merge_with_report!(files, report)
-
-            report = decode_files(files)
-            merge_with_report!(files, report)
-
-            cleanup(files)
-          end
-
-          debug {
-            "Uploaded #{files.keys.size} items " \
-            "in #{Util.duration(elapsed.real)}"
-          }
-
-          files
-        end
-
-        private
-
-        MAX_ENCODED_WRITE = 8000
-
-        BASE64_PACK = "m0".freeze
-
-        # @return [#debug,#debug?] the logger
-        # @api private
-        attr_reader :logger
-
-        # @return [WinRM::WinRMWebService,Winrm::CommandExecutor] a WinRM web
-        #   service object
-        # @api private
-        attr_reader :service
-
-        # Adds an entry to a files Hash (keyed by local MD5 digest) for a
-        # directory. When a directory is added, a temporary Zip file is created
-        # containing the contents of the directory and any file-related data
-        # such as MD5 digest, size, etc. will be referring to the Zip file.
-        #
-        # @param hash [Hash] hash to be mutated
-        # @param dir [String] directory path to be Zipped and added
-        # @param remote [String] path to destination on remote host
-        # @api private
-        def add_directory_hash!(hash, dir, remote)
-          zip_io = TmpZip.new(dir, logger)
-          zip_md5 = md5sum(zip_io.path)
-
-          hash[zip_md5] = {
-            "src"     => dir,
-            "src_zip" => zip_io.path.to_s,
-            "zip_io"  => zip_io,
-            "tmpzip"  => "$env:TEMP\\tmpzip-#{zip_md5}.zip",
-            "dst"     => remote,
-            "size"    => File.size(zip_io.path)
-          }
-        end
-
-        # Adds an entry to a files Hash (keyed by local MD5 digest) for a file.
-        #
-        # @param hash [Hash] hash to be mutated
-        # @param local [String] file path
-        # @param remote [String] path to destination on remote host
-        # @api private
-        def add_file_hash!(hash, local, remote)
-          hash[md5sum(local)] = {
-            "src"   => local,
-            "dst"   => "#{remote}\\#{File.basename(local)}",
-            "size"  => File.size(local)
-          }
-        end
-
-        # Runs the check_files PowerShell script against a collection of
-        # destination path/MD5 checksum pairs. The PowerShell script returns
-        # its results as a CSV-formatted report which is converted into a Ruby
-        # Hash.
-        #
-        # @param files [Hash] files hash, keyed by the local MD5 digest
-        # @return [Hash] a report hash, keyed by the local MD5 digest
-        # @api private
-        def check_files(files)
-          debug { "Running check_files.ps1" }
-          hash_file = create_remote_hash_file(check_files_ps_hash(files))
-          output = service.run_powershell_script(
-            check_files_template % { :hash_file => hash_file }
-          )
-          parse_response(output)
-        end
-
-        # Constructs a collection of destination path/MD5 checksum pairs as a
-        # String representation of the contents of a PowerShell Hash Table.
-        #
-        # @param files [Hash] files hash, keyed by the local MD5 digest
-        # @return [String] the inner contents of a PowerShell Hash Table
-        # @api private
-        def check_files_ps_hash(files)
-          ps_hash(Hash[
-            files.map { |md5, data| [data.fetch("tmpzip", data["dst"]), md5] }
-          ])
-        end
-
-        # @return [Template] an un-rendered template of the check_files
-        #   PowerShell script
-        # @api private
-        def check_files_template
-          @check_files_template ||= Template.new(File.join(
-            File.dirname(__FILE__),
-            %W[.. .. .. .. support check_files.ps1.erb]
-          ))
-        end
-
-        # Performs any final cleanup on the report Hash and removes any
-        # temporary files/resources used in the upload task.
-        #
-        # @param files [Hash] a files hash
-        # @api private
-        def cleanup(files)
-          files.select { |_, data| data.key?("zip_io") }.each do |md5, data|
-            data.fetch("zip_io").unlink
-            files.fetch(md5).delete("zip_io")
-            debug { "Cleaned up src_zip #{data["src_zip"]}" }
-          end
-        end
-
-        # Creates a remote Base64-encoded temporary file containing a
-        # PowerShell hash table.
-        #
-        # @param hash [String] a String representation of a PowerShell hash
-        #   table
-        # @return [String] the remote path to the temporary file
-        # @api private
-        def create_remote_hash_file(hash)
-          hash_file = "$env:TEMP\\hash-#{@id_generator.call}.txt"
-          hash.lines.each { |line| debug { line.chomp } }
-          StringIO.open(hash) { |io| stream_upload(io, hash_file) }
-          hash_file
-        end
-
-        # Runs the decode_files PowerShell script against a collection of
-        # temporary file/destination path pairs. The PowerShell script returns
-        # its results as a CSV-formatted report which is converted into a Ruby
-        # Hash. The script will not be invoked if there are no "dirty" files
-        # present in the incoming files Hash.
-        #
-        # @param files [Hash] files hash, keyed by the local MD5 digest
-        # @return [Hash] a report hash, keyed by the local MD5 digest
-        # @api private
-        def decode_files(files)
-          decoded_files = decode_files_ps_hash(files)
-
-          if decoded_files == ps_hash(Hash.new)
-            debug { "No remote files to decode, skipping" }
-            Hash.new
-          else
-            debug { "Running decode_files.ps1" }
-            hash_file = create_remote_hash_file(decoded_files)
-            output = service.run_powershell_script(
-              decode_files_template % { :hash_file => hash_file }
-            )
-            parse_response(output)
-          end
-        end
-
-        # Constructs a collection of temporary file/destination path pairs for
-        # all "dirty" files as a String representation of the contents of a
-        # PowerShell Hash Table. A "dirty" file is one which has the
-        # `"chk_dirty"` option set to `"True"` in the incoming files Hash.
-        #
-        # @param files [Hash] files hash, keyed by the local MD5 digest
-        # @return [String] the inner contents of a PowerShell Hash Table
-        # @api private
-        def decode_files_ps_hash(files)
-          result = files.select { |_, data| data["chk_dirty"] == "True" }.map { |_, data|
-            val = { "dst" => data["dst"] }
-            val["tmpzip"] = data["tmpzip"] if data["tmpzip"]
-
-            [data["tmpfile"], val]
-          }
-
-          ps_hash(Hash[result])
-        end
-
-        # @return [Template] an un-rendered template of the decode_files
-        #   PowerShell script
-        # @api private
-        def decode_files_template
-          @decode_files_template ||= Template.new(File.join(
-            File.dirname(__FILE__),
-            %W[.. .. .. .. support decode_files.ps1.erb]
-          ))
-        end
-
-        # Contructs a Hash of files or directories, keyed by the local MD5
-        # digest. Each file entry has a source and destination set, at a
-        # minimum.
-        #
-        # @param locals [Array<String>] a collection of local files or
-        #   directories
-        # @param remote [String] the base destination path on the remote host
-        # @return [Hash] files hash, keyed by the local MD5 digest
-        # @api private
-        def make_files_hash(locals, remote)
-          hash = Hash.new
-          locals.each do |local|
-            expanded = File.expand_path(local)
-            expanded += local[-1] if local.end_with?("/", "\\")
-
-            if File.file?(expanded)
-              add_file_hash!(hash, expanded, remote)
-            elsif File.directory?(expanded)
-              add_directory_hash!(hash, expanded, remote)
-            else
-              raise Errno::ENOENT, "No such file or directory #{expanded}"
-            end
-          end
-          hash
-        end
-
-        # @return [String] the MD5 digest of a local file
-        # @api private
-        def md5sum(local)
-          Digest::MD5.file(local).hexdigest
-        end
-
-        # Destructively merges a report Hash into an existing files Hash.
-        # **Note:** this method mutates the files Hash.
-        #
-        # @param files [Hash] files hash, keyed by the local MD5 digest
-        # @param report [Hash] report hash, keyed by the local MD5 digest
-        # @api private
-        def merge_with_report!(files, report)
-          files.merge!(report) { |_, oldval, newval| oldval.merge(newval) }
-        end
-
-        # @param depth [Integer] number of padding characters (default: `0`)
-        # @return [String] a whitespace padded string of the given length
-        # @api private
-        def pad(depth = 0)
-          " " * depth
-        end
-
-        # Parses response of a PowerShell script or CMD command which contains
-        # a CSV-formatted document in the standard output stream.
-        #
-        # @param output [WinRM::Output] output object with stdout, stderr, and
-        #   exit code
-        # @return [Hash] report hash, keyed by the local MD5 digest
-        # @api private
-        def parse_response(output)
-          if output[:exitcode] != 0
-            raise FileTransporterFailed, "[#{self.class}] Upload failed " \
-              "(exitcode: #{output[:exitcode]})\n#{output.stderr}"
-          end
-          array = CSV.parse(output.stdout, :headers => true).map(&:to_hash)
-          array.each { |h| h.each { |key, value| h[key] = nil if value == "" } }
-          Hash[array.map { |entry| [entry.fetch("src_md5"), entry] }]
-        end
-
-        # Converts a Ruby hash into a PowerShell hash table, represented in a
-        # String.
-        #
-        # @param obj [Object] source Hash or object when used in recursive
-        #   calls
-        # @param depth [Integer] padding depth, used in recursive calls
-        #   (default: `0`)
-        # @return [String] a PowerShell hash table
-        # @api private
-        def ps_hash(obj, depth = 0)
-          if obj.is_a?(Hash)
-            obj.map { |k, v|
-              %{#{pad(depth + 2)}#{ps_hash(k)} = #{ps_hash(v, depth + 2)}}
-            }.join("\n").insert(0, "@{\n").insert(-1, "\n#{pad(depth)}}")
-          else
-            %{"#{obj}"}
-          end
-        end
-
-        # Uploads an IO stream to a Base64-encoded destination file.
-        #
-        # **Implementation Note:** Some of the code in this method may appear
-        # slightly too dense and while adding additional variables would help,
-        # the code is written very precisely to avoid unwanted allocations
-        # which will bloat the Ruby VM's object space (and memory footprint).
-        # The goal here is to stream potentially large files to a remote host
-        # while not loading the entire file into memory first, then Base64
-        # encoding it--duplicating the file in memory again.
-        #
-        # @param input_io [#read] a readable stream or object to be uploaded
-        # @param dest [String] path to the destination file on the remote host
-        # @return [Integer,Integer] the number of resulting upload chunks and
-        #   the number of bytes transferred to the remote host
-        # @api private
-        def stream_upload(input_io, dest)
-          dest_cmd = dest.sub("$env:TEMP", "%TEMP%")
-          read_size = (MAX_ENCODED_WRITE.to_i / 4) * 3
-          chunk, bytes = 1, 0
-          buffer = ""
-          service.run_cmd(%{echo|set /p=>"#{dest_cmd}"}) # truncate empty file
-          while input_io.read(read_size, buffer)
-            bytes += (buffer.bytesize / 3 * 4)
-            service.run_cmd([buffer].pack(BASE64_PACK).
-              insert(0, "echo ").concat(%{ >> "#{dest_cmd}"}))
-            debug { "Wrote chunk #{chunk} for #{dest}" } if chunk % 25 == 0
-            chunk += 1
-          end
-          buffer = nil # rubocop:disable Lint/UselessAssignment
-
-          [chunk - 1, bytes]
-        end
-
-        # Uploads a local file to a Base64-encoded temporary file.
-        #
-        # @param src [String] path to a local file
-        # @param tmpfile [String] path to the temporary file on the remote
-        #   host
-        # @return [Integer,Integer] the number of resulting upload chunks and
-        #   the number of bytes transferred to the remote host
-        # @api private
-        def stream_upload_file(src, tmpfile)
-          debug { "Uploading #{src} to encoded tmpfile #{tmpfile}" }
-          chunks, bytes = 0, 0
-          elapsed = Benchmark.measure do
-            File.open(src, "rb") do |io|
-              chunks, bytes = stream_upload(io, tmpfile)
-            end
-          end
-          debug {
-            "Finished uploading #{src} to encoded tmpfile #{tmpfile} " \
-            "(#{bytes.to_f / 1000} KB over #{chunks} chunks) " \
-            "in #{Util.duration(elapsed.real)}"
-          }
-
-          [chunks, bytes]
-        end
-
-        # Uploads a collection of "dirty" files to the remote host as
-        # Base64-encoded temporary files. A "dirty" file is one which has the
-        # `"chk_dirty"` option set to `"True"` in the incoming files Hash.
-        #
-        # @param files [Hash] files hash, keyed by the local MD5 digest
-        # @return [Hash] a report hash, keyed by the local MD5 digest
-        # @api private
-        def stream_upload_files(files)
-          response = Hash.new
-          files.each do |md5, data|
-            src = data.fetch("src_zip", data["src"])
-            if data["chk_dirty"] == "True"
-              tmpfile = "$env:TEMP\\b64-#{md5}.txt"
-              response[md5] = { "tmpfile" => tmpfile }
-              chunks, bytes = stream_upload_file(src, tmpfile)
-              response[md5]["chunks"] = chunks
-              response[md5]["xfered"] = bytes
-            else
-              debug { "File #{data["dst"]} is up to date, skipping" }
-            end
-          end
-          response
-        end
-      end
-    end
-  end
-end