capistrano 2.15.11 → 3.0.0.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA256:
-  metadata.gz: 2bbbdc546cc7bf99f6279f5b9e646b278e6a8afd1019610162e4487734b47f9e
-  data.tar.gz: 57448a1d53a918a5180ebb6f7e30b5f33b9145b27cc088f250e8218fdba7f7a6
+SHA1:
+  metadata.gz: c688937076353e672e483049ea38a97d6000864f
+  data.tar.gz: eace1bc67b4b34e947afecd46370f25c1cfae865
 SHA512:
-  metadata.gz: 13aad84b057a8b6d856d00c8ee921a82abda3239840ff75535e58ee3e0349446860b0037c85d1622a98a2b8cd081995bcbfc1b374998b72d1d9e6900875b336a
-  data.tar.gz: 760398ba57d0b509d16fe0ec8163e0af6f443eb624ec63276fd6b870cc3a3a24866472fde768190fd54d67933850bd12dd4b690700fd82993815ff22d5984d5c
+  metadata.gz: d6b5223d084c7fae6f9b94d10adddccbdf6e84bbf3e147192242096526b8056062764b975e33e7d2907cd915ea47578a829a021eee2b19f1f8563578dd3bbb2a
+  data.tar.gz: 9e1e8f12c083f26d10cde152f0175c9606faca0eb885dd3f432ab07a56f8a2b7eea6e51637b9ae0b60e2abc983cfc0c9ae06e0f6abb62e47eeaa8ae8d677a1bd

data/.gitignore

@@ -1,10 +1,19 @@
-coverage
-doc
-pkg
-*.swp
-*.patch
 *.gem
-*.sh
-.DS_Store
-.bundle/*
+*.rbc
+.bundle
+.config
+.yardoc
 Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.rspec-local
+.ruby-version

data/Gemfile

@@ -1,15 +1,4 @@
-source "http://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in capistrano.gemspec
 gemspec
-
-#
-# Development Dependencies from the Gemfile
-# are merged here.
-#
-group :development do
-  gem "rake"
-  gem "rexml"
-  gem "pry"
-  gem "test-unit"
-end

data/LICENSE.txt

@@ -0,0 +1,18 @@
+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.md

@@ -1,94 +1,91 @@
-## Capistrano
+# Capistrano [![Build Status](https://travis-ci.org/capistrano/capistrano.png?branch=v3)](https://travis-ci.org/capistrano/capistrano)
 
-[![Build
-Status](https://secure.travis-ci.org/capistrano/capistrano.png)](http://travis-ci.org/capistrano/capistrano)[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/capistrano/capistrano)
+TODO
 
+## Installation
 
-Capistrano is a utility and framework for executing commands in parallel on
-multiple remote machines, via SSH. It uses a simple DSL (borrowed in part from
-[Rake](http://rake.rubyforge.org/)) that allows you to define _tasks_, which may
-be applied to machines in certain roles. It also supports tunneling connections
-via some gateway machine to allow operations to be performed behind VPN's and
-firewalls.
+Add this line to your application's Gemfile:
 
-Capistrano was originally designed to simplify and automate deployment of web
-applications to distributed environments, and originally came bundled with a set
-of tasks designed for deploying Rails applications.
+    gem 'capistrano', github: 'capistrano/capistrano', branch: :v3
 
-## Documentation
+And then execute:
 
-* [https://github.com/capistrano/capistrano/wiki](https://github.com/capistrano/capistrano/wiki)
+    $ bundle --binstubs
 
-## DEPENDENCIES
+Capify:
 
-* [Net::SSH](http://net-ssh.rubyforge.org)
-* [Net::SFTP](http://net-ssh.rubyforge.org)
-* [Net::SCP](http://net-ssh.rubyforge.org)
-* [Net::SSH::Gateway](http://net-ssh.rubyforge.org)
-* [HighLine](http://highline.rubyforge.org)
-* [Ruby](http://www.ruby-lang.org/en/) ≥ 1.8.7
+    $ cap install
 
-If you want to run the tests, you'll also need to install the dependencies with
-Bundler, see the `Gemfile` within .
+This creates the following files:
 
-## ASSUMPTIONS
+- `Capfile`
+- `lib/deploy/tasks`
+- `config/deploy/staging.rb`
+- `config/deploy/production.rb`
 
-Capistrano is "opinionated software", which means it has very firm ideas about
-how things ought to be done, and tries to force those ideas on you. Some of the
-assumptions behind these opinions are:
+To create different stages:
 
-* You are using SSH to access the remote servers.
-* You either have the same password to all target machines, or you have public
-  keys in place to allow passwordless access to them.
+    $ cap install STAGES=local,sandbox,qa,production
 
-Do not expect these assumptions to change.
+## Usage
 
-## USAGE
+    $ cap -vT
 
-In general, you'll use Capistrano as follows:
+    $ cap staging deploy
+    $ cap production deploy
 
-* Create a recipe file ("capfile" or "Capfile").
-* Use the `cap` script to execute your recipe.
+    $ cap production deploy --dry-run
+    $ cap production deploy --prereqs
+    $ cap production deploy --trace
 
-Use the `cap` script as follows:
+## Configuration
 
-    cap sometask
+    # config/deploy.rb
+    set :application, 'example app'
 
-By default, the script will look for a file called one of `capfile` or
-`Capfile`. The `sometask` text indicates which task to execute. You can do
-"cap -h" to see all the available options and "cap -T" to see all the available
-tasks.
+    # config/deploy/production.rb
+    set :stage, :production
 
-## CONTRIBUTING:
+    ask :branch, :master
 
-* Fork Capistrano
-* Create a topic branch - `git checkout -b my_branch`
-* Rebase your branch so that all your changes are reflected in one
-  commit
-* Push to your branch - `git push origin my_branch`
-* Create a Pull Request from your branch, include as much documentation
-  as you can in the commit message/pull request, following these
-[guidelines on writing a good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html)
-* That's it!
+    role :app, %w{example.com example2.com}
+    role :web, %w{example.com}
+    role :db, %w{example.com}
 
+    # the first server in the array is considered primary
 
-## LICENSE:
+## Tasks
+
+## Before / After
+
+Where calling on the same task name, executed in order of inclusion
+
+
+    # call an existing task
+    before :starting, :ensure_user
+
+    after :finishing, :notify
+
+
+    # or define in block
+    before :starting, :ensure_user do
+      #
+    end
+
+    after :finishing, :notify do
+      #
+    end
+
+## Console
+
+Execute arbitrary remote commands
+
+    $ cap staging console
+
+## Configuration
+
+
+## SSHKit
 
-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/Rakefile

@@ -1,11 +1,5 @@
-require 'bundler'
-Bundler::GemHelper.install_tasks
+require "bundler/gem_tasks"
 
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/*_test.rb'
-  test.verbose = true
-end
-
-task :default => :test
+task :default => :spec
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new

data/bin/cap

@@ -1,4 +1,3 @@
 #!/usr/bin/env ruby
-
-require 'capistrano/cli'
-Capistrano::CLI.execute
+require 'capistrano'
+Capistrano::Application.new.run

data/bin/capify

@@ -1,92 +1,8 @@
 #!/usr/bin/env ruby
-
-require 'optparse'
-require 'fileutils'
-
-OptionParser.new do |opts|
-  opts.banner = "Usage: #{File.basename($0)} [path]"
-
-  opts.on("-h", "--help", "Displays this help info") do
-    puts opts
-    exit 0
-  end
-
-  begin
-    opts.parse!(ARGV)
-  rescue OptionParser::ParseError => e
-    warn e.message
-    puts opts
-    exit 1
-  end
-end
-
-if ARGV.empty?
-  abort "Please specify the directory to capify, e.g. `#{File.basename($0)} .'"
-elsif !File.exist?(ARGV.first)
-  abort "`#{ARGV.first}' does not exist."
-elsif !File.directory?(ARGV.first)
-  abort "`#{ARGV.first}' is not a directory."
-elsif ARGV.length > 1
-  abort "Too many arguments; please specify only the directory to capify."
-end
-
-def unindent(string)
-  indentation = string[/\A\s*/]
-  string.strip.gsub(/^#{indentation}/, "")
-end
-
-files = {
-  "Capfile" => unindent(<<-FILE),
-
-    load 'deploy'
-
-    # Uncomment if you are using Rails' asset pipeline
-    # load 'deploy/assets'
-
-    load 'config/deploy' # remove this line to skip loading any of the default tasks
-  FILE
-
-  "config/deploy.rb" => 'set :application, "set your application name here"
-set :repository,  "set your repository location here"
-
-# set :scm, :git # You can set :scm explicitly or Capistrano will make an intelligent guess based on known version control directory names
-# Or: `accurev`, `bzr`, `cvs`, `darcs`, `git`, `mercurial`, `perforce`, `subversion` or `none`
-
-role :web, "your web-server here"                          # Your HTTP server, Apache/etc
-role :app, "your app-server here"                          # This may be the same as your `Web` server
-role :db,  "your primary db-server here", :primary => true # This is where Rails migrations will run
-role :db,  "your slave db-server here"
-
-# if you want to clean up old releases on each deploy uncomment this:
-# after "deploy:restart", "deploy:cleanup"
-
-# if you\'re still using the script/reaper helper you will need
-# these http://github.com/rails/irs_process_scripts
-
-# If you are using Passenger mod_rails uncomment this:
-# namespace :deploy do
-#   task :start do ; end
-#   task :stop do ; end
-#   task :restart, :roles => :app, :except => { :no_release => true } do
-#     run "#{try_sudo} touch #{File.join(current_path,\'tmp\',\'restart.txt\')}"
-#   end
-# end'}
-
-base = ARGV.shift
-files.each do |file, content|
-  file = File.join(base, file)
-  if File.exist?(file)
-    warn "[skip] '#{file}' already exists"
-  elsif File.exist?(file.downcase)
-    warn "[skip] '#{file.downcase}' exists, which could conflict with `#{file}'"
-  else
-    unless File.exist?(File.dirname(file))
-      puts "[add] making directory '#{File.dirname(file)}'"
-      FileUtils.mkdir(File.dirname(file))
-    end
-    puts "[add] writing '#{file}'"
-    File.open(file, "w") { |f| f.write(content) }
-  end
-end
-
-puts "[done] capified!"
+puts "-" * 80
+puts "Capistrano 3.x is incompatible with Capistrano 2.x. "
+puts
+puts "This command has become `cap install` in Capistrano 3.x"
+puts
+puts "For more information see http://www.capistranorb.com/"
+puts "-" * 80

data/capistrano.gemspec

@@ -1,40 +1,26 @@
 # -*- encoding: utf-8 -*-
-$:.push File.expand_path("../lib", __FILE__)
-require "capistrano/version"
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano/version'
 
-Gem::Specification.new do |s|
+Gem::Specification.new do |gem|
+  gem.name          = "capistrano"
+  gem.version       = Capistrano::VERSION
+  gem.authors       = ["Tom Clements"]
+  gem.email         = ["seenmyfate@gmail.com"]
+  gem.description   = %q{PENDING: Write a gem description}
+  gem.summary       = %q{PENDING: Write a gem summary}
+  gem.homepage      = ""
 
-  s.name        = "capistrano"
-  s.version     = Capistrano::Version.to_s
-  s.platform    = Gem::Platform::RUBY
-  s.authors     = ["Jamis Buck", "Lee Hambley"]
-  s.email       = ["jamis@jamisbuck.org", "lee.hambley@gmail.com"]
-  s.homepage    = "http://github.com/capistrano/capistrano"
-  s.summary     = %q{Capistrano - Welcome to easy deployment with Ruby over SSH}
-  s.description = %q{Capistrano is a utility and framework for executing commands in parallel on multiple remote machines, via SSH.}
-  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.extra_rdoc_files = [
-    "README.md"
-  ]
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = 'cap'
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
 
-  s.specification_version = 3 if s.respond_to? :specification_version
+  gem.add_dependency 'sshkit', '>= 0.0.23'
+  gem.add_dependency 'rake', '>= 10.0.0'
+  gem.add_dependency 'i18n'
 
-  if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-    s.add_runtime_dependency(%q<highline>, [">= 0"])
-    s.add_runtime_dependency(%q<net-ssh>, [">= 2.0.14"])
-    s.add_runtime_dependency(%q<net-sftp>, [">= 2.0.0"])
-    s.add_runtime_dependency(%q<net-scp>, [">= 1.0.0"])
-    s.add_runtime_dependency(%q<net-ssh-gateway>, [">= 1.1.0"])
-    s.add_development_dependency(%q<mocha>, ["0.9.12"])
-  else
-    s.add_dependency(%q<net-ssh>, [">= 2.0.14"])
-    s.add_dependency(%q<net-sftp>, [">= 2.0.0"])
-    s.add_dependency(%q<net-scp>, [">= 1.0.0"])
-    s.add_dependency(%q<net-ssh-gateway>, [">= 1.1.0"])
-    s.add_dependency(%q<highline>, [">= 0"])
-    s.add_dependency(%q<mocha>, ["0.9.12"])
-  end
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'mocha'
 end

data/lib/Capfile

@@ -0,0 +1,2 @@
+#!/usr/bin/env cap
+require 'capistrano/install'

data/lib/capistrano/application.rb

@@ -0,0 +1,28 @@
+module Capistrano
+  class Application < Rake::Application
+    include Rake::DSL
+
+    def initialize
+      super
+      @rakefiles = %w{capfile Capfile capfile.rb Capfile.rb} << capfile
+    end
+
+    def run
+      Rake.application = self
+      super
+    end
+
+    def load_rakefile
+      @name = 'cap'
+      super
+    end
+
+    private
+
+    # allows the `cap install` task to load without a capfile
+    def capfile
+      File.expand_path(File.join(File.dirname(__FILE__),'..','Capfile'))
+    end
+  end
+
+end

data/lib/capistrano/bundler.rb

@@ -0,0 +1 @@
+load File.expand_path("../tasks/bundler.rake", __FILE__)

data/lib/capistrano/configuration/question.rb

@@ -0,0 +1,42 @@
+module Capistrano
+  class Configuration
+    class Question
+
+      def initialize(env, key, default)
+        @env, @key, @default = env, key, default
+      end
+
+      def call
+        ask_question
+        save_response
+      end
+
+      private
+      attr_reader :env, :key, :default
+
+      def ask_question
+        $stdout.puts question
+      end
+
+      def save_response
+        env.set(key, value)
+      end
+
+      def value
+        if response.empty?
+          default
+        else
+          response
+        end
+      end
+
+      def response
+        @response ||= $stdin.gets.chomp
+      end
+
+      def question
+        I18n.t(:question, key: key, default_value: default, scope: :capistrano)
+      end
+    end
+  end
+end

data/lib/capistrano/configuration/server.rb

@@ -0,0 +1,24 @@
+require 'set'
+module Capistrano
+  class Configuration
+    class Server < SSHKit::Host
+
+      def add_role(role)
+        roles << role.to_sym
+      end
+
+      def has_role?(role)
+        roles.include? role.to_sym
+      end
+
+      def matches?(host)
+        hostname == Server.new(host).hostname
+      end
+
+      def roles
+        properties.roles ||= Set.new
+      end
+
+    end
+  end
+end