cape 1.6.0 → 1.6.1

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -9,7 +9,7 @@ end
 
 group :doc do
   gem   'yard',         '~> 0', :platforms => [:ruby, :mswin, :mingw]
-  gem   'rdiscount',    '~> 1', :platforms => [:ruby, :mswin, :mingw]
+  gem   'rdiscount',            :platforms => [:ruby, :mswin, :mingw]
 end
 
 group :tooling do

data/Guardfile

@@ -1,4 +1,4 @@
-guard :rspec, :cli => '--color --debugger' do
+guard :rspec, :cli => '--debugger' do
   # Run the corresponding spec (or all specs) when code changes.
   watch( %r{^lib/(.+)\.rb$} ) do |match|
     corresponding_spec = "spec/#{match[1]}_spec.rb"
@@ -12,6 +12,9 @@ guard :rspec, :cli => '--color --debugger' do
   # Run a spec when it changes.
   watch %r{^spec/.+_spec\.rb$}
 
+  # Run all specs when the RSpec configuration changes.
+  watch( 'spec/spec_helper.rb' ) { 'spec' }
+
   # Run all specs when the bundle changes.
   watch( 'Gemfile.lock' ) { 'spec' }
 end

data/History.markdown

@@ -1,5 +1,9 @@
 # Version history for the _Cape_ project
 
+## <a name="v1.6.1"></a>v1.6.1, Mon 2/18/2013
+
+* Respect the specified order of environment variables in the remote command line
+
 ## <a name="v1.6.0"></a>v1.6.0, Wed 11/14/2012
 
 * Enable mirroring and enumeration of hidden Rake tasks for versions of Rake that make it possible

data/License.markdown

@@ -1,6 +1,6 @@
 # The MIT License
 
-Source code for _Cape_ is Copyright © 2011–2012 [Nils Jonsson](mailto:cape@nilsjonsson.com) and [contributors](http://github.com/njonsson/cape/contributors "Cape contributors at GitHub").
+Source code for _Cape_ is Copyright © 2011–2013 [Nils Jonsson](mailto:cape@nilsjonsson.com) and [contributors](http://github.com/njonsson/cape/contributors "Cape contributors at GitHub").
 
 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:
 

data/README.markdown

@@ -29,7 +29,12 @@
             <hNNBNBh=(.                                /   \   `
                ..
 
-# [<img align="right" src="https://codeclimate.com/badge.png" title="Code Climate" />](http://codeclimate.com/github/njonsson/cape) [<img align="right" src="https://gemnasium.com/njonsson/cape.png" title="Gemnasium build status" />](http://gemnasium.com/njonsson/cape) [<img align="right" src="https://secure.travis-ci.org/njonsson/cape.png?branch=master" title="Travis CI build status" />](http://travis-ci.org/njonsson/cape) Cape
+# [<img align="right" src="https://badge.fury.io/rb/cape.png" title="RubyGems release" height="13" />][rubygems-release] [<img align="right" src="https://codeclimate.com/github/njonsson/cape.png" title="Code Climate report" height="13" />][code-climate-report] [<img align="right" src="https://gemnasium.com/njonsson/cape.png" title="Gemnasium build status" height="13" />][gemnasium-build-status] [<img align="right" src="https://secure.travis-ci.org/njonsson/cape.png?branch=master" title="Travis CI build status" height="13" />][travis-ci-build-status] Cape
+
+[rubygems-release]:       http://rubygems.org/gems/cape
+[code-climate-report]:    http://codeclimate.com/github/njonsson/cape
+[gemnasium-build-status]: http://gemnasium.com/njonsson/cape
+[travis-ci-build-status]: http://travis-ci.org/njonsson/cape
 
 If
 
@@ -156,8 +161,8 @@ Cape lets you filter the Rake tasks to be mirrored. Note that Cape statements mu
     require 'cape'
 
     Cape do
-      # Create Capistrano recipes for the Rake task 'foo' and/or for the tasks in the
-      # 'foo' namespace.
+      # Create Capistrano recipes for the Rake task 'foo' and/or for the tasks in
+      # the 'foo' namespace.
       mirror_rake_tasks :foo
     end
 
@@ -273,7 +278,7 @@ Note that Cape statements must be contained in a `Cape` block.
 
 ## Known issues
 
-**A Rake task that lacks a description can be mirrored or enumerated only if Rake v0.9.3 or newer is installed.** Older versions of Rake did not support enumerating such tasks. You may want to make Rake v0.9.3 a dependency of your project:
+**A Rake task that lacks a description can be mirrored or enumerated only if Rake v0.9.3 or newer is installed.** Older versions of Rake did not support enumerating such tasks. You may want to make Rake v0.9.3 a dependency of your project.
 
     # Gemfile
 

data/Rakefile

@@ -21,7 +21,7 @@ end
 
 def define_spec_task(name, options={})
   RSpec::Core::RakeTask.new name do |t|
-    t.rspec_opts = ['--color']
+    t.rspec_opts ||= []
     unless options[:debug] == false
       begin
         require 'ruby-debug'
@@ -34,10 +34,10 @@ def define_spec_task(name, options={})
   end
 end
 
-desc 'Run all specs'
+desc 'Run specs'
 define_spec_task :spec
 
-desc 'Run all specs and test features'
+desc 'Run specs and test features'
 task ''       => [:spec, :features]
 task :default => [:spec, :features]
 

data/features/dsl/mirror_rake_tasks/inside_capistrano_namespace.feature

@@ -0,0 +1,40 @@
+Feature: The #mirror_rake_tasks DSL method, inside a Capistrano namespace
+
+  In order to include Rake tasks with descriptions in my Capistrano recipes,
+  As a developer using Cape,
+  I want to use the Cape DSL.
+
+  Scenario: mirror all Rake tasks
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      namespace :ns do
+        Cape do |cape|
+          cape.mirror_rake_tasks
+        end
+      end
+      """
+    When I run `cap -vT`
+    Then the output should contain:
+      """
+      cap ns:with_period                                            # Ends with period.
+      """
+
+  Scenario: mirror a Rake task with its implementation
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :current_path, '/path/to/current/deployed/application'
+
+      namespace :ns do
+        Cape do |cape|
+          cape.mirror_rake_tasks
+        end
+      end
+      """
+    When I run `cap ns:with_period`
+    Then the output should contain:
+      """
+        * executing `ns:with_period'
+        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_period"
+      """

data/features/dsl/mirror_rake_tasks/with_defined_namespace_argument.feature

@@ -9,11 +9,14 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined namespa
     And a Capfile with:
       """
       Cape do
-        mirror_rake_tasks 'my_namespace'
+        mirror_rake_tasks :my_namespace
       end
       """
     When I run `cap -vT`
-    Then the output should not contain "cap with_period"
+    Then the output should contain:
+      """
+      cap my_namespace                                           # A task that shadows a names...
+      """
     And the output should contain:
       """
       cap my_namespace:in_a_namespace                            # My task in a namespace.
@@ -22,75 +25,42 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined namespa
       """
       cap my_namespace:my_nested_namespace:in_a_nested_namespace # My task in a nested namespace.
       """
+    And the output should not contain "cap with_period"
 
-  Scenario: do not mirror Rake task 'with_period'
+  Scenario: mirror a Rake task that shadows the matching namespace with its implementation
     Given a full-featured Rakefile
     And a Capfile with:
       """
-      Cape do
-        mirror_rake_tasks :my_namespace
-      end
-      """
-    When I run `cap -e with_period`
-    Then the output should contain exactly:
-      """
-      The task `with_period' does not exist.
-
-      """
+      set :current_path, '/path/to/current/deployed/application'
+      set :rails_env,    'production'
 
-  Scenario: mirror Rake task 'my_namespace' with its description
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
       Cape do
-        mirror_rake_tasks :my_namespace
+        mirror_rake_tasks 'my_namespace'
       end
       """
-    When I run `cap -e my_namespace`
-    Then the output should contain exactly:
+      When I run `cap my_namespace`
+    Then the output should contain:
       """
-      ------------------------------------------------------------
-      cap my_namespace
-      ------------------------------------------------------------
-      A task that shadows a namespace.
-
-
+        * executing `my_namespace'
+        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake my_namespace"
+      `my_namespace' is only run for servers matching {}, but no servers matched
       """
 
-  Scenario: mirror Rake task 'my_namespace:in_a_namespace' with its description
+  Scenario: mirror a Rake task in the matching namespace with its implementation
     Given a full-featured Rakefile
     And a Capfile with:
       """
-      Cape do
-        mirror_rake_tasks :my_namespace
-      end
-      """
-    When I run `cap -e my_namespace:in_a_namespace`
-    Then the output should contain exactly:
-      """
-      ------------------------------------------------------------
-      cap my_namespace:in_a_namespace
-      ------------------------------------------------------------
-      My task in a namespace.
-
+      set :current_path, '/path/to/current/deployed/application'
+      set :rails_env,    'production'
 
-      """
-
-  Scenario: mirror Rake task 'my_namespace:my_nested_namespace:in_a_nested_namespace' with its description
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
       Cape do
         mirror_rake_tasks :my_namespace
       end
       """
-    When I run `cap -e my_namespace:my_nested_namespace:in_a_nested_namespace`
-    Then the output should contain exactly:
+      When I run `cap my_namespace:my_nested_namespace:in_a_nested_namespace`
+    Then the output should contain:
       """
-      ------------------------------------------------------------
-      cap my_namespace:my_nested_namespace:in_a_nested_namespace
-      ------------------------------------------------------------
-      My task in a nested namespace.
-
-
+        * executing `my_namespace:my_nested_namespace:in_a_nested_namespace'
+        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake my_namespace:my_nested_namespace:in_a_nested_namespace"
+      `my_namespace:my_nested_namespace:in_a_nested_namespace' is only run for servers matching {}, but no servers matched
       """

data/features/dsl/mirror_rake_tasks/with_defined_task_and_valid_options.feature

@@ -0,0 +1,39 @@
+Feature: The #mirror_rake_tasks DSL method with arguments of a defined task and valid options, and with environment variables
+
+  In order to include Rake tasks with descriptions in my Capistrano recipes,
+  As a developer using Cape,
+  I want to use the Cape DSL.
+
+  Scenario: mirror only the matching Rake task
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      Cape do
+        mirror_rake_tasks :with_period, :roles => :app
+      end
+      """
+    When I run `cap -vT`
+    Then the output should contain:
+      """
+      cap with_period # Ends with period.
+      """
+    And the output should not contain "without_period"
+
+  Scenario: mirror the matching Rake task with its implementation
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :current_path, '/path/to/current/deployed/application'
+      set :rails_env,    'production'
+
+      Cape do
+        mirror_rake_tasks 'with_period', :roles => :app
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_period"
+      `with_period' is only run for servers matching {:roles=>:app}, but no servers matched
+      """

data/features/dsl/mirror_rake_tasks/with_defined_task_and_valid_options_arguments_and_environment_variables.feature

@@ -4,12 +4,12 @@ Feature: The #mirror_rake_tasks DSL method with arguments of a defined task and
   As a developer using Cape,
   I want to use the Cape DSL.
 
-  Scenario: mirror all Rake tasks with the specified options
+  Scenario: mirror only the matching Rake task
     Given a full-featured Rakefile
     And a Capfile with:
       """
       Cape do
-        mirror_rake_tasks :roles => :app do |env|
+        mirror_rake_tasks :with_period, :roles => :app do |env|
           env['RAILS_ENV'] = rails_env
         end
       end
@@ -17,63 +17,11 @@ Feature: The #mirror_rake_tasks DSL method with arguments of a defined task and
     When I run `cap -vT`
     Then the output should contain:
       """
-      cap with_period                                            # Ends with period.
-      """
-    And the output should contain:
-      """
-      cap without_period                                         # Ends without period.
-      """
-    And the output should contain:
-      """
-      cap long                                                   # My long task -- it has a ve...
-      """
-    And the output should contain:
-      """
-      cap with_one_arg                                           # My task with one argument.
-      """
-    And the output should contain:
-      """
-      cap my_namespace                                           # A task that shadows a names...
-      """
-    And the output should contain:
-      """
-      cap my_namespace:in_a_namespace                            # My task in a namespace.
-      """
-    And the output should contain:
-      """
-      cap my_namespace:my_nested_namespace:in_a_nested_namespace # My task in a nested namespace.
-      """
-    And the output should contain:
-      """
-      cap with_two_args                                          # My task with two arguments.
-      """
-    And the output should contain:
-      """
-      cap with_three_args                                        # My task with three arguments.
+      cap with_period # Ends with period.
       """
+    And the output should not contain "without_period"
 
-  Scenario: mirror Rake task 'with_period' with its description
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env['RAILS_ENV'] = rails_env
-        end
-      end
-      """
-    When I run `cap -e with_period`
-    Then the output should contain exactly:
-      """
-      ------------------------------------------------------------
-      cap with_period
-      ------------------------------------------------------------
-      Ends with period.
-
-
-      """
-
-  Scenario: mirror Rake task 'with_period' with its implementation
+  Scenario: mirror the matching Rake task with its implementation
     Given a full-featured Rakefile
     And a Capfile with:
       """
@@ -81,7 +29,7 @@ Feature: The #mirror_rake_tasks DSL method with arguments of a defined task and
       set :rails_env,    'production'
 
       Cape do
-        mirror_rake_tasks :roles => :app do |env|
+        mirror_rake_tasks 'with_period', :roles => :app do |env|
           env['RAILS_ENV'] = rails_env
         end
       end
@@ -93,131 +41,3 @@ Feature: The #mirror_rake_tasks DSL method with arguments of a defined task and
         * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_period RAILS_ENV=\"production\""
       `with_period' is only run for servers matching {:roles=>:app}, but no servers matched
       """
-
-  Scenario: mirror Rake task 'with_period' with its implementation, ignoring nil environment variable names
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      set :current_path, '/path/to/current/deployed/application'
-      set :rails_env,    'production'
-
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env[nil] = 'foo'
-        end
-      end
-      """
-    When I run `cap with_period`
-    Then the output should contain:
-      """
-        * executing `with_period'
-        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_period"
-      `with_period' is only run for servers matching {:roles=>:app}, but no servers matched
-      """
-
-  Scenario: mirror Rake task 'with_period' with its implementation, ignoring nil environment variable values
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      set :current_path, '/path/to/current/deployed/application'
-      set :rails_env,    'production'
-
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env['FOO'] = nil
-        end
-      end
-      """
-    When I run `cap with_period`
-    Then the output should contain:
-      """
-        * executing `with_period'
-        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_period"
-      `with_period' is only run for servers matching {:roles=>:app}, but no servers matched
-      """
-
-  Scenario: mirror Rake task 'with_one_arg' with its description
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env['RAILS_ENV'] = rails_env
-        end
-      end
-      """
-    When I run `cap -e with_one_arg`
-    Then the output should contain exactly:
-      """
-      ------------------------------------------------------------
-      cap with_one_arg
-      ------------------------------------------------------------
-      My task with one argument.
-
-      Set environment variable THE_ARG if you want to pass a Rake task argument.
-
-
-      """
-
-  Scenario: mirror Rake task 'my_namespace:in_a_namespace' with its description
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env['RAILS_ENV'] = rails_env
-        end
-      end
-      """
-    When I run `cap -e my_namespace:in_a_namespace`
-    Then the output should contain exactly:
-      """
-      ------------------------------------------------------------
-      cap my_namespace:in_a_namespace
-      ------------------------------------------------------------
-      My task in a namespace.
-
-
-      """
-
-  Scenario: mirror Rake task 'with_three_args' with its implementation
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      set :current_path, '/path/to/current/deployed/application'
-      set :rails_env,    'production'
-
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env['RAILS_ENV'] = rails_env
-        end
-      end
-      """
-    When I run `cap with_three_args AN_ARG1="a value for an_arg1" AN_ARG2="a value for an_arg2" AN_ARG3="a value for an_arg3"`
-    Then the output should contain:
-      """
-        * executing `with_three_args'
-        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_three_args[\"a value for an_arg1\",\"a value for an_arg2\",\"a value for an_arg3\"] RAILS_ENV=\"production\""
-      `with_three_args' is only run for servers matching {:roles=>:app}, but no servers matched
-      """
-
-  Scenario: mirror Rake task 'with_three_args' with its implementation not enforcing arguments
-    Given a full-featured Rakefile
-    And a Capfile with:
-      """
-      set :current_path, '/path/to/current/deployed/application'
-      set :rails_env,    'production'
-
-      Cape do
-        mirror_rake_tasks :roles => :app do |env|
-          env['RAILS_ENV'] = rails_env
-        end
-      end
-      """
-    When I run `cap with_three_args AN_ARG2="a value for an_arg2"`
-    Then the output should contain:
-      """
-        * executing `with_three_args'
-        * executing "cd /path/to/current/deployed/application && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake with_three_args[,\"a value for an_arg2\",] RAILS_ENV=\"production\""
-      `with_three_args' is only run for servers matching {:roles=>:app}, but no servers matched
-      """