capistrano 3.0.0.pre → 3.0.0.pre2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c688937076353e672e483049ea38a97d6000864f
-  data.tar.gz: eace1bc67b4b34e947afecd46370f25c1cfae865
+  metadata.gz: 38d0a3ff8b874c2e4d430c269c18f76d93964753
+  data.tar.gz: 52b27720df0d2b9ae3908dcdaef8e1f5eca195af
 SHA512:
-  metadata.gz: d6b5223d084c7fae6f9b94d10adddccbdf6e84bbf3e147192242096526b8056062764b975e33e7d2907cd915ea47578a829a021eee2b19f1f8563578dd3bbb2a
-  data.tar.gz: 9e1e8f12c083f26d10cde152f0175c9606faca0eb885dd3f432ab07a56f8a2b7eea6e51637b9ae0b60e2abc983cfc0c9ae06e0f6abb62e47eeaa8ae8d677a1bd
+  metadata.gz: 0dd61efc447d0b8169d354a126bbfb81845d739426e8c3d60752f3038f4e2c2b0f4fc9b94b87a7df41511ea49859193e04a525ef7fcd2ceb5b8d2bf6c7318b96
+  data.tar.gz: cf0d253ec7463e3e6e3f106d2f7ceaf30996b61156a59e42852de237f2556b786cc00b1781f016d734b77a995a848677a85023f04b1e687ebd5b6e3fbf8adc55

data/README.md

@@ -1,91 +1,94 @@
 # Capistrano [![Build Status](https://travis-ci.org/capistrano/capistrano.png?branch=v3)](https://travis-ci.org/capistrano/capistrano)
 
-TODO
-
 ## Installation
 
 Add this line to your application's Gemfile:
 
-    gem 'capistrano', github: 'capistrano/capistrano', branch: :v3
+``` ruby
+gem 'capistrano', github: 'capistrano/capistrano', branch: :v3
+```
 
 And then execute:
 
-    $ bundle --binstubs
+``` ruby
+$ bundle --binstubs
+```
 
 Capify:
 
-    $ cap install
+``` shell
+$ cap install
+```
 
 This creates the following files:
 
-- `Capfile`
-- `lib/deploy/tasks`
-- `config/deploy/staging.rb`
-- `config/deploy/production.rb`
+```
+├── Capfile
+├── config
+│   ├── deploy
+│   │   ├── production.rb
+│   │   └── staging.rb
+│   └── deploy.rb
+└── lib
+    └── capistrano
+            └── tasks
+```
 
 To create different stages:
 
-    $ cap install STAGES=local,sandbox,qa,production
+``` shell
+$ cap install STAGES=local,sandbox,qa,production
+```
 
 ## Usage
 
-    $ cap -vT
-
-    $ cap staging deploy
-    $ cap production deploy
-
-    $ cap production deploy --dry-run
-    $ cap production deploy --prereqs
-    $ cap production deploy --trace
-
-## Configuration
-
-    # config/deploy.rb
-    set :application, 'example app'
+``` shell
+$ cap -vT
 
-    # config/deploy/production.rb
-    set :stage, :production
+$ cap staging deploy
+$ cap production deploy
 
-    ask :branch, :master
+$ cap production deploy --dry-run
+$ cap production deploy --prereqs
+$ cap production deploy --trace
+```
 
-    role :app, %w{example.com example2.com}
-    role :web, %w{example.com}
-    role :db, %w{example.com}
+## Tasks
 
-    # the first server in the array is considered primary
 
-## Tasks
 
 ## Before / After
 
 Where calling on the same task name, executed in order of inclusion
 
+``` ruby
+# call an existing task
+before :starting, :ensure_user
 
-    # call an existing task
-    before :starting, :ensure_user
-
-    after :finishing, :notify
+after :finishing, :notify
 
 
-    # or define in block
-    before :starting, :ensure_user do
-      #
-    end
+# or define in block
+before :starting, :ensure_user do
+  #
+end
 
-    after :finishing, :notify do
-      #
-    end
+after :finishing, :notify do
+  #
+end
+```
 
 ## Console
 
-Execute arbitrary remote commands
+Execute arbitrary remote commands, to use this simply add 
+`require 'capistrano/console'` which will add the necessary tasks to your 
+environment:
 
-    $ cap staging console
+``` shell
+$ cap staging console
+```
 
 ## Configuration
 
 
-## SSHKit
-
-
-
+## SSHKit

data/lib/capistrano/templates/Capfile

@@ -1,12 +1,7 @@
-#!/usr/bin/env cap
-# loads dsl, sets up stages
+# Load DSL and Setup Up Stages
 require 'capistrano/setup'
 
-# provides remote execution of arbitrary commands
-require 'capistrano/console'
-
-# includes default deployment tasks
-# remove to start completely from scratch
+# Includes default deployment tasks
 require 'capistrano/deploy'
 
 # Includes tasks from other gems included in your Gemfile
@@ -20,24 +15,29 @@ require 'capistrano/deploy'
 # require 'capistrano/bundler'
 # require 'capistrano/rails/assets'
 # require 'capistrano/rails/migrations'
-# require 'capistrano/heroku'
 
-# Loads custom tasks from lib/capistrano/tasks if you have any defined.
-# Dir.glob('lib/capistrano/tasks/*.rake').each { |r| import r }
+# Loads custom tasks from `lib/capistrano/tasks' if you have any defined.
+Dir.glob('lib/capistrano/tasks/*.cap').each { |r| import r }
 
 namespace :deploy do
+
   desc 'Restart application'
   task :restart do
     on roles(:app), in: :sequence, wait: 5 do
-      #
+      # Your restart mechanism here, for example:
+      # execute :touch, release_path.join('tmp/restart.txt')
     end
   end
 
   after :restart, :clear_cache do
     on roles(:web), in: :groups, limit: 3, wait: 10 do
-      #
+      # Here we can do anything such as:
+      # within latest_relese_path do
+      #   execute :rake, 'cache:clear'
+      # end
     end
   end
 
   after :finishing, 'deploy:cleanup'
+
 end

data/lib/capistrano/version.rb

@@ -1,3 +1,3 @@
 module Capistrano
-  VERSION = "3.0.0.pre"
+  VERSION = "3.0.0.pre2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: capistrano
 version: !ruby/object:Gem::Version
-  version: 3.0.0.pre
+  version: 3.0.0.pre2
 platform: ruby
 authors:
 - Tom Clements