RubyGems - le1t0-capistrano - Versions diffs - 2.5.18.001 - Mend

le1t0-capistrano 2.5.18.001

Files changed (107) hide show

data/.gitignore +9 -0
data/CHANGELOG +843 -0
data/README +102 -0
data/Rakefile +36 -0
data/VERSION +1 -0
data/bin/cap +4 -0
data/bin/capify +86 -0
data/lib/capistrano.rb +2 -0
data/lib/capistrano/callback.rb +45 -0
data/lib/capistrano/cli.rb +47 -0
data/lib/capistrano/cli/execute.rb +85 -0
data/lib/capistrano/cli/help.rb +125 -0
data/lib/capistrano/cli/help.txt +78 -0
data/lib/capistrano/cli/options.rb +243 -0
data/lib/capistrano/cli/ui.rb +40 -0
data/lib/capistrano/command.rb +283 -0
data/lib/capistrano/configuration.rb +44 -0
data/lib/capistrano/configuration/actions/file_transfer.rb +52 -0
data/lib/capistrano/configuration/actions/inspect.rb +46 -0
data/lib/capistrano/configuration/actions/invocation.rb +295 -0
data/lib/capistrano/configuration/callbacks.rb +148 -0
data/lib/capistrano/configuration/connections.rb +204 -0
data/lib/capistrano/configuration/execution.rb +143 -0
data/lib/capistrano/configuration/loading.rb +197 -0
data/lib/capistrano/configuration/namespaces.rb +197 -0
data/lib/capistrano/configuration/roles.rb +73 -0
data/lib/capistrano/configuration/servers.rb +98 -0
data/lib/capistrano/configuration/variables.rb +127 -0
data/lib/capistrano/errors.rb +19 -0
data/lib/capistrano/extensions.rb +57 -0
data/lib/capistrano/logger.rb +59 -0
data/lib/capistrano/processable.rb +53 -0
data/lib/capistrano/recipes/compat.rb +32 -0
data/lib/capistrano/recipes/deploy.rb +589 -0
data/lib/capistrano/recipes/deploy/dependencies.rb +44 -0
data/lib/capistrano/recipes/deploy/local_dependency.rb +54 -0
data/lib/capistrano/recipes/deploy/remote_dependency.rb +105 -0
data/lib/capistrano/recipes/deploy/scm.rb +19 -0
data/lib/capistrano/recipes/deploy/scm/accurev.rb +169 -0
data/lib/capistrano/recipes/deploy/scm/base.rb +196 -0
data/lib/capistrano/recipes/deploy/scm/bzr.rb +86 -0
data/lib/capistrano/recipes/deploy/scm/cvs.rb +152 -0
data/lib/capistrano/recipes/deploy/scm/darcs.rb +96 -0
data/lib/capistrano/recipes/deploy/scm/git.rb +278 -0
data/lib/capistrano/recipes/deploy/scm/mercurial.rb +137 -0
data/lib/capistrano/recipes/deploy/scm/none.rb +44 -0
data/lib/capistrano/recipes/deploy/scm/perforce.rb +138 -0
data/lib/capistrano/recipes/deploy/scm/subversion.rb +121 -0
data/lib/capistrano/recipes/deploy/strategy.rb +19 -0
data/lib/capistrano/recipes/deploy/strategy/base.rb +79 -0
data/lib/capistrano/recipes/deploy/strategy/checkout.rb +20 -0
data/lib/capistrano/recipes/deploy/strategy/copy.rb +218 -0
data/lib/capistrano/recipes/deploy/strategy/export.rb +20 -0
data/lib/capistrano/recipes/deploy/strategy/remote.rb +52 -0
data/lib/capistrano/recipes/deploy/strategy/remote_cache.rb +56 -0
data/lib/capistrano/recipes/deploy/templates/maintenance.rhtml +53 -0
data/lib/capistrano/recipes/standard.rb +37 -0
data/lib/capistrano/recipes/templates/maintenance.rhtml +53 -0
data/lib/capistrano/role.rb +102 -0
data/lib/capistrano/server_definition.rb +56 -0
data/lib/capistrano/shell.rb +260 -0
data/lib/capistrano/ssh.rb +99 -0
data/lib/capistrano/task_definition.rb +75 -0
data/lib/capistrano/transfer.rb +216 -0
data/lib/capistrano/version.rb +18 -0
data/test/cli/execute_test.rb +132 -0
data/test/cli/help_test.rb +165 -0
data/test/cli/options_test.rb +329 -0
data/test/cli/ui_test.rb +28 -0
data/test/cli_test.rb +17 -0
data/test/command_test.rb +286 -0
data/test/configuration/actions/file_transfer_test.rb +61 -0
data/test/configuration/actions/inspect_test.rb +65 -0
data/test/configuration/actions/invocation_test.rb +225 -0
data/test/configuration/callbacks_test.rb +220 -0
data/test/configuration/connections_test.rb +349 -0
data/test/configuration/execution_test.rb +175 -0
data/test/configuration/loading_test.rb +132 -0
data/test/configuration/namespace_dsl_test.rb +311 -0
data/test/configuration/roles_test.rb +144 -0
data/test/configuration/servers_test.rb +158 -0
data/test/configuration/variables_test.rb +184 -0
data/test/configuration_test.rb +88 -0
data/test/deploy/local_dependency_test.rb +76 -0
data/test/deploy/remote_dependency_test.rb +114 -0
data/test/deploy/scm/accurev_test.rb +23 -0
data/test/deploy/scm/base_test.rb +55 -0
data/test/deploy/scm/bzr_test.rb +51 -0
data/test/deploy/scm/darcs_test.rb +37 -0
data/test/deploy/scm/git_test.rb +184 -0
data/test/deploy/scm/mercurial_test.rb +134 -0
data/test/deploy/scm/none_test.rb +35 -0
data/test/deploy/scm/subversion_test.rb +32 -0
data/test/deploy/strategy/copy_test.rb +302 -0
data/test/extensions_test.rb +69 -0
data/test/fixtures/cli_integration.rb +5 -0
data/test/fixtures/config.rb +5 -0
data/test/fixtures/custom.rb +3 -0
data/test/logger_test.rb +123 -0
data/test/role_test.rb +11 -0
data/test/server_definition_test.rb +121 -0
data/test/shell_test.rb +90 -0
data/test/ssh_test.rb +104 -0
data/test/task_definition_test.rb +116 -0
data/test/transfer_test.rb +160 -0
data/test/utils.rb +39 -0
metadata +289 -0

data/lib/capistrano/recipes/deploy/templates/maintenance.rhtml ADDED Viewed

@@ -0,0 +1,53 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
+  <title>System down for maintenance</title>
+  <style type="text/css">
+    div.outer {
+      position: absolute;
+      left: 50%;
+      top: 50%;
+      width: 500px;
+      height: 300px;
+      margin-left: -260px;
+      margin-top: -150px;
+    }
+    .DialogBody {
+      margin: 0;
+      padding: 10px;
+      text-align: left;
+      border: 1px solid #ccc;
+      border-right: 1px solid #999;
+      border-bottom: 1px solid #999;
+      background-color: #fff;
+    }
+    body { background-color: #fff; }
+  </style>
+</head>
+<body>
+  <div class="outer">
+     <div class="DialogBody" style="text-align: center;">
+       <div style="text-align: center; width: 200px; margin: 0 auto;">
+         <p style="color: red; font-size: 16px; line-height: 20px;">
+           The system is down for <%= reason ? reason : "maintenance" %>
+           as of <%= Time.now.strftime("%H:%M %Z") %>.
+         </p>
+         <p style="color: #666;">
+           It'll be back <%= deadline ? deadline : "shortly" %>.
+         </p>
+       </div>
+     </div>
+  </div>
+</body>
+</html>

data/lib/capistrano/recipes/standard.rb ADDED Viewed

@@ -0,0 +1,37 @@
+desc <<-DESC
+  Invoke a single command on the remote servers. This is useful for performing \
+  one-off commands that may not require a full task to be written for them. \
+  Simply specify the command to execute via the COMMAND environment variable. \
+  To execute the command only on certain roles, specify the ROLES environment \
+  variable as a comma-delimited list of role names. Alternatively, you can \
+  specify the HOSTS environment variable as a comma-delimited list of hostnames \
+  to execute the task on those hosts, explicitly. Lastly, if you want to \
+  execute the command via sudo, specify a non-empty value for the SUDO \
+  environment variable.
+  Sample usage:
+    $ cap COMMAND=uptime HOSTS=foo.capistano.test invoke
+    $ cap ROLES=app,web SUDO=1 COMMAND="tail -f /var/log/messages" invoke
+DESC
+task :invoke do
+  command = ENV["COMMAND"] || ""
+  abort "Please specify a command to execute on the remote servers (via the COMMAND environment variable)" if command.empty?
+  method = ENV["SUDO"] ? :sudo : :run
+  invoke_command(command, :via => method)
+end
+desc <<-DESC
+  Begin an interactive Capistrano session. This gives you an interactive \
+  terminal from which to execute tasks and commands on all of your servers. \
+  (This is still an experimental feature, and is subject to change without \
+  notice!)
+  Sample usage:
+    $ cap shell
+DESC
+task :shell do
+  require 'capistrano/shell'
+  Capistrano::Shell.run(self)
+end

data/lib/capistrano/recipes/templates/maintenance.rhtml ADDED Viewed

@@ -0,0 +1,53 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+       "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <meta http-equiv="content-type" content="text/html;charset=UTF-8" />
+  <title>System down for maintenance</title>
+  <style type="text/css">
+    div.outer {
+      position: absolute;
+      left: 50%;
+      top: 50%;
+      width: 500px;
+      height: 300px;
+      margin-left: -260px;
+      margin-top: -150px;
+    }
+    .DialogBody {
+      margin: 0;
+      padding: 10px;
+      text-align: left;
+      border: 1px solid #ccc;
+      border-right: 1px solid #999;
+      border-bottom: 1px solid #999;
+      background-color: #fff;
+    }
+    body { background-color: #fff; }
+  </style>
+</head>
+<body>
+  <div class="outer">
+     <div class="DialogBody" style="text-align: center;">
+       <div style="text-align: center; width: 200px; margin: 0 auto;">
+         <p style="color: red; font-size: 16px; line-height: 20px;">
+           The system is down for <%= reason ? reason : "maintenance" %>
+           as of <%= Time.now.strftime("%H:%M %Z") %>.
+         </p>
+         <p style="color: #666;">
+           It'll be back <%= deadline ? deadline : "shortly" %>.
+         </p>
+       </div>
+     </div>
+  </div>
+</body>
+</html>

data/lib/capistrano/role.rb ADDED Viewed

@@ -0,0 +1,102 @@
+module Capistrano
+  class Role
+    include Enumerable
+    def initialize(*list)
+      @static_servers = []
+      @dynamic_servers = []
+      push(*list)
+    end
+    def each(&block)
+      servers.each &block
+    end
+    def push(*list)
+      options = list.last.is_a?(Hash) ? list.pop : {}
+      list.each do |item|
+        if item.respond_to?(:call)
+          @dynamic_servers << DynamicServerList.new(item, options)
+        else
+          @static_servers << self.class.wrap_server(item, options)
+        end
+      end
+    end
+    alias_method :<<, :push
+    def servers
+      @static_servers + dynamic_servers
+    end
+    alias_method :to_ary, :servers
+    def empty?
+      servers.empty?
+    end
+    def clear
+      @dynamic_servers.clear
+      @static_servers.clear
+    end
+    def include?(server)
+      servers.include?(server)
+    end
+    protected
+    # This is the combination of a block, a hash of options, and a cached value.
+    class DynamicServerList
+      def initialize (block, options)
+        @block = block
+        @options = options
+        @cached = []
+        @is_cached = false
+      end
+      # Convert to a list of ServerDefinitions
+      def to_ary
+        unless @is_cached
+          @cached = Role::wrap_list(@block.call(@options), @options)
+          @is_cached = true
+        end
+        @cached
+      end
+      # Clear the cached value
+      def reset!
+        @cached.clear
+        @is_cached = false
+      end
+    end
+    # Attribute reader for the cached results of executing the blocks in turn
+    def dynamic_servers
+      @dynamic_servers.inject([]) { |list, item| list.concat item }
+    end
+    # Wraps a string in a ServerDefinition, if it isn't already.
+    # This and wrap_list should probably go in ServerDefinition in some form.
+    def self.wrap_server (item, options)
+      item.is_a?(ServerDefinition) ? item : ServerDefinition.new(item, options)
+    end
+    # Turns a list, or something resembling a list, into a properly-formatted
+    # ServerDefinition list. Keep an eye on this one -- it's entirely too
+    # magical for its own good. In particular, if ServerDefinition ever inherits
+    # from Array, this will break.
+    def self.wrap_list (*list)
+      options = list.last.is_a?(Hash) ? list.pop : {}
+      if list.length == 1
+        if list.first.nil?
+          return []
+        elsif list.first.is_a?(Array)
+          list = list.first
+        end
+      end
+      options.merge! list.pop if list.last.is_a?(Hash)
+      list.map do |item|
+        self.wrap_server item, options
+      end
+    end
+  end
+end

data/lib/capistrano/server_definition.rb ADDED Viewed

@@ -0,0 +1,56 @@
+module Capistrano
+  class ServerDefinition
+    include Comparable
+    attr_reader :host
+    attr_reader :user
+    attr_reader :port
+    attr_reader :options
+    # The default user name to use when a user name is not explicitly provided
+    def self.default_user
+      ENV['USER'] || ENV['USERNAME'] || "not-specified"
+    end
+    def initialize(string, options={})
+      @user, @host, @port = string.match(/^(?:([^;,:=]+)@|)(.*?)(?::(\d+)|)$/)[1,3]
+      @options = options.dup
+      user_opt, port_opt = @options.delete(:user), @options.delete(:port)
+      @user ||= user_opt
+      @port ||= port_opt
+      @port = @port.to_i if @port
+    end
+    def <=>(server)
+      [host, port, user] <=> [server.host, server.port, server.user]
+    end
+    # Redefined, so that Array#uniq will work to remove duplicate server
+    # definitions, based solely on their host names.
+    def eql?(server)
+      host == server.host &&
+        user == server.user &&
+        port == server.port
+    end
+    alias :== :eql?
+    # Redefined, so that Array#uniq will work to remove duplicate server
+    # definitions, based on their connection information.
+    def hash
+      @hash ||= [host, user, port].hash
+    end
+    def to_s
+      @to_s ||= begin
+        s = host
+        s = "#{user}@#{s}" if user
+        s = "#{s}:#{port}" if port && port != 22
+        s
+      end
+    end
+  end
+end

data/lib/capistrano/shell.rb ADDED Viewed

@@ -0,0 +1,260 @@
+require 'thread'
+require 'capistrano/processable'
+module Capistrano
+  # The Capistrano::Shell class is the guts of the "shell" task. It implements
+  # an interactive REPL interface that users can employ to execute tasks and
+  # commands. It makes for a GREAT way to monitor systems, and perform quick
+  # maintenance on one or more machines.
+  class Shell
+    include Processable
+    # A Readline replacement for platforms where readline is either
+    # unavailable, or has not been installed.
+    class ReadlineFallback #:nodoc:
+      HISTORY = []
+      def self.readline(prompt)
+        STDOUT.print(prompt)
+        STDOUT.flush
+        STDIN.gets
+      end
+    end
+    # The configuration instance employed by this shell
+    attr_reader :configuration
+    # Instantiate a new shell and begin executing it immediately.
+    def self.run(config)
+      new(config).run!
+    end
+    # Instantiate a new shell
+    def initialize(config)
+      @configuration = config
+    end
+    # Start the shell running. This method will block until the shell
+    # terminates.
+    def run!
+      setup
+      puts <<-INTRO
+====================================================================
+Welcome to the interactive Capistrano shell! This is an experimental
+feature, and is liable to change in future releases. Type 'help' for
+a summary of how to use the shell.
+--------------------------------------------------------------------
+INTRO
+      loop do
+        break if !read_and_execute
+      end
+      @bgthread.kill
+    end
+    def read_and_execute
+      command = read_line
+      case command
+        when "?", "help" then help
+        when "quit", "exit" then
+          puts "exiting"
+          return false
+        when /^set -(\w)\s*(\S+)/
+          set_option($1, $2)
+        when /^(?:(with|on)\s*(\S+))?\s*(\S.*)?/i
+          process_command($1, $2, $3)
+        else
+          raise "eh?"
+      end
+      return true
+    end
+    private
+      # Present the prompt and read a single line from the console. It also
+      # detects ^D and returns "exit" in that case. Adds the input to the
+      # history, unless the input is empty. Loops repeatedly until a non-empty
+      # line is input.
+      def read_line
+        loop do
+          command = reader.readline("cap> ")
+          if command.nil?
+            command = "exit"
+            puts(command)
+          else
+            command.strip!
+          end
+          unless command.empty?
+            reader::HISTORY << command
+            return command
+          end
+        end
+      end
+      # Display a verbose help message.
+      def help
+        puts <<-HELP
+--- HELP! ---------------------------------------------------
+"Get me out of this thing. I just want to quit."
+-> Easy enough. Just type "exit", or "quit". Or press ctrl-D.
+"I want to execute a command on all servers."
+-> Just type the command, and press enter. It will be passed,
+   verbatim, to all defined servers.
+"What if I only want it to execute on a subset of them?"
+-> No problem, just specify the list of servers, separated by
+   commas, before the command, with the `on' keyword:
+   cap> on app1.foo.com,app2.foo.com echo ping
+"Nice, but can I specify the servers by role?"
+-> You sure can. Just use the `with' keyword, followed by the
+   comma-delimited list of role names:
+   cap> with app,db echo ping
+"Can I execute a Capistrano task from within this shell?"
+-> Yup. Just prefix the task with an exclamation mark:
+   cap> !deploy
+HELP
+      end
+      # Determine which servers the given task requires a connection to, and
+      # establish connections to them if necessary. Return the list of
+      # servers (names).
+      def connect(task)
+        servers = configuration.find_servers_for_task(task)
+        needing_connections = servers - configuration.sessions.keys
+        unless needing_connections.empty?
+          puts "[establishing connection(s) to #{needing_connections.join(', ')}]"
+          configuration.establish_connections_to(needing_connections)
+        end
+        servers
+      end
+      # Execute the given command. If the command is prefixed by an exclamation
+      # mark, it is assumed to refer to another capistrano task, which will
+      # be invoked. Otherwise, it is executed as a command on all associated
+      # servers.
+      def exec(command)
+        @mutex.synchronize do
+          if command[0] == ?!
+            exec_tasks(command[1..-1].split)
+          else
+            servers = connect(configuration.current_task)
+            exec_command(command, servers)
+          end
+        end
+      ensure
+        STDOUT.flush
+      end
+      # Given an array of task names, invoke them in sequence.
+      def exec_tasks(list)
+        list.each do |task_name|
+          task = configuration.find_task(task_name)
+          raise Capistrano::NoSuchTaskError, "no such task `#{task_name}'" unless task
+          connect(task)
+          configuration.execute_task(task)
+        end
+      rescue Capistrano::NoMatchingServersError, Capistrano::NoSuchTaskError => error
+        warn "error: #{error.message}"
+      end
+      # Execute a command on the given list of servers.
+      def exec_command(command, servers)
+        command = command.gsub(/\bsudo\b/, "sudo -p '#{configuration.sudo_prompt}'")
+        processor = configuration.sudo_behavior_callback(Configuration.default_io_proc)
+        sessions = servers.map { |server| configuration.sessions[server] }
+        options = configuration.add_default_command_options({})
+        cmd = Command.new(command, sessions, options.merge(:logger => configuration.logger), &processor)
+        previous = trap("INT") { cmd.stop! }
+        cmd.process!
+      rescue Capistrano::Error => error
+        warn "error: #{error.message}"
+      ensure
+        trap("INT", previous)
+      end
+      # Return the object that will be used to query input from the console.
+      # The returned object will quack (more or less) like Readline.
+      def reader
+        @reader ||= begin
+          require 'readline'
+          Readline
+        rescue LoadError
+          ReadlineFallback
+        end
+      end
+      # Prepare every little thing for the shell. Starts the background
+      # thread and generally gets things ready for the REPL.
+      def setup
+        configuration.logger.level = Capistrano::Logger::INFO
+        @mutex = Mutex.new
+        @bgthread = Thread.new do
+          loop do
+            @mutex.synchronize { process_iteration(0.1) }
+          end
+        end
+      end
+      # Set the given option to +value+.
+      def set_option(opt, value)
+        case opt
+          when "v" then
+            puts "setting log verbosity to #{value.to_i}"
+            configuration.logger.level = value.to_i
+          when "o" then
+            case value
+            when "vi" then
+              puts "using vi edit mode"
+              reader.vi_editing_mode
+            when "emacs" then
+              puts "using emacs edit mode"
+              reader.emacs_editing_mode
+            else
+              puts "unknown -o option #{value.inspect}"
+            end
+          else
+            puts "unknown setting #{opt.inspect}"
+        end
+      end
+      # Process a command. Interprets the scope_type (must be nil, "with", or
+      # "on") and the command. If no command is given, then the scope is made
+      # effective for all subsequent commands. If the scope value is "all",
+      # then the scope is unrestricted.
+      def process_command(scope_type, scope_value, command)
+        env_var = case scope_type
+            when "with" then "ROLES"
+            when "on"   then "HOSTS"
+          end
+        old_var, ENV[env_var] = ENV[env_var], (scope_value == "all" ? nil : scope_value) if env_var
+        if command
+          begin
+            exec(command)
+          ensure
+            ENV[env_var] = old_var if env_var
+          end
+        else
+          puts "scoping #{scope_type} #{scope_value}"
+        end
+      end
+    end
+    # All open sessions, needed to satisfy the Command::Processable include
+    def sessions
+      configuration.sessions.values
+    end
+end