test-kitchen 1.3.1 → 1.4.0.beta.1

data/spec/kitchen/transport_spec.rb

@@ -0,0 +1,112 @@
+# -*- 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_relative "../spec_helper"
+
+require "kitchen/configurable"
+require "kitchen/errors"
+require "kitchen/logging"
+require "kitchen/transport"
+require "kitchen/transport/base"
+
+module Kitchen
+
+  module Transport
+
+    class Coolbeans < Kitchen::Transport::Base
+    end
+
+    class ItDepends < Kitchen::Transport::Base
+
+      attr_reader :verify_call_count
+
+      def initialize(config = {})
+        @verify_call_count = 0
+        super
+      end
+
+      def verify_dependencies
+        @verify_call_count += 1
+      end
+    end
+
+    class UnstableDepends < Kitchen::Transport::Base
+
+      def verify_dependencies
+        raise UserError, "Oh noes, you don't have software!"
+      end
+    end
+  end
+end
+
+describe Kitchen::Transport do
+
+  describe ".for_plugin" do
+
+    before do
+      Kitchen::Transport.stubs(:require).returns(true)
+    end
+
+    it "returns a transport object of the correct class" do
+      transport = Kitchen::Transport.for_plugin("coolbeans", {})
+
+      transport.must_be_kind_of Kitchen::Transport::Coolbeans
+    end
+
+    it "returns a transport initialized with its config" do
+      transport = Kitchen::Transport.for_plugin("coolbeans", :foo => "bar")
+
+      transport[:foo].must_equal "bar"
+    end
+
+    it "calls #verify_dependencies on the transport object" do
+      transport = Kitchen::Transport.for_plugin("it_depends", {})
+
+      transport.verify_call_count.must_equal 1
+    end
+
+    it "calls #verify_dependencies once per transport require" do
+      Kitchen::Transport.stubs(:require).returns(true, false)
+      transport1 = Kitchen::Transport.for_plugin("it_depends", {})
+      transport1.verify_call_count.must_equal 1
+      transport2 = Kitchen::Transport.for_plugin("it_depends", {})
+
+      transport2.verify_call_count.must_equal 0
+    end
+
+    it "raises ClientError if the transport could not be required" do
+      Kitchen::Transport.stubs(:require).raises(LoadError)
+
+      proc { Kitchen::Transport.for_plugin("coolbeans", {}) }.
+        must_raise Kitchen::ClientError
+    end
+
+    it "raises ClientError if the transport's class constant was not found" do
+      # pretend require worked
+      Kitchen::Transport.stubs(:require).returns(true)
+
+      proc { Kitchen::Transport.for_plugin("nope", {}) }.
+        must_raise Kitchen::ClientError
+    end
+
+    it "raises UserError if #verify_dependencies failes" do
+      proc { Kitchen::Transport.for_plugin("unstable_depends", {}) }.
+        must_raise Kitchen::UserError
+    end
+  end
+end

data/spec/kitchen/verifier/base_spec.rb

@@ -0,0 +1,310 @@
+# -*- encoding: utf-8 -*-
+#
+# Author:: Fletcher Nichol (<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_relative "../../spec_helper"
+
+require "logger"
+require "stringio"
+
+require "kitchen/verifier/base"
+require "kitchen/transport/base"
+
+module Kitchen
+
+  module Verifier
+
+    class TestingDummy < Kitchen::Verifier::Base
+
+      attr_reader :called_create_sandbox, :called_cleanup_sandbox
+
+      def install_command
+        "install"
+      end
+
+      def init_command
+        "init"
+      end
+
+      def prepare_command
+        "prepare"
+      end
+
+      def run_command
+        "run"
+      end
+
+      def create_sandbox
+        @called_create_sandbox = true
+      end
+
+      def cleanup_sandbox
+        @called_cleanup_sandbox = true
+      end
+
+      def sandbox_path
+        "/tmp/sandbox"
+      end
+    end
+  end
+end
+
+describe Kitchen::Verifier::Base do
+
+  let(:logged_output)   { StringIO.new }
+  let(:logger)          { Logger.new(logged_output) }
+  let(:platform)        { stub(:os_type => nil, :shell_type => nil) }
+  let(:suite)           { stub(:name => "germany") }
+  let(:config)          { Hash.new }
+
+  let(:transport) do
+    t = mock("transport")
+    t.responds_like_instance_of(Kitchen::Transport::Base)
+    t
+  end
+
+  let(:instance) do
+    stub(
+      :name => "coolbeans",
+      :to_str => "instance",
+      :logger => logger,
+      :platform => platform,
+      :suite => suite,
+      :transport => transport
+    )
+  end
+
+  let(:verifier) do
+    Kitchen::Verifier::Base.new(config).finalize_config!(instance)
+  end
+
+  describe "configuration" do
+
+    describe "for unix operating systems" do
+
+      before { platform.stubs(:os_type).returns("unix") }
+
+      it ":sudo defaults to true" do
+        verifier[:sudo].must_equal true
+      end
+
+      it ":root_path defaults to '/tmp/verifier'" do
+        verifier[:root_path].must_equal "/tmp/verifier"
+      end
+    end
+
+    describe "for windows operating systems" do
+
+      before { platform.stubs(:os_type).returns("windows") }
+
+      it ":sudo defaults to nil" do
+        verifier[:sudo].must_equal nil
+      end
+
+      it ":root_path defaults to $env:TEMP\\verifier" do
+        verifier[:root_path].must_equal "$env:TEMP\\verifier"
+      end
+    end
+
+    it ":suite_name defaults to the passed in suite name" do
+      verifier[:suite_name].must_equal "germany"
+    end
+
+    it ":http_proxy defaults to nil" do
+      verifier[:http_proxy].must_equal nil
+    end
+
+    it ":http_proxys defaults to nil" do
+      verifier[:https_proxy].must_equal nil
+    end
+  end
+
+  describe "#call" do
+
+    let(:state) { Hash.new }
+    let(:cmd)   { verifier.call(state) }
+
+    let(:connection) do
+      c = mock("transport_connection")
+      c.responds_like_instance_of(Kitchen::Transport::Base::Connection)
+      c
+    end
+
+    let(:verifier) do
+      Kitchen::Verifier::TestingDummy.new(config).finalize_config!(instance)
+    end
+
+    before do
+      FakeFS.activate!
+      FileUtils.mkdir_p(File.join(verifier.sandbox_path, "stuff"))
+      transport.stubs(:connection).yields(connection)
+      connection.stubs(:execute)
+      connection.stubs(:upload)
+    end
+
+    after do
+      FakeFS.deactivate!
+      FakeFS::FileSystem.clear
+    end
+
+    it "creates the sandbox" do
+      verifier.expects(:create_sandbox)
+
+      cmd
+    end
+
+    it "ensures that the sandbox is cleanup up" do
+      transport.stubs(:connection).raises
+      verifier.expects(:cleanup_sandbox)
+
+      begin
+        cmd
+      rescue # rubocop:disable Lint/HandleExceptions
+      end
+    end
+
+    it "yields a connection given the state" do
+      state[:a] = "b"
+      transport.expects(:connection).with(state).yields(connection)
+
+      cmd
+    end
+
+    it "invokes the verifier commands over the transport" do
+      order = sequence("order")
+      connection.expects(:execute).with("install").in_sequence(order)
+      connection.expects(:execute).with("init").in_sequence(order)
+      connection.expects(:execute).with("prepare").in_sequence(order)
+      connection.expects(:execute).with("run").in_sequence(order)
+
+      cmd
+    end
+
+    it "logs to info" do
+      cmd
+
+      logged_output.string.
+        must_match(/INFO -- : Transferring files to instance$/)
+    end
+
+    it "uploads sandbox files" do
+      connection.expects(:upload).with(["/tmp/sandbox/stuff"], "/tmp/verifier")
+
+      cmd
+    end
+
+    it "logs to debug" do
+      cmd
+
+      logged_output.string.must_match(/DEBUG -- : Transfer complete$/)
+    end
+
+    it "raises an ActionFailed on transfer when TransportFailed is raised" do
+      connection.stubs(:upload).
+        raises(Kitchen::Transport::TransportFailed.new("dang"))
+
+      proc { cmd }.must_raise Kitchen::ActionFailed
+    end
+
+    it "raises an ActionFailed on execute when TransportFailed is raised" do
+      connection.stubs(:execute).
+        raises(Kitchen::Transport::TransportFailed.new("dang"))
+
+      proc { cmd }.must_raise Kitchen::ActionFailed
+    end
+  end
+
+  [:init_command, :install_command, :prepare_command, :run_command].each do |cmd|
+
+    it "has a #{cmd} method" do
+      verifier.public_send(cmd).must_be_nil
+    end
+  end
+
+  describe "sandbox" do
+
+    after do
+      begin
+        verifier.cleanup_sandbox
+      rescue # rubocop:disable Lint/HandleExceptions
+      end
+    end
+
+    it "raises ClientError if #sandbox_path is called before #create_sandbox" do
+      proc { verifier.sandbox_path }.must_raise Kitchen::ClientError
+    end
+
+    it "#create_sandbox creates a temporary directory" do
+      verifier.create_sandbox
+
+      File.directory?(verifier.sandbox_path).must_equal true
+      format("%o", File.stat(verifier.sandbox_path).mode)[1, 4].
+        must_equal "0755"
+    end
+
+    it "#create_sandbox logs an info message" do
+      verifier.create_sandbox
+
+      logged_output.string.must_match info_line("Preparing files for transfer")
+    end
+
+    it "#create_sandbox logs a debug message" do
+      verifier.create_sandbox
+
+      logged_output.string.
+        must_match debug_line_starting_with("Creating local sandbox in ")
+    end
+
+    it "#cleanup_sandbox deletes the sandbox directory" do
+      verifier.create_sandbox
+      verifier.cleanup_sandbox
+
+      File.directory?(verifier.sandbox_path).must_equal false
+    end
+
+    it "#cleanup_sandbox logs a debug message" do
+      verifier.create_sandbox
+      verifier.cleanup_sandbox
+
+      logged_output.string.
+        must_match debug_line_starting_with("Cleaning up local sandbox in ")
+    end
+
+    def info_line(msg)
+      %r{^I, .* : #{Regexp.escape(msg)}$}
+    end
+
+    def debug_line_starting_with(msg)
+      %r{^D, .* : #{Regexp.escape(msg)}}
+    end
+  end
+
+  describe "#sudo" do
+
+    it "if :sudo is set, prepend sudo command" do
+      config[:sudo] = true
+
+      verifier.send(:sudo, "wakka").must_equal("sudo -E wakka")
+    end
+
+    it "if :sudo is falsy, do not include sudo command" do
+      config[:sudo] = false
+
+      verifier.send(:sudo, "wakka").must_equal("wakka")
+    end
+  end
+end

data/spec/kitchen/verifier/busser_spec.rb

@@ -0,0 +1,540 @@
+# -*- encoding: utf-8 -*-
+#
+# Author:: Fletcher Nichol (<fnichol@nichol.ca>)
+#
+# Copyright (C) 2014, 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_relative "../../spec_helper"
+
+require "kitchen"
+require "kitchen/verifier/busser"
+
+describe Kitchen::Verifier::Busser do
+
+  let(:logged_output) { StringIO.new }
+  let(:logger)        { Logger.new(logged_output) }
+  let(:config)        { Hash.new }
+  let(:platform)      { stub(:os_type => nil, :shell_type => nil) }
+  let(:suite)         { stub(:name => "germany") }
+
+  let(:instance) do
+    stub(
+      :name => "coolbeans",
+      :logger => logger,
+      :platform => platform,
+      :suite => suite,
+      :to_str => "instance"
+    )
+  end
+
+  let(:verifier) do
+    Kitchen::Verifier::Busser.new(config).finalize_config!(instance)
+  end
+
+  let(:files) do
+    {
+      "mondospec/charlie" => {
+        :content => "charlie",
+        :perms => "0764"
+      },
+      "minispec/beta" => {
+        :content => "beta",
+        :perms => "0644"
+      },
+      "abba/alpha" => {
+        :content => "alpha",
+        :perms => "0440"
+      }
+    }
+  end
+
+  let(:helper_files) do
+    {
+      "minispec/spec_helper" => {
+        :content => "helping",
+        :perms => "0644"
+      },
+      "abba/common" => {
+        :content => "yeppers",
+        :perms => "0664"
+      }
+    }
+  end
+
+  before do
+    @root = Dir.mktmpdir
+    config[:test_base_path] = @root
+  end
+
+  after do
+    FileUtils.remove_entry(@root)
+  end
+
+  # TODO: deal with this:
+  # it "raises a UserError if the suite name is 'helper'" do
+  #   proc {
+  #     Kitchen::Busser.new("helper", config)
+  #   }.must_raise Kitchen::UserError
+  # end
+
+  describe "configuration" do
+
+    describe "for unix operating systems" do
+
+      before { platform.stubs(:os_type).returns("unix") }
+
+      it ":ruby_bindir defaults the an Omnibus Chef installation" do
+        verifier[:ruby_bindir].must_equal "/opt/chef/embedded/bin"
+      end
+
+      it ":busser_bin defaults to a binstub under :root_path" do
+        config[:root_path] = "/beep"
+
+        verifier[:busser_bin].must_equal "/beep/bin/busser"
+      end
+    end
+
+    describe "for windows operating systems" do
+
+      before { platform.stubs(:os_type).returns("windows") }
+
+      it ":ruby_bindir defaults the an Omnibus Chef installation" do
+        verifier[:ruby_bindir].
+          must_equal "$env:systemdrive\\opscode\\chef\\embedded\\bin"
+      end
+
+      it ":busser_bin defaults to a binstub under :root_path" do
+        config[:root_path] = "\\beep"
+
+        verifier[:busser_bin].must_equal "\\beep\\bin\\busser.bat"
+      end
+    end
+
+    it ":version defaults to 'busser'" do
+      verifier[:version].must_equal "busser"
+    end
+  end
+
+  # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+  def self.common_bourne_variable_specs
+    it "uses bourne shell" do
+      cmd.must_match(/\Ash -c '$/)
+      cmd.must_match(/'\Z/)
+    end
+
+    it "ends with a single quote" do
+      cmd.must_match(/'\Z/)
+    end
+
+    it "sets the BUSSER_ROOT environment variable" do
+      cmd.must_match regexify(%{BUSSER_ROOT="/r"; export BUSSER_ROOT})
+    end
+
+    it "sets the GEM_HOME environment variable" do
+      cmd.must_match regexify(%{GEM_HOME="/r/gems"; export GEM_HOME})
+    end
+
+    it "sets the GEM_PATH environment variable" do
+      cmd.must_match regexify(%{GEM_PATH="/r/gems"; export GEM_PATH})
+    end
+
+    it "sets the GEM_CACHE environment variable" do
+      cmd.must_match regexify(%{GEM_CACHE="/r/gems/cache"; export GEM_CACHE})
+    end
+  end
+  # rubocop:enable Metrics/MethodLength, Metrics/AbcSize
+
+  # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+  def self.common_powershell_variable_specs
+    it "sets the BUSSER_ROOT environment variable" do
+      cmd.must_match regexify(%{$env:BUSSER_ROOT = "\\r"})
+    end
+
+    it "sets the GEM_HOME environment variable" do
+      cmd.must_match regexify(%{$env:GEM_HOME = "\\r\\gems"})
+    end
+
+    it "sets the GEM_PATH environment variable" do
+      cmd.must_match regexify(%{$env:GEM_PATH = "\\r\\gems"})
+    end
+
+    it "sets the GEM_CACHE environment variable" do
+      cmd.must_match regexify(%{$env:GEM_CACHE = "\\r\\gems\\cache"})
+    end
+  end
+  # rubocop:enable Metrics/MethodLength, Metrics/AbcSize
+
+  describe "#install_command" do
+
+    let(:cmd) { verifier.install_command }
+
+    describe "with no suite test files" do
+
+      describe "for bourne shells" do
+
+        before { platform.stubs(:shell_type).returns("bourne") }
+
+        it "returns nil" do
+          cmd.must_equal nil
+        end
+      end
+
+      describe "for powershell shells on windows os types" do
+
+        before do
+          platform.stubs(:shell_type).returns("powershell")
+          platform.stubs(:os_type).returns("windows")
+        end
+
+        it "returns nil" do
+          cmd.must_equal nil
+        end
+      end
+    end
+
+    describe "with suite test files" do
+
+      describe "for bourne shells" do
+
+        before do
+          platform.stubs(:shell_type).returns("bourne")
+          create_test_files
+          config[:ruby_bindir] = "/rbd"
+          config[:root_path] = "/r"
+        end
+
+        common_bourne_variable_specs
+
+        it "sets path to ruby command" do
+          cmd.must_match regexify(%{ruby="/rbd/ruby"})
+        end
+
+        it "sets path to gem command" do
+          cmd.must_match regexify(%{gem="/rbd/gem"})
+        end
+
+        it "sets version for busser" do
+          config[:version] = "the_best"
+
+          cmd.must_match regexify(%{version="the_best"})
+        end
+
+        it "sets gem install arguments" do
+          cmd.must_match regexify(
+            %{gem_install_args="busser --no-rdoc --no-ri"})
+        end
+
+        it "prepends sudo for busser binstub command when :sudo is set" do
+          cmd.must_match regexify(%{busser="sudo -E /r/bin/busser"})
+        end
+
+        it "does not sudo for busser binstub command when :sudo is falsey" do
+          config[:sudo] = false
+
+          cmd.must_match regexify(%{busser="/r/bin/busser"})
+        end
+
+        it "sets the busser plugins list" do
+          cmd.must_match regexify(
+            %{plugins="busser-abba busser-minispec busser-mondospec"})
+        end
+      end
+
+      describe "for powershell shells on windows os types" do
+
+        before do
+          platform.stubs(:shell_type).returns("powershell")
+          platform.stubs(:os_type).returns("windows")
+          create_test_files
+          config[:ruby_bindir] = "\\rbd"
+          config[:root_path] = "\\r"
+        end
+
+        common_powershell_variable_specs
+
+        it "sets path to ruby command" do
+          cmd.must_match regexify(%{$ruby = "\\rbd\\ruby.exe"})
+        end
+
+        it "sets path to gem command" do
+          cmd.must_match regexify(%{$gem = "\\rbd\\gem"})
+        end
+
+        it "sets version for busser" do
+          config[:version] = "the_best"
+
+          cmd.must_match regexify(%{$version = "the_best"})
+        end
+
+        it "sets gem install arguments" do
+          cmd.must_match regexify(
+            %{$gem_install_args = "busser --no-rdoc --no-ri"})
+        end
+
+        it "sets path to busser binstub command" do
+          cmd.must_match regexify(%{$busser = "\\r\\bin\\busser.bat"})
+        end
+
+        it "sets the busser plugins list" do
+          cmd.must_match regexify(
+            %{$plugins = "busser-abba busser-minispec busser-mondospec"})
+        end
+      end
+    end
+  end
+
+  describe "#init_command" do
+
+    let(:cmd) { verifier.init_command }
+
+    describe "with no suite test files" do
+
+      describe "for bourne shells" do
+
+        before { platform.stubs(:shell_type).returns("bourne") }
+
+        it "returns nil" do
+          cmd.must_equal nil
+        end
+      end
+
+      describe "for powershell shells on windows os types" do
+
+        before do
+          platform.stubs(:shell_type).returns("powershell")
+          platform.stubs(:os_type).returns("windows")
+        end
+
+        it "returns nil" do
+          cmd.must_equal nil
+        end
+      end
+    end
+
+    describe "with suite test files" do
+
+      describe "for bourne shells" do
+
+        before do
+          platform.stubs(:shell_type).returns("bourne")
+          create_test_files
+          config[:ruby_bindir] = "/rbd"
+          config[:root_path] = "/r"
+        end
+
+        common_bourne_variable_specs
+
+        it "runs busser's suite cleanup with sudo, if set" do
+          config[:root_path] = "/b"
+          config[:sudo] = true
+
+          cmd.must_match regexify(%{sudo -E /b/bin/busser suite cleanup})
+        end
+
+        it "runs busser's suite cleanup without sudo, if falsey" do
+          config[:root_path] = "/b"
+          config[:sudo] = false
+
+          cmd.wont_match regexify(%{sudo -E /b/bin/busser suite cleanup})
+          cmd.must_match regexify(%{/b/bin/busser suite cleanup})
+        end
+      end
+
+      describe "for powershell shells on windows os types" do
+
+        before do
+          platform.stubs(:shell_type).returns("powershell")
+          platform.stubs(:os_type).returns("windows")
+          create_test_files
+          config[:ruby_bindir] = "\\rbd"
+          config[:root_path] = "\\r"
+        end
+
+        common_powershell_variable_specs
+
+        it "runs busser's suite cleanup" do
+          config[:root_path] = "\\b"
+
+          cmd.must_match regexify(%{& \\b\\bin\\busser.bat suite cleanup})
+        end
+      end
+    end
+  end
+
+  describe "#run_command" do
+
+    let(:cmd) { verifier.run_command }
+
+    describe "with no suite test files" do
+
+      describe "for bourne shells" do
+
+        before { platform.stubs(:shell_type).returns("bourne") }
+
+        it "returns nil" do
+          cmd.must_equal nil
+        end
+      end
+
+      describe "for powershell shells on windows os types" do
+
+        before do
+          platform.stubs(:shell_type).returns("powershell")
+          platform.stubs(:os_type).returns("windows")
+        end
+
+        it "returns nil" do
+          cmd.must_equal nil
+        end
+      end
+    end
+
+    describe "with suite test files" do
+
+      describe "for bourne shells" do
+
+        before do
+          platform.stubs(:shell_type).returns("bourne")
+          create_test_files
+          config[:ruby_bindir] = "/rbd"
+          config[:root_path] = "/r"
+        end
+
+        common_bourne_variable_specs
+
+        it "uses sudo for busser test when configured" do
+          config[:sudo] = true
+          config[:busser_bin] = "/p/b"
+
+          cmd.must_match regexify("sudo -E /p/b test", :partial_line)
+        end
+
+        it "does not use sudo for busser test when configured" do
+          config[:sudo] = false
+          config[:busser_bin] = "/p/b"
+
+          cmd.must_match regexify("/p/b test", :partial_line)
+          cmd.wont_match regexify("sudo -E /p/b test", :partial_line)
+        end
+      end
+
+      describe "for powershell shells on windows os types" do
+
+        before do
+          platform.stubs(:shell_type).returns("powershell")
+          platform.stubs(:os_type).returns("windows")
+          create_test_files
+          config[:ruby_bindir] = "\\rbd"
+          config[:root_path] = "\\r"
+        end
+
+        common_powershell_variable_specs
+
+        it "runs busser's test" do
+          config[:root_path] = "\\b"
+
+          cmd.must_match regexify(%{& \\b\\bin\\busser.bat test})
+        end
+      end
+    end
+  end
+
+  describe "#create_sandbox" do
+
+    before do
+      create_test_files
+    end
+
+    it "copies each suite file into the suites directory in sandbox" do
+      verifier.create_sandbox
+
+      files.each do |f, md|
+        file = sandbox_path("suites/#{f}")
+
+        file.file?.must_equal true
+        file.stat.mode.to_s(8)[2, 4].must_equal md[:perms]
+        IO.read(file).must_equal md[:content]
+      end
+    end
+
+    it "copies each helper file into the suites directory in sandbox" do
+      verifier.create_sandbox
+
+      helper_files.each do |f, md|
+        file = sandbox_path("suites/#{f}")
+
+        file.file?.must_equal true
+        file.stat.mode.to_s(8)[2, 4].must_equal md[:perms]
+        IO.read(file).must_equal md[:content]
+      end
+    end
+
+    def sandbox_path(path)
+      Pathname.new(verifier.sandbox_path).join(path)
+    end
+  end
+
+  describe "Busser legacy behavior for code calling old method names" do
+
+    let(:busser) { verifier }
+
+    it "responds to #setup_cmd which calls #install_command" do
+      busser.stubs(:install_command).returns("install")
+
+      busser.setup_cmd.must_equal "install"
+    end
+
+    it "responds to #run_cmd which calls #run_command" do
+      busser.stubs(:run_command).returns("run")
+
+      busser.run_cmd.must_equal "run"
+    end
+
+    it "responds to #sync_cmd which logs a warning" do
+      busser.sync_cmd
+
+      logged_output.string.must_match warn_line_with(
+        "Legacy call to #sync_cmd cannot be preserved")
+    end
+  end
+
+  def create_file(file, content, perms)
+    FileUtils.mkdir_p(File.dirname(file))
+    File.open(file, "wb") { |f| f.write(content) }
+    FileUtils.chmod(perms.to_i(8), file)
+  end
+
+  def create_test_files
+    base = "#{config[:test_base_path]}/germany"
+    hbase = "#{config[:test_base_path]}/helpers"
+
+    files.map { |f, md| [File.join(base, f), md] }.each do |f, md|
+      create_file(f, md[:content], md[:perms])
+    end
+    helper_files.map { |f, md| [File.join(hbase, f), md] }.each do |f, md|
+      create_file(f, md[:content], md[:perms])
+    end
+  end
+
+  def regexify(str, line = :whole_line)
+    r = Regexp.escape(str)
+    r = "^\s*#{r}$" if line == :whole_line
+    Regexp.new(r)
+  end
+
+  def warn_line_with(msg)
+    %r{^W, .* : #{Regexp.escape(msg)}}
+  end
+end