edploy 2.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in edploy.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,92 @@
+edploy gem, and all code and files, excluding what's mentioned below:
+
+# Copyright (c) 2012 by Ewout Vonk, All rights reserved.
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+fast_remote_cache rails plugin:
+
+# Copyright (c) 2008 by 37signals, LLC
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+multistage capistrano extension:
+
+# Copyright (c) 2006 Jamis Buck
+# 
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+# 
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+mailer capistrano plugin:
+
+# Copyright (c) 2009   9thBit LLC   (http://www.9thbit.net)
+# Copyright (c) 2007-8 Sagebit, LLC (http://www.sagebit.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc.fast_remote_cache

@@ -0,0 +1,48 @@
+= Fast Remote Cache
+
+The FastRemoteCache is a custom deployment strategy that specializes the standard RemoteCache strategy. It works just like the RemoteCache, but instead of actually copying the cache to the final release directory, it uses a custom "copy.rb" script to hard link the files. This allows the copy stage to be very fast.
+
+For small applications, and especially for those that aren't bundling vendor/rails, this won't make much of a difference. But for large applications the speed-up will be significant.
+
+== Dependencies
+
+* Capistrano 2 or later (http://www.capify.org)
+
+== Assumptions
+
+The FastRemoteCache, as the RemoteCache, assumes that your source repository is accessible from both your local (deploying) host, as well as the remote (target) hosts. If either of these is not true, you will not be able to use the FastRemoteCache strategy.
+
+Furthermore, it assumes that you have Ruby (1.8.6, preferably) installed on the target machines. If it is not installed in a standard location, you can set the :ruby variable to the location of the ruby executable.
+
+== Usage
+
+When using this with Rails applications, all you need to do is install this as a plugin in your application. Make sure your Capfile has a line like the following:
+
+  Dir['vendor/plugins/*/recipes/*.rb'].each { |plugin| load(plugin) }
+
+It should be just before the line that loads the 'config/deploy' file. If that line is not there, add it (or rerun "capify .").
+
+If you are not using this with a Rails application, you'll need to explicitly load recipes/fast_remote_cache.rb in your Capfile.
+
+Next, tell Capistrano to use the fast_remote_cache deployment strategy by putting the following line in your config/deploy.rb (or Capfile, if you aren't deploying a Rails app):
+
+  set :deploy_via, :fast_remote_cache
+
+Lastly, if you want to exclude certain directories or files from being deployed, set the copy_exclude variable:
+
+  set :copy_exclude, %w(test .git doc config/database.yml)
+
+The copy_exclude array can also include glob patterns, if you want to get tricky.
+
+== Tips
+
+For the fastest possible deploys:
+
+* Always deploy as the same user. If you're part of a team where everyone can (and does) deploy, create a new user (e.g., "deploy") and set it up so that your team can all log in as this user. Make sure this user also has read access to your source code repository.
+* Avoid sudo if at all possible. set(:use_sudo, false), and then make sure that the deploy user has sufficient permissions to start and stop the mongrels, write to the necessary directories, etc.
+* Disable the "group_writable" setting: set(:group_writable, false). This is only necessary when you have multiple users deploying.
+* Don't include Rails (or other large libraries) in your application. Yes, it is convenient to include them, but they bloat your app and make checkouts and copies much slower. You have to balance convenience in development versus speed of deployment. Find a compromise that works for you.
+
+== License
+
+This code is released under the MIT license, and is copyright (c) 2008 by 37signals, LLC. Please see the accompanying LICENSE file for the full text of the license.

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/TODO.TXT

@@ -0,0 +1,17 @@
+- minimal_output integrated with hooks like deploy hooks, but then for output
+- heroku style output
+- mailer (mailing of notifications; mailing of actual deploy output)
+
+--
+
+- add bundle_path and bundle_without to deploy.yml + configuration questions
+- make prepare tasks standard part of deploygen, turn it on/off in deploy.yml
+
+--
+
+- add configuration (enabling) of smart deploys
+- extend dploy script to enable auto-detection of current stage (check current git branch, find stage which has that branch configured for deployment)
+
+--
+
+- add process launcher to system wide scripts, which outputs output line-by-line

data/bin/dploy

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# Copyright (c) 2009-2012 by Ewout Vonk. All rights reserved.
+
+abort "Please run this command from the Rails.root" unless File.file?('config/routes.rb')
+
+if ENV['BUNDLE_GEMFILE'].nil? || ENV['BUNDLE_BIN_PATH'].nil?
+  system([ 'bundle', 'exec', File.basename($0), ARGV.first ].compact.join(' '))
+end
+
+def determine_stage
+  stage = ARGV.first || 'staging'
+end
+
+system("cap #{determine_stage} deploy:smart")

data/bin/dploygen

@@ -0,0 +1,39 @@
+#!/usr/bin/env ruby
+
+# Copyright (c) 2009-2012 by Ewout Vonk. All rights reserved.
+
+abort "Please run this command from the Rails.root" unless File.file?('config/routes.rb')
+
+if ENV['BUNDLE_GEMFILE'].nil? || ENV['BUNDLE_BIN_PATH'].nil?
+  system([ 'bundle', 'exec', File.basename($0) ].compact.join(' '))
+end
+
+require 'edployscripts'
+
+def scripts(match_glob = "*", ignore_globs = [])
+  Dir[File.join(::RAILS_ROOT, 'config', 'edploy', 'scripts', 'edploygen', match_glob)].sort.each do |script_file|
+    script_name = File.basename(script_file)
+    next if ignore_globs.any? { |glob| File.fnmatch?(glob, script_name) }
+    script script_name
+  end
+end
+
+def script(script_name)
+  cmd = File.join(::RAILS_ROOT, 'config', 'edploy', 'scripts', 'edploygen', script_name.to_s)
+  system(cmd) or abort "error while running `#{cmd}'"
+end
+
+begin
+  scripts "*.pre"
+  Edploy::Git.stash :silent => true
+  scripts "*", %w(*.pre *.post)
+  Edploy::Git.commit :message => 'edploygen', :silent => true
+  Edploy::Git.push :silent => true
+  scripts "*.post"
+rescue SystemExit => e
+  Edploy::Git.reset :hard => true
+  Edploy::Git.stash :pop, :silent => true
+  exit(1)
+rescue Exception => e
+  raise e
+end

data/bin/dployify

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+# Copyright (c) 2009-2012 by Ewout Vonk. All rights reserved.
+
+abort "Please run this command from the Rails.root" unless File.file?('config/routes.rb')
+
+if ENV['BUNDLE_GEMFILE'].nil? || ENV['BUNDLE_BIN_PATH'].nil?
+  system([ 'bundle', 'exec', File.basename($0) ].compact.join(' '))
+end
+
+require 'open3'
+require 'edployify'
+
+RAILS_ROOT = Dir.getwd
+
+if ARGV.include?('prefs')
+	Edployify::Preferences.configure
+else
+	Edployify::Project.before_capify_clean
+	Open3.popen3("capify .") do
+		puts "Running `capify .'"
+	end
+	Edployify::Project.after_capify_clean
+	Edployify::Template.make_dirs
+	Edployify::Configuration.configure
+	Edployify::Template.generate_templates(Edployify::Configuration.get_binding)
+	puts "[done] edployified!"
+end
+

data/edploy.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "edploy"
+  s.version     = "2.0.0"
+  s.authors     = ["Ewout Vonk"]
+  s.email       = ["dev@ewout.to"]
+  s.homepage    = "https://github.com/ewoutvonk/edploy"
+  s.summary     = %q{A gem which allows for fast, easy and efficient deploys with capistrano}
+  s.description = %q{A gem which allows for fast, easy and efficient deploys with capistrano}
+
+  s.rubyforge_project = "edploy"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency "capistrano"
+end

data/lib/capistrano/ext/mailer.rb

@@ -0,0 +1,90 @@
+# Copyright (c) 2009-2011 by Ewout Vonk. All rights reserved.
+# Copyright (c) 2009   9thBit LLC   (http://www.9thbit.net)
+# Copyright (c) 2007-8 Sagebit, LLC (http://www.sagebit.com)
+
+# prevent loading when called by Bundler, only load when called by capistrano
+if caller.any? { |callstack_line| callstack_line =~ /^Capfile:/ }
+  unless Capistrano::Configuration.respond_to?(:instance)
+    abort "capistrano-mailer requires Capistrano 2"
+  end
+  
+  require 'action_mailer' unless defined?(ActionMailer)
+  
+  module Capistrano
+    module Configuration
+      
+      class ActionMailer < ActionMailer::Base
+        delivery_method = :smtp
+
+        smtp_settings = {
+          :address              => 'localhost',
+          :port                 => 25,
+          :enable_starttls_auto => false
+        }
+
+        default :charset => 'utf-8'
+
+        def notify(textbody, options, mail_attachments)
+          mail_attachments.each do |filename, contents|
+            if File.exists?(filename.to_s)
+              attachments[File.basename(filename.to_s)] = File.read(filename.to_s)
+            elsif File.exists?(contents.to_s)
+              attachments[File.basename(contents.to_s)] = File.read(contents.to_s)
+            else
+              attachments[File.basename(filename.to_s)] = contents
+            end
+          end
+          mail(options) do |format|
+            format.text { render :text => textbody }
+          end
+        end        
+      end
+      
+      class Mailer
+        
+        def send(sender, recipients, subject, text_body, cc = nil, bcc = nil, attachments = {})
+          configure
+          options = {
+            :from => sender,
+            :to => recipients,
+            :subject => subject,
+            :cc => cc,
+            :bcc => bcc
+          }
+          Capistrano::Configuration::ActionMailer.notify(textbody, options, attachments).deliver
+        end
+
+        private
+        
+        def configure
+          return if @configured
+          if (fetch(:mailer_address, nil) || fetch(:mailer_port, nil) || fetch(:mailer_domain, nil))
+            Capistrano::Configuration::ActionMailer.delivery_method = :smtp
+            Capistrano::Configuration::ActionMailer.smtp_settings = {
+              :address              => fetch(:mailer_address, 'localhost'),
+              :port                 => fetch(:mailer_port, 25),
+              :domain               => fetch(:mailer_domain, nil), # example: "default.com"
+              :user_name            => fetch(:mailer_user_name, nil), # example: "releases@example.com"
+              :password             => fetch(:mailer_password, nil), # example: "mypassword"
+              :authentication       => fetch(:mailer_authentication, nil), # example: :login
+              :openssl_verify_mode  => fetch(:mailer_openssl_verify_mode, nil),
+              :enable_starttls_auto => fetch(:mailer_enable_starttls_auto, false)
+            }
+          elsif (location = fetch(:mailer_location, nil))
+            Capistrano::Configuration::ActionMailer.delivery_method = :sendmail
+            Capistrano::Configuration::ActionMailer.sendmail_settings = {
+              :location             => location, 
+              :arguments            => fetch(:mailer_arguments, nil)
+            }
+          end
+          Capistrano::Configuration::ActionMailer.default :charset => fetch(:mailer_default_charset, 'utf-8')
+          @configured = true
+        end
+                
+      end
+    end
+  end
+  
+  Capistrano.plugin :mailer, Capistrano::Configuration::Mailer
+
+end

data/lib/capistrano/ext/multistage.rb

@@ -0,0 +1,59 @@
+# ---------------------------------------------------------------------------
+# This file is distributed under the terms of the MIT license by Jamis Buck,
+# and is copyright (c) 2006 by the same. See the MIT-LICENSE file distributed
+# with this file for the complete text of the license.
+# ---------------------------------------------------------------------------
+require 'fileutils'
+location = File.join(rails_root, 'config', 'edploy', 'stages')
+
+unless exists?(:stages)
+  set :stages, Dir["#{location}/*.rb"].map { |f| File.basename(f, ".rb") }
+end
+
+stages.each do |name| 
+  desc "Set the target stage to `#{name}'."
+  task(name) do 
+    set :stage, name.to_sym 
+    load "#{location}/#{stage}.rb" 
+  end 
+end 
+
+on :load do
+  if stages.include?(ARGV.first)
+    # Execute the specified stage so that recipes required in stage can contribute to task list
+    find_and_execute_task(ARGV.first) if ARGV.any?{ |option| option =~ /-T|--tasks|-e|--explain/ }
+  else
+    # Execute the default stage so that recipes required in stage can contribute tasks
+    find_and_execute_task(default_stage) if exists?(:default_stage)
+  end
+end
+
+namespace :multistage do
+  desc "[internal] Ensure that a stage has been selected."
+  task :ensure do
+    if !exists?(:stage)
+      if exists?(:default_stage)
+        logger.important "Defaulting to `#{default_stage}'"
+        find_and_execute_task(default_stage)
+      else
+        abort "No stage specified. Please specify one of: #{stages.join(', ')} (e.g. `cap #{stages.first} #{ARGV.last}')"
+      end
+    end 
+  end
+
+  desc "Stub out the staging config files."
+  task :prepare do
+    FileUtils.mkdir_p(location)
+    stages.each do |name|
+      file = File.join(location, name + ".rb")
+      unless File.exists?(file)
+        File.open(file, "w") do |f|
+          f.puts "# #{name.upcase}-specific deployment configuration"
+          f.puts "# please put general deployment config in config/deploy.rb"
+        end
+      end
+    end
+  end
+end
+
+on :start, "multistage:ensure", :except => stages + ['multistage:prepare']

data/lib/capistrano/ext/output_catcher.rb

@@ -0,0 +1,97 @@
+# Copyright (c) 2009-2011 by Ewout Vonk. All rights reserved.
+
+# prevent loading when called by Bundler, only load when called by capistrano
+if caller.any? { |callstack_line| callstack_line =~ /^Capfile:/ }
+  unless Capistrano::Configuration.respond_to?(:instance)
+    abort "capistrano-catch-output requires Capistrano 2"
+  end
+
+  require 'stringio'
+
+  module Capistrano
+    module OutputCatcher
+      class TeeIO
+
+        attr_accessor :sniffed_io_stream, :listening_io_stream
+
+        def initialize(sniffed_io_stream, listening_io_stream)
+          self.sniffed_io_stream = sniffed_io_stream
+          self.listening_io_stream = listening_io_stream
+        end
+
+        def distribute(method_name, *args, &block)
+          [ listening_io_stream, sniffed_io_stream ].each do |io_stream|
+            io_stream.send(method_name, *args, &block)
+          end
+        end
+
+        def method_missing(method_name, *args, &block)
+          distribute(method_name, *args, &block)
+        end
+
+      end
+    
+      class OutputChannels
+      
+        attr_accessor :out, :err
+      
+        def initialize(out, err)
+          self.out = out
+          self.err = err
+        end
+      
+      end
+
+      module Base
+      
+        def capture_output(out = StringIO.new, err = nil)
+          create_capture_channels(out, err)
+          reroute_original_channels
+          override_output_channels(out, err)
+        end
+      
+        def tee_output(out = StringIO.new, err = nil)
+          create_capture_channels(out, err)
+          reroute_original_channels
+          override_output_channels(TeeIO.new($std.out, out), TeeIO.new($std.err, err))
+        end
+      
+        def end_capture
+          out_output = $capstd.out.string
+          err_output = $capstd.err.string
+          $capoutput = [ out_output, err_output ]
+        end
+
+        private
+      
+        def override_output_channels(out, err)
+          logger.instance_variable_set(:@device, (logger.device == $std.err) ? err : out)
+          $stdout = out
+          $stderr = err
+        end
+      
+        def create_capture_channels(out = StringIO.new, err = nil)
+          err ||= out
+          $capstd = OutputChannels.new(out, err)
+        end
+
+        def reroute_original_channels
+          $std = OutputChannels.new($stdout, $stderr)
+        end
+      
+      end
+    end
+  end
+
+  Capistrano.plugin :output_catcher, Capistrano::OutputCatcher::Base
+
+  Capistrano::Configuration.instance(:must_exist).load do
+    trap("EXIT") do
+      output_catcher.end_capture
+      if defined?(capistrano_output_handler) == "method"
+        capistrano_output_handler
+      end
+    end
+  end
+
+end

data/lib/capistrano/ext/output_hooks.rb

@@ -0,0 +1,54 @@
+# Copyright (c) 2009-2011 by Ewout Vonk. All rights reserved.
+
+# prevent loading when called by Bundler, only load when called by capistrano
+if caller.any? { |callstack_line| callstack_line =~ /^Capfile:/ }
+  unless Capistrano::Configuration.respond_to?(:instance)
+    abort "capistrano-minimal-output requires Capistrano 2"
+  end
+
+  require "capistrano-catch-output"
+  require "capistrano-mailer"
+
+  Capistrano::Configuration.instance(:must_exist).load do
+
+    output_catcher.capture_output
+
+    task :capistrano_output_handler do
+      email_body = $capistrano_out.string
+      email_subject = "capistrano output"
+      mailer.send(fetch(:mail_sender), fetch(:mail_recipients), email_subject, email_body)
+    end
+
+    namespace :capistrano_catch_output do
+    
+      namespace :handlers do
+      
+        namespace :on do
+          task :bundle_install do
+            puts "-----> Gemfile detected, running Bundler version X.Y.Z"
+          end
+        end
+      
+        namespace :before do
+          task :bundle_install do
+            output_catcher.tee_output
+          end
+        end
+      
+        namespace :after do
+          task :bundle_install do
+            output_catcher.capture_output
+          end
+        end
+      
+      end
+    
+    end
+  
+    before 'bundle:install', 'capistrano_catch_output:handlers:before:bundle_install'
+    after 'bundle:install', 'capistrano_catch_output:handlers:after:bundle_install'
+    on 'bundle:install', 'capistrano_catch_output:handlers:on:bundle_install'
+
+  end
+
+end

data/lib/capistrano/recipes/deploy/strategy/fast_remote_cache.rb

@@ -0,0 +1,44 @@
+# ---------------------------------------------------------------------------
+# This implements a specialization of the standard Capistrano RemoteCache
+# deployment strategy. The most significant difference between this strategy
+# and the RemoteCache is the way the cache is copied to the final release
+# directory: it uses the bundled "copy.rb" script to use hard links to the
+# files instead of actually copying, so the copy stage is much, much faster.
+# ---------------------------------------------------------------------------
+# This file is distributed under the terms of the MIT license by 37signals,
+# LLC, and is copyright (c) 2008 by the same. See the MIT-LICENSE file distributed
+# with this file for the complete text of the license.
+# ---------------------------------------------------------------------------
+require 'capistrano/recipes/deploy/strategy/remote_cache'
+
+class Capistrano::Deploy::Strategy::FastRemoteCache < Capistrano::Deploy::Strategy::RemoteCache
+  def check!
+    super.check do |d|
+      d.remote.command(configuration.fetch(:ruby, "ruby"))
+      d.remote.directory(bin_path)
+      d.remote.file(File.join(bin_path, "copy.rb"))
+    end
+  end
+
+  def setup!
+    run "mkdir -p #{bin_path}"
+    upload(File.join(File.dirname(__FILE__), "utilities", "copy.rb"), File.join(bin_path, "copy.rb"))
+  end
+
+  def prepare!
+    update_repository_cache
+  end
+
+  private
+
+    def bin_path
+      @bin_path ||= File.join(configuration[:shared_path], "bin")
+    end
+
+    def copy_repository_cache
+      logger.trace "copying the cached version to #{configuration[:release_path]}"
+      ruby = configuration.fetch(:ruby, "ruby")
+      excludes = Array(configuration[:copy_exclude]).join(" ")
+      run "#{ruby} #{File.join(bin_path, 'copy.rb')} #{repository_cache} #{configuration[:release_path]} #{excludes} && #{mark}"
+    end
+end