0
@@ -148,8 +148,8 @@
0
 be processed recursively, with all files being pushed to the deployment \
0
 servers. Any file or directory starting with a '.' character will be ignored.
0
 
0
-  $ cap deploy:update_files FILES=templates,controller.rb"
0
-  task :update_files, :except => { :no_release => true } do
0
+  $ cap deploy:upload FILES=templates,controller.rb"
0
+  task :upload, :except => { :no_release => true } do
0
     files = (ENV["FILES"] || "").
0
       split(",").
0
       map { |f| f.strip!; File.directory?(f) ? Dir["#{f}/**/*"] : f }.
0
@@ -252,6 +252,22 @@
0
         File.join(releases_path, release) }.join(" ")
0
 
0
       invoke_command "rm -rf #{directories}", :via => fetch(:cleanup_via, :sudo)
0
+    end
0
+  end
0
+
0
+desc "Test deployment dependencies. Checks things like directory permissions, \
0
+necessary utilities, and so forth, reporting on the things that appear to be \
0
+incorrect or missing. This is good for making sure a deploy has a chance of \
0
+working before you actually run `cap deploy'!"
0
+  task :check, :except => { :no_release => true } do
0
+    dependencies = strategy.check!
0
+    if dependencies.pass?
0
+      puts "You appear to have all necessary dependencies installed"
0
+    else
0
+      puts "The following dependencies failed. Please check them and try again:"
0
+      dependencies.reject { |d| d.pass? }.each do |d|
0
+        puts "--> #{d.message}"
0
+      end
0
     end
0
   end
0
 

0
@@ -1 +1,45 @@
0
+require 'capistrano/recipes/deploy/local_dependency'
0
+require 'capistrano/recipes/deploy/remote_dependency'
0
+
0
+module Capistrano
0
+  module Deploy
0
+    class Dependencies
0
+      include Enumerable
0
+
0
+      attr_reader :configuration
0
+
0
+      def initialize(configuration)
0
+        @configuration = configuration
0
+        @dependencies = []
0
+        yield self if block_given?
0
+      end
0
+
0
+      def check
0
+        yield self
0
+        self
0
+      end
0
+  
0
+      def remote
0
+        dep = RemoteDependency.new(configuration)
0
+        @dependencies << dep
0
+        dep
0
+      end
0
+
0
+      def local
0
+        dep = LocalDependency.new(configuration)
0
+        @dependencies << dep
0
+        dep
0
+      end
0
+
0
+      def each
0
+        @dependencies.each { |d| yield d }
0
+        self
0
+      end
0
+
0
+      def pass?
0
+        all? { |d| d.pass? }
0
+      end
0
+    end
0
+  end
0
+end

0
@@ -1 +1,47 @@
0
+module Capistrano
0
+  module Deploy
0
+    class LocalDependency
0
+      attr_reader :configuration
0
+      attr_reader :message
0
+
0
+      def initialize(configuration)
0
+        @configuration = configuration
0
+        @success = true
0
+      end
0
+
0
+      def expects_in_path(command)
0
+        @message ||= "`#{command}' could not be found in the path on the local host"
0
+        @success = find_in_path(command)
0
+        self
0
+      end
0
+
0
+      def or(message)
0
+        @message = message
0
+        self
0
+      end
0
+
0
+      def pass?
0
+        @success
0
+      end
0
+
0
+    private
0
+
0
+      # Searches the path, looking for the given utility. If an executable
0
+      # file is found that matches the parameter, this returns true.
0
+      def find_in_path(utility)
0
+        path = (ENV['PATH'] || "").split(File::PATH_SEPARATOR)
0
+        suffixes = RUBY_PLATFORM =~ /mswin/ ? %w(.bat .exe .com .cmd) : [""]
0
+
0
+        path.each do |dir|
0
+          suffixes.each do |sfx|
0
+            file = File.join(dir, utility + sfx)
0
+            return true if File.executable?(file)
0
+          end
0
+        end
0
+
0
+        false
0
+      end
0
+    end
0
+  end
0
+end

0
@@ -1 +1,59 @@
0
+module Capistrano
0
+  module Deploy
0
+    class RemoteDependency
0
+      attr_reader :configuration
0
+      attr_reader :hosts
0
+
0
+      def initialize(configuration)
0
+        @configuration = configuration
0
+        @success = true
0
+      end
0
+
0
+      def expect_directory(path)
0
+        @message ||= "`#{path}' is not a directory"
0
+        try("test -d #{path}")
0
+        self
0
+      end
0
+
0
+      def expect_writable(path)
0
+        @message ||= "`#{path}' is not writable"
0
+        try("test -w #{path}")
0
+        self
0
+      end
0
+
0
+      def expects_in_path(command)
0
+        @message ||= "`#{command}' could not be found in the path"
0
+        try("type -p #{command}")
0
+        self
0
+      end
0
+
0
+      def or(message)
0
+        @message = message
0
+        self
0
+      end
0
+
0
+      def pass?
0
+        @success
0
+      end
0
+
0
+      def message
0
+        s = @message.dup
0
+        s << " (#{@hosts})" if @hosts && @hosts.any?
0
+        s
0
+      end
0
+
0
+    private
0
+
0
+      def try(command)
0
+        return unless @success # short-circuit evaluation
0
+        configuration.run(command) do |ch,stream,out|
0
+          warn "#{ch[:host]}: #{out}" if stream == :err
0
+        end
0
+      rescue Capistrano::CommandError => e
0
+        @success = false
0
+        @hosts = e.hosts.join(', ')
0
+      end
0
+    end
0
+  end
0
+end

0
@@ -84,6 +84,13 @@
0
           nil
0
         end
0
 
0
+        # Returns the name of the command-line utility for this SCM. It first
0
+        # looks at the :scm_command variable, and if it does not exist, it
0
+        # then falls back to whatever was defined by +default_command+.
0
+        def command
0
+          configuration[:scm_command] || default_command
0
+        end
0
+
0
         private
0
 
0
           # A reference to a Logger instance that the SCM can use to log
0
@@ -103,13 +110,6 @@
0
           # with the scm command prefixed onto it.
0
           def scm(*args)
0
             [command, *args].compact.join(" ")
0
-          end
0
-
0
-          # Returns the name of the command-line utility for this SCM. It first
0
-          # looks at the :scm_command variable, and if it does not exist, it
0
-          # then falls back to whatever was defined by +default_command+.
0
-          def command
0
-            configuration[:scm_command] || default_command
0
           end
0
 
0
           # A convenience method for accessing the declared repository value.

0
@@ -1,3 +1,5 @@
0
+require 'capistrano/recipes/deploy/dependencies'
0
+
0
 module Capistrano
0
   module Deploy
0
     module Strategy
0
@@ -22,6 +24,16 @@
0
           raise NotImplementedError, "`deploy!' is not implemented by #{self.class.name}"
0
         end
0
 
0
+        # Performs a check on the remote hosts to determine whether everything
0
+        # is setup such that a deploy could succeed.
0
+        def check!
0
+          Dependencies.new(configuration) do |d|
0
+            d.remote.expect_directory(configuration[:releases_path]).or("`#{configuration[:releases_path]}' does not exist. Please run `cap deploy:setup'.")
0
+            d.remote.expect_writable(configuration[:deploy_to]).or("You do not have permissions to write to `#{configuration[:deploy_to]}'.")
0
+            d.remote.expect_writable(configuration[:releases_path]).or("You do not have permissions to write to `#{configuration[:releases_path]}'.")
0
+          end
0
+        end
0
+          
0
         protected
0
 
0
           # This is to allow helper methods like "run" and "put" to be more

0
@@ -38,6 +38,14 @@
0
           FileUtils.rm_rf destination rescue nil
0
         end
0
 
0
+        def check!
0
+          super.check do |d|
0
+            d.local.expects_in_path(source.command)
0
+            d.local.expects_in_path(compress(nil, nil).first)
0
+            d.remote.expects_in_path(decompress(nil).first)
0
+          end
0
+        end
0
+
0
         private
0
 
0
           # Returns the basename of the release_path, which will be used to
0
0
0
0
@@ -92,23 +100,28 @@
0
           end
0
 
0
           # Returns the command necessary to compress the given directory
0
-          # into the given file.
0
+          # into the given file. The command is returned as an array, where
0
+          # the first element is the utility to be used to perform the compression.
0
           def compress(directory, file)
0
             case compression
0
-            when :gzip, :gz   then "tar czf #{file} #{directory}"
0
-            when :bzip2, :bz2 then "tar cjf #{file} #{directory}"
0
-            when :zip         then "zip -qr #{file} #{directory}"
0
+            when :gzip, :gz   then ["tar", "czf", file, directory]
0
+            when :bzip2, :bz2 then ["tar", "cjf", file, directory]
0
+            when :zip         then ["zip", "-qr", file, directory]
0
+            else raise ArgumentError, "invalid compression type #{compression.inspect}"
0
             end
0
           end
0
 
0
           # Returns the command necessary to decompress the given file,
0
           # relative to the current working directory. It must also
0
-          # preserve the directory structure in the file.
0
+          # preserve the directory structure in the file. The command is returned
0
+          # as an array, where the first element is the utility to be used to
0
+          # perform the decompression.
0
           def decompress(file)
0
             case compression
0
-            when :gzip, :gz   then "tar xzf #{file}"
0
-            when :bzip2, :bz2 then "tar xjf #{file}"
0
-            when :zip         then "unzip -q #{file}"
0
+            when :gzip, :gz   then ["tar", "xzf", file]
0
+            when :bzip2, :bz2 then ["tar", "xjf", file]
0
+            when :zip         then ["unzip", "-q", file]
0
+            else raise ArgumentError, "invalid compression type #{compression.inspect}"
0
             end
0
           end
0
       end

0
@@ -15,6 +15,11 @@
0
           scm_run "#{command} && #{mark}"
0
         end
0
 
0
+        def check!
0
+          result = super
0
+          test("type -p #{source.command}", "could not find `#{source.command}'") && result
0
+        end
0
+
0
         protected
0
 
0
           # Runs the given command, filtering output back through the

0
@@ -1178,7 +1178,7 @@
0
   end
0
 
0
   def ruby_scripts
0
-    collect_filenames_auto().select {|n| /\.r(b|html)\z/ =~ n}
0
+    collect_filenames_auto().select {|n| /\.(r(b|html)|txt)\z/ =~ n}
0
   end
0
   
0
   # picked up many entries from cvs-1.11.1/src/ignore.c