capistrano-edge 2.5.6

data/test/cli/ui_test.rb

@@ -0,0 +1,28 @@
+require "utils"
+require 'capistrano/cli/ui'
+
+class CLIUITest < Test::Unit::TestCase
+  class MockCLI
+    include Capistrano::CLI::UI
+  end
+
+  def test_ui_should_return_highline_instance
+    assert_instance_of HighLine, MockCLI.ui
+  end
+
+  def test_password_prompt_should_have_default_prompt_and_set_echo_false
+    q = mock("question")
+    q.expects(:echo=).with(false)
+    ui = mock("ui")
+    ui.expects(:ask).with("Password: ").yields(q).returns("sayuncle")
+    MockCLI.expects(:ui).returns(ui)
+    assert_equal "sayuncle", MockCLI.password_prompt
+  end
+
+  def test_password_prompt_with_custom_prompt_should_use_custom_prompt
+    ui = mock("ui")
+    ui.expects(:ask).with("Give the passphrase: ").returns("sayuncle")
+    MockCLI.expects(:ui).returns(ui)
+    assert_equal "sayuncle", MockCLI.password_prompt("Give the passphrase: ")
+  end
+end

data/test/cli_test.rb

@@ -0,0 +1,17 @@
+require "utils"
+require 'capistrano/cli'
+
+class CLI_Test < Test::Unit::TestCase
+  def test_options_ui_and_help_modules_should_integrate_successfully_with_configuration
+    cli = Capistrano::CLI.parse(%w(-T))
+    cli.expects(:puts).at_least_once
+    cli.execute!
+  end
+
+  def test_options_and_execute_modules_should_integrate_successfully_with_configuration
+    path = "#{File.dirname(__FILE__)}/fixtures/cli_integration.rb"
+    cli = Capistrano::CLI.parse(%W(-q -f #{path} testing))
+    config = cli.execute!
+    assert config[:testing_occurred]
+  end
+end

data/test/command_test.rb

@@ -0,0 +1,286 @@
+require "utils"
+require 'capistrano/command'
+require 'capistrano/configuration'
+
+class CommandTest < Test::Unit::TestCase
+  def test_command_should_open_channels_on_all_sessions
+    s1, s2, s3 = mock_session, mock_session, mock_session
+    assert_equal "ls", Capistrano::Command.new("ls", [s1, s2, s3]).tree.fallback.command
+  end
+
+  def test_command_with_newlines_should_be_properly_escaped
+    cmd = Capistrano::Command.new("ls\necho", [mock_session])
+    assert_equal "ls\\\necho", cmd.tree.fallback.command
+  end
+
+  def test_command_with_windows_newlines_should_be_properly_escaped
+    cmd = Capistrano::Command.new("ls\r\necho", [mock_session])
+    assert_equal "ls\\\necho", cmd.tree.fallback.command
+  end
+
+  def test_command_with_pty_should_request_pty_and_register_success_callback
+    session = setup_for_extracting_channel_action(:request_pty, true) do |ch|
+      ch.expects(:exec).with(%(sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :pty => true)
+  end
+
+  def test_command_with_env_key_should_have_environment_constructed_and_prepended
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:request_pty).never
+      ch.expects(:exec).with(%(env FOO=bar sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :env => { "FOO" => "bar" })
+  end
+
+  def test_env_with_symbolic_key_should_be_accepted_as_a_string
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(env FOO=bar sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :env => { :FOO => "bar" })
+  end
+
+  def test_env_as_string_should_be_substituted_in_directly
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(env HOWDY=there sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :env => "HOWDY=there")
+  end
+
+  def test_env_with_symbolic_value_should_be_accepted_as_string
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(env FOO=bar sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :env => { "FOO" => :bar })
+  end
+
+  def test_env_value_should_be_escaped
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(env FOO=(\\ \\\"bar\\\"\\ ) sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :env => { "FOO" => '( "bar" )' })
+  end
+
+  def test_env_with_multiple_keys_should_chain_the_entries_together
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with do |command|
+        command =~ /^env / &&
+        command =~ /\ba=b\b/ &&
+        command =~ /\bc=d\b/ &&
+        command =~ /\be=f\b/ &&
+        command =~ / sh -c 'ls'$/
+      end
+    end
+    Capistrano::Command.new("ls", [session], :env => { :a => :b, :c => :d, :e => :f })
+  end
+
+  def test_open_channel_should_set_host_key_on_channel
+    channel = nil
+    session = setup_for_extracting_channel_action { |ch| channel = ch }
+    Capistrano::Command.new("ls", [session])
+    assert_equal "capistrano", channel[:host]
+  end
+
+  def test_open_channel_should_set_options_key_on_channel
+    channel = nil
+    session = setup_for_extracting_channel_action { |ch| channel = ch }
+    Capistrano::Command.new("ls", [session], :data => "here we go")
+    assert_equal({ :data => 'here we go' }, channel[:options])
+  end
+
+  def test_successful_channel_should_send_command
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(sh -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session])
+  end
+
+  def test_successful_channel_with_shell_option_should_send_command_via_specified_shell
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(/bin/bash -c 'ls'))
+    end
+    Capistrano::Command.new("ls", [session], :shell => "/bin/bash")
+  end
+
+  def test_successful_channel_with_shell_false_should_send_command_without_shell
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(echo `hostname`))
+    end
+    Capistrano::Command.new("echo `hostname`", [session], :shell => false)
+  end
+
+  def test_successful_channel_should_send_data_if_data_key_is_present
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(sh -c 'ls'))
+      ch.expects(:send_data).with("here we go")
+    end
+    Capistrano::Command.new("ls", [session], :data => "here we go")
+  end
+
+  def test_unsuccessful_pty_request_should_close_channel
+    session = setup_for_extracting_channel_action(:request_pty, false) do |ch|
+      ch.expects(:close)
+    end
+    Capistrano::Command.new("ls", [session], :pty => true)
+  end
+
+  def test_on_data_should_invoke_callback_as_stdout
+    session = setup_for_extracting_channel_action(:on_data, "hello")
+    called = false
+    Capistrano::Command.new("ls", [session]) do |ch, stream, data|
+      called = true
+      assert_equal :out, stream
+      assert_equal "hello", data
+    end
+    assert called
+  end
+
+  def test_on_extended_data_should_invoke_callback_as_stderr
+    session = setup_for_extracting_channel_action(:on_extended_data, 2, "hello")
+    called = false
+    Capistrano::Command.new("ls", [session]) do |ch, stream, data|
+      called = true
+      assert_equal :err, stream
+      assert_equal "hello", data
+    end
+    assert called
+  end
+
+  def test_on_request_should_record_exit_status
+    data = mock(:read_long => 5)
+    channel = nil
+    session = setup_for_extracting_channel_action([:on_request, "exit-status"], data) { |ch| channel = ch }
+    Capistrano::Command.new("ls", [session])
+    assert_equal 5, channel[:status]
+  end
+
+  def test_on_close_should_set_channel_closed
+    channel = nil
+    session = setup_for_extracting_channel_action(:on_close) { |ch| channel = ch }
+    Capistrano::Command.new("ls", [session])
+    assert channel[:closed]
+  end
+
+  def test_stop_should_close_all_open_channels
+    sessions = [mock_session(new_channel(false)),
+                mock_session(new_channel(true)),
+                mock_session(new_channel(false))]
+
+    cmd = Capistrano::Command.new("ls", sessions)
+    cmd.stop!
+  end
+
+  def test_process_should_return_cleanly_if_all_channels_have_zero_exit_status
+    sessions = [mock_session(new_channel(true, 0)),
+                mock_session(new_channel(true, 0)),
+                mock_session(new_channel(true, 0))]
+    cmd = Capistrano::Command.new("ls", sessions)
+    assert_nothing_raised { cmd.process! }
+  end
+
+  def test_process_should_raise_error_if_any_channel_has_non_zero_exit_status
+    sessions = [mock_session(new_channel(true, 0)),
+                mock_session(new_channel(true, 0)),
+                mock_session(new_channel(true, 1))]
+    cmd = Capistrano::Command.new("ls", sessions)
+    assert_raises(Capistrano::CommandError) { cmd.process! }
+  end
+
+  def test_command_error_should_include_accessor_with_host_array
+    sessions = [mock_session(new_channel(true, 0)),
+                mock_session(new_channel(true, 0)),
+                mock_session(new_channel(true, 1))]
+    cmd = Capistrano::Command.new("ls", sessions)
+
+    begin
+      cmd.process!
+      flunk "expected an exception to be raised"
+    rescue Capistrano::CommandError => e
+      assert e.respond_to?(:hosts)
+      assert_equal %w(capistrano), e.hosts.map { |h| h.to_s }
+    end
+  end
+
+  def test_process_should_loop_until_all_channels_are_closed
+    new_channel = Proc.new do |times|
+      ch = mock("channel")
+      returns = [false] * (times-1)
+      ch.stubs(:[]).with(:closed).returns(*(returns + [true]))
+      ch.expects(:[]).with(:status).returns(0)
+      ch
+    end
+
+    sessions = [mock_session(new_channel[5]),
+                mock_session(new_channel[10]),
+                mock_session(new_channel[7])]
+    cmd = Capistrano::Command.new("ls", sessions)
+    assert_nothing_raised { cmd.process! }
+  end
+
+  def test_process_should_instantiate_command_and_process!
+    cmd = mock("command", :process! => nil)
+    Capistrano::Command.expects(:new).with("ls -l", %w(a b c), {:foo => "bar"}).returns(cmd)
+    Capistrano::Command.process("ls -l", %w(a b c), :foo => "bar")
+  end
+
+  def test_process_with_host_placeholder_should_substitute_placeholder_with_each_host
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(sh -c 'echo capistrano'))
+    end
+    Capistrano::Command.new("echo $CAPISTRANO:HOST$", [session])
+  end
+
+  def test_process_with_unknown_placeholder_should_not_replace_placeholder
+    session = setup_for_extracting_channel_action do |ch|
+      ch.expects(:exec).with(%(sh -c 'echo $CAPISTRANO:OTHER$'))
+    end
+    Capistrano::Command.new("echo $CAPISTRANO:OTHER$", [session])
+  end
+
+  private
+
+    def mock_session(channel=nil)
+      stub('session', :open_channel => channel,
+        :preprocess => true,
+        :postprocess => true,
+        :listeners => {},
+        :xserver => server("capistrano"))
+    end
+
+    class MockChannel < Hash
+      def close
+      end
+    end
+
+    def new_channel(closed, status=nil)
+      ch = MockChannel.new
+      ch.update({ :closed => closed, :host => "capistrano", :server => server("capistrano") })
+      ch[:status] = status if status
+      ch.expects(:close) unless closed
+      ch
+    end
+
+    def setup_for_extracting_channel_action(action=nil, *args)
+      s = server("capistrano")
+      session = mock("session", :xserver => s)
+
+      channel = {}
+      session.expects(:open_channel).yields(channel)
+
+      channel.stubs(:on_data)
+      channel.stubs(:on_extended_data)
+      channel.stubs(:on_request)
+      channel.stubs(:on_close)
+      channel.stubs(:exec)
+      channel.stubs(:send_data)
+
+      if action
+        action = Array(action)
+        channel.expects(action.first).with(*action[1..-1]).yields(channel, *args)
+      end
+
+      yield channel if block_given?
+
+      session
+    end
+end

data/test/configuration/actions/file_transfer_test.rb

@@ -0,0 +1,61 @@
+require "utils"
+require 'capistrano/configuration/actions/file_transfer'
+
+class ConfigurationActionsFileTransferTest < Test::Unit::TestCase
+  class MockConfig
+    include Capistrano::Configuration::Actions::FileTransfer
+    attr_accessor :sessions
+  end
+
+  def setup
+    @config = MockConfig.new
+    @config.stubs(:logger).returns(stub_everything)
+  end
+
+  def test_put_should_delegate_to_upload
+    @config.expects(:upload).with { |from, to, opts|
+      from.string == "some data" && to == "test.txt" && opts == { :mode => 0777 } }
+    @config.expects(:run).never
+    @config.put("some data", "test.txt", :mode => 0777)
+  end
+
+  def test_get_should_delegate_to_download_with_once
+    @config.expects(:download).with("testr.txt", "testl.txt", :foo => "bar", :once => true)
+    @config.get("testr.txt", "testl.txt", :foo => "bar")
+  end
+
+  def test_upload_should_delegate_to_transfer
+    @config.expects(:transfer).with(:up, "testl.txt", "testr.txt", :foo => "bar")
+    @config.upload("testl.txt", "testr.txt", :foo => "bar")
+  end
+
+  def test_upload_without_mode_should_not_try_to_chmod
+    @config.expects(:transfer).with(:up, "testl.txt", "testr.txt", :foo => "bar")
+    @config.expects(:run).never
+    @config.upload("testl.txt", "testr.txt", :foo => "bar")
+  end
+
+  def test_upload_with_mode_should_try_to_chmod
+    @config.expects(:transfer).with(:up, "testl.txt", "testr.txt", :foo => "bar")
+    @config.expects(:run).with("chmod 775 testr.txt")
+    @config.upload("testl.txt", "testr.txt", :mode => 0775, :foo => "bar")
+  end
+
+  def test_upload_with_symbolic_mode_should_try_to_chmod
+    @config.expects(:transfer).with(:up, "testl.txt", "testr.txt", :foo => "bar")
+    @config.expects(:run).with("chmod g+w testr.txt")
+    @config.upload("testl.txt", "testr.txt", :mode => "g+w", :foo => "bar")
+  end
+
+  def test_download_should_delegate_to_transfer
+    @config.expects(:transfer).with(:down, "testr.txt", "testl.txt", :foo => "bar")
+    @config.download("testr.txt", "testl.txt", :foo => "bar")
+  end
+
+  def test_transfer_should_invoke_transfer_on_matching_servers
+    @config.sessions = { :a => 1, :b => 2, :c => 3, :d => 4 }
+    @config.expects(:execute_on_servers).with(:foo => "bar").yields([:a, :b, :c])
+    Capistrano::Transfer.expects(:process).with(:up, "testl.txt", "testr.txt", [1,2,3], {:foo => "bar", :logger => @config.logger})
+    @config.transfer(:up, "testl.txt", "testr.txt", :foo => "bar")
+  end
+end

data/test/configuration/actions/inspect_test.rb

@@ -0,0 +1,65 @@
+require "utils"
+require 'capistrano/configuration/actions/inspect'
+
+class ConfigurationActionsInspectTest < Test::Unit::TestCase
+  class MockConfig
+    include Capistrano::Configuration::Actions::Inspect
+  end
+
+  def setup
+    @config = MockConfig.new
+    @config.stubs(:logger).returns(stub_everything)
+  end
+
+  def test_stream_should_pass_options_through_to_run
+    @config.expects(:invoke_command).with("tail -f foo.log", :once => true)
+    @config.stream("tail -f foo.log", :once => true)
+  end
+
+  def test_stream_should_emit_stdout_via_puts
+    @config.expects(:invoke_command).yields(mock("channel"), :out, "something streamed")
+    @config.expects(:puts).with("something streamed")
+    @config.expects(:warn).never
+    @config.stream("tail -f foo.log")
+  end
+
+  def test_stream_should_emit_stderr_via_warn
+    ch = mock("channel")
+    ch.expects(:[]).with(:server).returns(server("capistrano"))
+    @config.expects(:invoke_command).yields(ch, :err, "something streamed")
+    @config.expects(:puts).never
+    @config.expects(:warn).with("[err :: capistrano] something streamed")
+    @config.stream("tail -f foo.log")
+  end
+
+  def test_capture_should_pass_options_merged_with_once_to_run
+    @config.expects(:invoke_command).with("hostname", :foo => "bar", :once => true)
+    @config.capture("hostname", :foo => "bar")
+  end
+
+  def test_capture_with_stderr_should_emit_stderr_via_warn
+    ch = mock("channel")
+    ch.expects(:[]).with(:server).returns(server("capistrano"))
+    @config.expects(:invoke_command).yields(ch, :err, "boom")
+    @config.expects(:warn).with("[err :: capistrano] boom")
+    @config.capture("hostname")
+  end
+
+  def test_capture_with_stdout_should_aggregate_and_return_stdout
+    config_expects_invoke_command_to_loop_with(mock("channel"), "foo", "bar", "baz")
+    assert_equal "foobarbaz", @config.capture("hostname")
+  end
+
+  private
+
+    def config_expects_invoke_command_to_loop_with(channel, *output)
+      class <<@config
+        attr_accessor :script, :channel
+        def invoke_command(*args)
+          script.each { |item| yield channel, :out, item }
+        end
+      end
+      @config.channel = channel
+      @config.script = output
+    end
+end