dan-capistrano 2.5.6

data/test/task_definition_test.rb

@@ -0,0 +1,101 @@
+require "utils"
+require 'capistrano/task_definition'
+
+class TaskDefinitionTest < Test::Unit::TestCase
+  def setup
+    @namespace = namespace
+  end
+
+  def test_fqn_at_top_level_should_be_task_name
+    task = new_task(:testing)
+    assert_equal "testing", task.fully_qualified_name
+  end
+
+  def test_fqn_in_namespace_should_include_namespace_fqn
+    ns = namespace("outer:inner")
+    task = new_task(:testing, ns)
+    assert_equal "outer:inner:testing", task.fully_qualified_name
+  end
+
+  def test_fqn_at_top_level_when_default_should_be_default
+    task = new_task(:default)
+    assert_equal "default", task.fully_qualified_name
+  end
+
+  def test_fqn_in_namespace_when_default_should_be_namespace_fqn
+    ns = namespace("outer:inner")
+    task = new_task(:default, ns)
+    ns.stubs(:default_task => task)
+    assert_equal "outer:inner", task.fully_qualified_name
+  end
+
+  def test_task_should_require_block
+    assert_raises(ArgumentError) do
+      Capistrano::TaskDefinition.new(:testing, @namespace)
+    end
+  end
+
+  def test_description_should_return_empty_string_if_not_given
+    assert_equal "", new_task(:testing).description
+  end
+
+  def test_description_should_return_desc_attribute
+    assert_equal "something", new_task(:testing, @namespace, :desc => "something").description
+  end
+
+  def test_description_should_strip_leading_and_trailing_whitespace
+    assert_equal "something", new_task(:testing, @namespace, :desc => "   something   ").description
+  end
+
+  def test_description_should_normalize_newlines
+    assert_equal "a\nb\nc", new_task(:testing, @namespace, :desc => "a\nb\r\nc").description
+  end
+
+  def test_description_should_detect_and_remove_indentation
+    desc = <<-DESC
+      Here is some indented text \
+      and I want all of this to \
+      run together on a single line, \
+      without any extraneous spaces.
+
+        additional indentation will
+        be preserved.
+    DESC
+
+    task = new_task(:testing, @namespace, :desc => desc)
+    assert_equal "Here is some indented text and I want all of this to run together on a single line, without any extraneous spaces.\n\n  additional indentation will\n  be preserved.", task.description
+  end
+
+  def test_description_munging_should_be_sensitive_to_code_blocks
+    desc = <<-DESC
+      Here is a line \
+      wrapped      with spacing in it.
+
+        foo         bar
+        baz         bang
+    DESC
+
+    task = new_task(:testing, @namespace, :desc => desc)
+    assert_equal "Here is a line wrapped with spacing in it.\n\n  foo         bar\n  baz         bang", task.description
+  end
+
+  def test_brief_description_should_return_first_sentence_in_description
+    desc = "This is the task. It does all kinds of things."
+    task = new_task(:testing, @namespace, :desc => desc)
+    assert_equal "This is the task.", task.brief_description
+  end
+
+  def test_brief_description_should_truncate_if_length_given
+    desc = "This is the task that does all kinds of things. And then some."
+    task = new_task(:testing, @namespace, :desc => desc)
+    assert_equal "This is the task ...", task.brief_description(20)
+  end
+
+  def test_brief_description_should_not_break_at_period_in_middle_of_sentence
+    task = new_task(:testing, @namespace, :desc => "Take file.txt and copy it.")
+    assert_equal "Take file.txt and copy it.", task.brief_description
+
+    task = new_task(:testing, @namespace, :desc => "Take file.txt and copy it. Then do something else.")
+    assert_equal "Take file.txt and copy it.", task.brief_description
+  end
+end

data/test/transfer_test.rb

@@ -0,0 +1,160 @@
+require 'utils'
+require 'capistrano/transfer'
+
+class TransferTest < Test::Unit::TestCase
+  def test_class_process_should_delegate_to_instance_process
+    Capistrano::Transfer.expects(:new).with(:up, "from", "to", %w(a b c), {}).returns(mock('transfer', :process! => nil)).yields
+    yielded = false
+    Capistrano::Transfer.process(:up, "from", "to", %w(a b c), {}) { yielded = true }
+    assert yielded
+  end
+
+  def test_default_transport_is_sftp
+    transfer = Capistrano::Transfer.new(:up, "from", "to", [])
+    assert_equal :sftp, transfer.transport
+  end
+
+  def test_active_is_true_when_any_sftp_transfers_are_active
+    returns = [false, false, true]
+    sessions = [session('app1', :sftp), session('app2', :sftp), session('app3', :sftp)].each { |s| s.xsftp.expects(:upload).returns(stub('operation', :active? => returns.shift)) }
+    transfer = Capistrano::Transfer.new(:up, "from", "to", sessions, :via => :sftp)
+    assert_equal true, transfer.active?
+  end
+
+  def test_active_is_false_when_all_sftp_transfers_are_not_active
+    sessions = [session('app1', :sftp), session('app2', :sftp)].each { |s| s.xsftp.expects(:upload).returns(stub('operation', :active? => false)) }
+    transfer = Capistrano::Transfer.new(:up, "from", "to", sessions, :via => :sftp)
+    assert_equal false, transfer.active?
+  end
+
+  def test_active_is_true_when_any_scp_transfers_are_active
+    returns = [false, false, true]
+    sessions = [session('app1', :scp), session('app2', :scp), session('app3', :scp)].each do |s|
+      channel = stub('channel', :[]= => nil, :active? => returns.shift)
+      s.scp.expects(:upload).returns(channel)
+    end
+    transfer = Capistrano::Transfer.new(:up, "from", "to", sessions, :via => :scp)
+    assert_equal true, transfer.active?
+  end
+
+  def test_active_is_false_when_all_scp_transfers_are_not_active
+    sessions = [session('app1', :scp), session('app2', :scp), session('app3', :scp)].each do |s|
+      channel = stub('channel', :[]= => nil, :active? => false)
+      s.scp.expects(:upload).returns(channel)
+    end
+    transfer = Capistrano::Transfer.new(:up, "from", "to", sessions, :via => :scp)
+    assert_equal false, transfer.active?
+  end
+
+  [:up, :down].each do |direction|
+    define_method("test_sftp_#{direction}load_from_file_to_file_should_normalize_from_and_to") do
+      sessions = [session('app1', :sftp), session('app2', :sftp)]
+
+      sessions.each do |session|
+        session.xsftp.expects("#{direction}load".to_sym).with("from-#{session.xserver.host}", "to-#{session.xserver.host}",
+          :properties => { :server => session.xserver, :host => session.xserver.host })
+      end
+
+      transfer = Capistrano::Transfer.new(direction, "from-$CAPISTRANO:HOST$", "to-$CAPISTRANO:HOST$", sessions)
+    end
+
+    define_method("test_scp_#{direction}load_from_file_to_file_should_normalize_from_and_to") do
+      sessions = [session('app1', :scp), session('app2', :scp)]
+
+      sessions.each do |session|
+        session.scp.expects("#{direction}load".to_sym).returns({}).with("from-#{session.xserver.host}", "to-#{session.xserver.host}", :via => :scp)
+      end
+
+      transfer = Capistrano::Transfer.new(direction, "from-$CAPISTRANO:HOST$", "to-$CAPISTRANO:HOST$", sessions, :via => :scp)
+    end
+  end
+
+  def test_sftp_upload_from_IO_to_file_should_clone_the_IO_for_each_connection
+    sessions = [session('app1', :sftp), session('app2', :sftp)]
+    io = StringIO.new("from here")
+
+    sessions.each do |session|
+      session.xsftp.expects(:upload).with do |from, to, opts|
+        from != io && from.is_a?(StringIO) && from.string == io.string &&
+        to == "/to/here-#{session.xserver.host}" &&
+        opts[:properties][:server] == session.xserver &&
+        opts[:properties][:host] == session.xserver.host
+      end
+    end
+
+    transfer = Capistrano::Transfer.new(:up, StringIO.new("from here"), "/to/here-$CAPISTRANO:HOST$", sessions)
+  end
+
+  def test_scp_upload_from_IO_to_file_should_clone_the_IO_for_each_connection
+    sessions = [session('app1', :scp), session('app2', :scp)]
+    io = StringIO.new("from here")
+
+    sessions.each do |session|
+      channel = mock('channel')
+      channel.expects(:[]=).with(:server, session.xserver)
+      channel.expects(:[]=).with(:host, session.xserver.host)
+      session.scp.expects(:upload).returns(channel).with do |from, to, opts|
+        from != io && from.is_a?(StringIO) && from.string == io.string &&
+        to == "/to/here-#{session.xserver.host}"
+      end
+    end
+
+    transfer = Capistrano::Transfer.new(:up, StringIO.new("from here"), "/to/here-$CAPISTRANO:HOST$", sessions, :via => :scp)
+  end
+
+  def test_process_should_block_until_transfer_is_no_longer_active
+    transfer = Capistrano::Transfer.new(:up, "from", "to", [])
+    transfer.expects(:process_iteration).times(4).yields.returns(true,true,true,false)
+    transfer.expects(:active?).times(4)
+    transfer.process!
+  end
+
+  def test_errors_raised_for_a_sftp_session_should_abort_session_and_continue_with_remaining_sessions
+    s = session('app1')
+    error = ExceptionWithSession.new(s)
+    transfer = Capistrano::Transfer.new(:up, "from", "to", [])
+    transfer.expects(:process_iteration).raises(error).times(3).returns(true, false)
+    txfr = mock('transfer', :abort! => true)
+    txfr.expects(:[]=).with(:failed, true)
+    txfr.expects(:[]=).with(:error, error)
+    transfer.expects(:session_map).returns(s => txfr)
+    transfer.process!
+  end
+
+  def test_errors_raised_for_a_scp_session_should_abort_session_and_continue_with_remaining_sessions
+    s = session('app1')
+    error = ExceptionWithSession.new(s)
+    transfer = Capistrano::Transfer.new(:up, "from", "to", [], :via => :scp)
+    transfer.expects(:process_iteration).raises(error).times(3).returns(true, false)
+    txfr = mock('channel', :close => true)
+    txfr.expects(:[]=).with(:failed, true)
+    txfr.expects(:[]=).with(:error, error)
+    transfer.expects(:session_map).returns(s => txfr)
+    transfer.process!
+  end
+
+  private
+
+    class ExceptionWithSession < ::Exception
+      attr_reader :session
+
+      def initialize(session)
+        @session = session
+        super()
+      end
+    end
+
+    def session(host, mode=nil)
+      session = stub('session', :xserver => stub('server', :host => host))
+      case mode
+      when :sftp
+        sftp = stub('sftp')
+        session.expects(:sftp).with(false).returns(sftp)
+        sftp.expects(:connect).yields(sftp).returns(sftp)
+        session.stubs(:xsftp).returns(sftp)
+      when :scp
+        session.stubs(:scp).returns(stub('scp'))
+      end
+      session
+    end
+end

data/test/utils.rb

@@ -0,0 +1,38 @@
+begin
+  require 'rubygems'
+  gem     'mocha'
+rescue LoadError
+end
+
+require 'test/unit'
+require 'mocha'
+require 'capistrano/server_definition'
+
+module TestExtensions
+  def server(host, options={})
+    Capistrano::ServerDefinition.new(host, options)
+  end
+
+  def namespace(fqn=nil)
+    space = stub(:roles => {}, :fully_qualified_name => fqn, :default_task => nil)
+    yield(space) if block_given?
+    space
+  end
+
+  def role(space, name, *args)
+    opts = args.last.is_a?(Hash) ? args.pop : {}
+    space.roles[name] ||= []
+    space.roles[name].concat(args.map { |h| Capistrano::ServerDefinition.new(h, opts) })
+  end
+
+  def new_task(name, namespace=@namespace, options={}, &block)
+    block ||= Proc.new {}
+    task = Capistrano::TaskDefinition.new(name, namespace, options, &block)
+    assert_equal block, task.body
+    return task
+  end
+end
+
+class Test::Unit::TestCase
+  include TestExtensions
+end

metadata

@@ -0,0 +1,306 @@
+--- !ruby/object:Gem::Specification 
+name: dan-capistrano
+version: !ruby/object:Gem::Version 
+  version: 2.5.6
+platform: ruby
+authors: 
+- Jamis Buck
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-13 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: net-ssh
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.10
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: net-sftp
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: net-scp
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: net-ssh-gateway
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: highline
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: Capistrano is a utility and framework for executing commands in parallel on multiple remote machines, via SSH.
+email: jamis@jamisbuck.org
+executables: 
+- cap
+- capify
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG.rdoc
+- lib/capistrano/callback.rb
+- lib/capistrano/cli/execute.rb
+- lib/capistrano/cli/help.rb
+- lib/capistrano/cli/help.txt
+- lib/capistrano/cli/options.rb
+- lib/capistrano/cli/ui.rb
+- lib/capistrano/cli.rb
+- lib/capistrano/command.rb
+- lib/capistrano/configuration/actions/file_transfer.rb
+- lib/capistrano/configuration/actions/inspect.rb
+- lib/capistrano/configuration/actions/invocation.rb
+- lib/capistrano/configuration/callbacks.rb
+- lib/capistrano/configuration/connections.rb
+- lib/capistrano/configuration/execution.rb
+- lib/capistrano/configuration/loading.rb
+- lib/capistrano/configuration/namespaces.rb
+- lib/capistrano/configuration/roles.rb
+- lib/capistrano/configuration/servers.rb
+- lib/capistrano/configuration/variables.rb
+- lib/capistrano/configuration.rb
+- lib/capistrano/errors.rb
+- lib/capistrano/extensions.rb
+- lib/capistrano/logger.rb
+- lib/capistrano/processable.rb
+- lib/capistrano/recipes/compat.rb
+- lib/capistrano/recipes/deploy/dependencies.rb
+- lib/capistrano/recipes/deploy/local_dependency.rb
+- lib/capistrano/recipes/deploy/remote_dependency.rb
+- lib/capistrano/recipes/deploy/scm/accurev.rb
+- lib/capistrano/recipes/deploy/scm/base.rb
+- lib/capistrano/recipes/deploy/scm/bzr.rb
+- lib/capistrano/recipes/deploy/scm/cvs.rb
+- lib/capistrano/recipes/deploy/scm/darcs.rb
+- lib/capistrano/recipes/deploy/scm/git.rb
+- lib/capistrano/recipes/deploy/scm/mercurial.rb
+- lib/capistrano/recipes/deploy/scm/none.rb
+- lib/capistrano/recipes/deploy/scm/perforce.rb
+- lib/capistrano/recipes/deploy/scm/subversion.rb
+- lib/capistrano/recipes/deploy/scm.rb
+- lib/capistrano/recipes/deploy/strategy/base.rb
+- lib/capistrano/recipes/deploy/strategy/checkout.rb
+- lib/capistrano/recipes/deploy/strategy/copy.rb
+- lib/capistrano/recipes/deploy/strategy/export.rb
+- lib/capistrano/recipes/deploy/strategy/remote.rb
+- lib/capistrano/recipes/deploy/strategy/remote_cache.rb
+- lib/capistrano/recipes/deploy/strategy.rb
+- lib/capistrano/recipes/deploy/templates/maintenance.rhtml
+- lib/capistrano/recipes/deploy.rb
+- lib/capistrano/recipes/standard.rb
+- lib/capistrano/recipes/templates/maintenance.rhtml
+- lib/capistrano/recipes/upgrade.rb
+- lib/capistrano/role.rb
+- lib/capistrano/server_definition.rb
+- lib/capistrano/shell.rb
+- lib/capistrano/ssh.rb
+- lib/capistrano/task_definition.rb
+- lib/capistrano/transfer.rb
+- lib/capistrano/version.rb
+- lib/capistrano.rb
+- README.rdoc
+files: 
+- bin/cap
+- bin/capify
+- CHANGELOG.rdoc
+- examples/sample.rb
+- lib/capistrano/callback.rb
+- lib/capistrano/cli/execute.rb
+- lib/capistrano/cli/help.rb
+- lib/capistrano/cli/help.txt
+- lib/capistrano/cli/options.rb
+- lib/capistrano/cli/ui.rb
+- lib/capistrano/cli.rb
+- lib/capistrano/command.rb
+- lib/capistrano/configuration/actions/file_transfer.rb
+- lib/capistrano/configuration/actions/inspect.rb
+- lib/capistrano/configuration/actions/invocation.rb
+- lib/capistrano/configuration/callbacks.rb
+- lib/capistrano/configuration/connections.rb
+- lib/capistrano/configuration/execution.rb
+- lib/capistrano/configuration/loading.rb
+- lib/capistrano/configuration/namespaces.rb
+- lib/capistrano/configuration/roles.rb
+- lib/capistrano/configuration/servers.rb
+- lib/capistrano/configuration/variables.rb
+- lib/capistrano/configuration.rb
+- lib/capistrano/errors.rb
+- lib/capistrano/extensions.rb
+- lib/capistrano/logger.rb
+- lib/capistrano/processable.rb
+- lib/capistrano/recipes/compat.rb
+- lib/capistrano/recipes/deploy/dependencies.rb
+- lib/capistrano/recipes/deploy/local_dependency.rb
+- lib/capistrano/recipes/deploy/remote_dependency.rb
+- lib/capistrano/recipes/deploy/scm/accurev.rb
+- lib/capistrano/recipes/deploy/scm/base.rb
+- lib/capistrano/recipes/deploy/scm/bzr.rb
+- lib/capistrano/recipes/deploy/scm/cvs.rb
+- lib/capistrano/recipes/deploy/scm/darcs.rb
+- lib/capistrano/recipes/deploy/scm/git.rb
+- lib/capistrano/recipes/deploy/scm/mercurial.rb
+- lib/capistrano/recipes/deploy/scm/none.rb
+- lib/capistrano/recipes/deploy/scm/perforce.rb
+- lib/capistrano/recipes/deploy/scm/subversion.rb
+- lib/capistrano/recipes/deploy/scm.rb
+- lib/capistrano/recipes/deploy/strategy/base.rb
+- lib/capistrano/recipes/deploy/strategy/checkout.rb
+- lib/capistrano/recipes/deploy/strategy/copy.rb
+- lib/capistrano/recipes/deploy/strategy/export.rb
+- lib/capistrano/recipes/deploy/strategy/remote.rb
+- lib/capistrano/recipes/deploy/strategy/remote_cache.rb
+- lib/capistrano/recipes/deploy/strategy.rb
+- lib/capistrano/recipes/deploy/templates/maintenance.rhtml
+- lib/capistrano/recipes/deploy.rb
+- lib/capistrano/recipes/standard.rb
+- lib/capistrano/recipes/templates/maintenance.rhtml
+- lib/capistrano/recipes/upgrade.rb
+- lib/capistrano/role.rb
+- lib/capistrano/server_definition.rb
+- lib/capistrano/shell.rb
+- lib/capistrano/ssh.rb
+- lib/capistrano/task_definition.rb
+- lib/capistrano/transfer.rb
+- lib/capistrano/version.rb
+- lib/capistrano.rb
+- Rakefile
+- README.rdoc
+- setup.rb
+- test/cli/execute_test.rb
+- test/cli/help_test.rb
+- test/cli/options_test.rb
+- test/cli/ui_test.rb
+- test/cli_test.rb
+- test/command_test.rb
+- test/configuration/actions/file_transfer_test.rb
+- test/configuration/actions/inspect_test.rb
+- test/configuration/actions/invocation_test.rb
+- test/configuration/callbacks_test.rb
+- test/configuration/connections_test.rb
+- test/configuration/execution_test.rb
+- test/configuration/loading_test.rb
+- test/configuration/namespace_dsl_test.rb
+- test/configuration/roles_test.rb
+- test/configuration/servers_test.rb
+- test/configuration/variables_test.rb
+- test/configuration_test.rb
+- test/deploy/local_dependency_test.rb
+- test/deploy/remote_dependency_test.rb
+- test/deploy/scm/accurev_test.rb
+- test/deploy/scm/base_test.rb
+- test/deploy/scm/git_test.rb
+- test/deploy/scm/mercurial_test.rb
+- test/deploy/strategy/copy_test.rb
+- test/extensions_test.rb
+- test/fixtures/cli_integration.rb
+- test/fixtures/config.rb
+- test/fixtures/custom.rb
+- test/logger_test.rb
+- test/role_test.rb
+- test/server_definition_test.rb
+- test/shell_test.rb
+- test/ssh_test.rb
+- test/task_definition_test.rb
+- test/transfer_test.rb
+- test/utils.rb
+- Manifest
+- capistrano.gemspec
+- test/deploy/scm/none_test.rb
+has_rdoc: true
+homepage: http://www.capify.org
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Capistrano
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: capistrano
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Capistrano is a utility and framework for executing commands in parallel on multiple remote machines, via SSH.
+test_files: 
+- test/cli/execute_test.rb
+- test/cli/help_test.rb
+- test/cli/options_test.rb
+- test/cli/ui_test.rb
+- test/cli_test.rb
+- test/command_test.rb
+- test/configuration/actions/file_transfer_test.rb
+- test/configuration/actions/inspect_test.rb
+- test/configuration/actions/invocation_test.rb
+- test/configuration/callbacks_test.rb
+- test/configuration/connections_test.rb
+- test/configuration/execution_test.rb
+- test/configuration/loading_test.rb
+- test/configuration/namespace_dsl_test.rb
+- test/configuration/roles_test.rb
+- test/configuration/servers_test.rb
+- test/configuration/variables_test.rb
+- test/configuration_test.rb
+- test/deploy/local_dependency_test.rb
+- test/deploy/remote_dependency_test.rb
+- test/deploy/scm/accurev_test.rb
+- test/deploy/scm/base_test.rb
+- test/deploy/scm/git_test.rb
+- test/deploy/scm/mercurial_test.rb
+- test/deploy/scm/none_test.rb
+- test/deploy/strategy/copy_test.rb
+- test/extensions_test.rb
+- test/logger_test.rb
+- test/role_test.rb
+- test/server_definition_test.rb
+- test/shell_test.rb
+- test/ssh_test.rb
+- test/task_definition_test.rb
+- test/transfer_test.rb