cape 1.6.2 → 1.7.0

data/features/dsl/mirror_rake_tasks/with_cd.feature

@@ -0,0 +1,63 @@
+Feature: The #mirror_rake_tasks DSL method with a different directory
+
+  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 a Rake task with its implementation, using a Capistrano variable inside a lambda
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :release_path, '/release/path'
+
+      Cape do
+        mirror_rake_tasks do |recipes|
+          recipes.cd lambda { release_path }
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /release/path && /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 {}, but no servers matched
+      """
+
+  Scenario: mirror a Rake task with its implementation, using a Capistrano variable inside a block
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :release_path, '/release/path'
+
+      Cape do
+        mirror_rake_tasks do |recipes|
+          recipes.cd { release_path }
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /release/path && /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 {}, but no servers matched
+      """
+
+  Scenario: mirror a Rake task with its implementation, using a string
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      Cape do
+        mirror_rake_tasks do |recipes|
+          recipes.cd '/release/path'
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /release/path && /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 {}, but no servers matched
+      """

data/features/dsl/mirror_rake_tasks/with_cd_and_environment_variables.feature

@@ -0,0 +1,27 @@
+Feature: The #mirror_rake_tasks DSL method with a different directory and 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 a Rake task with its implementation
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :release_path, '/release/path'
+      set :rails_env,    'rails-env'
+
+      Cape do
+        mirror_rake_tasks do |recipes|
+          recipes.cd { release_path }
+          recipes.env['RAILS_ENV']  = lambda { rails_env }
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /release/path && /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=\"rails-env\""
+      `with_period' is only run for servers matching {}, but no servers matched
+      """

data/features/dsl/mirror_rake_tasks/{with_defined_namespace_argument.feature → with_defined_namespace.feature}

@@ -1,4 +1,4 @@
-Feature: The #mirror_rake_tasks DSL method with an argument of a defined namespace
+Feature: The #mirror_rake_tasks DSL method with a defined namespace
 
   In order to include Rake tasks with descriptions in my Capistrano recipes,
   As a developer using Cape,
@@ -25,14 +25,13 @@ 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"
+    And the output should not contain "period"
 
   Scenario: mirror a Rake task that shadows the matching namespace with its implementation
     Given a full-featured Rakefile
     And a Capfile with:
       """
-      set :current_path, '/path/to/current/deployed/application'
-      set :rails_env,    'production'
+      set :current_path, '/current/path'
 
       Cape do
         mirror_rake_tasks 'my_namespace'
@@ -42,7 +41,7 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined namespa
     Then the output should contain:
       """
         * 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"
+        * executing "cd /current/path && /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
       """
 
@@ -50,8 +49,7 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined namespa
     Given a full-featured Rakefile
     And a Capfile with:
       """
-      set :current_path, '/path/to/current/deployed/application'
-      set :rails_env,    'production'
+      set :current_path, '/current/path'
 
       Cape do
         mirror_rake_tasks :my_namespace
@@ -61,6 +59,6 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined namespa
     Then the output should contain:
       """
         * 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"
+        * executing "cd /current/path && /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_argument.feature → with_defined_task.feature}

@@ -1,4 +1,4 @@
-Feature: The #mirror_rake_tasks DSL method with an argument of a defined task
+Feature: The #mirror_rake_tasks DSL method with a defined task
 
   In order to include Rake tasks with descriptions in my Capistrano recipes,
   As a developer using Cape,
@@ -18,13 +18,13 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined task
       cap with_period # Ends with period.
       """
     And the output should not contain "without_period"
+    And the output should not contain "my_namespace"
 
   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'
+      set :current_path, '/current/path'
 
       Cape do
         mirror_rake_tasks 'with_period'
@@ -34,6 +34,6 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined task
     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"
+        * executing "cd /current/path && /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 {}, but no servers matched
       """

data/features/dsl/mirror_rake_tasks/{with_defined_task_argument_and_environment_variables.feature → with_defined_task_and_cd.feature}

@@ -1,4 +1,4 @@
-Feature: The #mirror_rake_tasks DSL method with an argument of a defined task, and with environment variables
+Feature: The #mirror_rake_tasks DSL method with a defined task and a different directory
 
   In order to include Rake tasks with descriptions in my Capistrano recipes,
   As a developer using Cape,
@@ -9,8 +9,8 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined task, a
     And a Capfile with:
       """
       Cape do
-        mirror_rake_tasks :with_period do |env|
-          env['RAILS_ENV'] = rails_env
+        mirror_rake_tasks :with_period do |recipes|
+          recipes.cd { release_path }
         end
       end
       """
@@ -20,17 +20,17 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined task, a
       cap with_period # Ends with period.
       """
     And the output should not contain "without_period"
+    And the output should not contain "my_namespace"
 
   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'
+      set :release_path, '/release/path'
 
       Cape do
-        mirror_rake_tasks 'with_period' do |env|
-          env['RAILS_ENV'] = rails_env
+        mirror_rake_tasks :with_period do |recipes|
+          recipes.cd { release_path }
         end
       end
       """
@@ -38,6 +38,6 @@ Feature: The #mirror_rake_tasks DSL method with an argument of a defined task, a
     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 RAILS_ENV=\"production\""
+        * executing "cd /release/path && /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 {}, but no servers matched
       """

data/features/dsl/mirror_rake_tasks/with_defined_task_and_cd_and_environment_variables.feature

@@ -0,0 +1,46 @@
+Feature: The #mirror_rake_tasks DSL method with a defined task, a different directory, and 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 do |recipes|
+          recipes.cd { release_path }
+          recipes.env['RAILS_ENV'] = lambda { rails_env }
+        end
+      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"
+    And the output should not contain "my_namespace"
+
+  Scenario: mirror the matching Rake task with its implementation
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :release_path, '/release/path'
+      set :rails_env,    'rails-env'
+
+      Cape do
+        mirror_rake_tasks :with_period do |recipes|
+          recipes.cd { release_path }
+          recipes.env['RAILS_ENV'] = lambda { rails_env }
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /release/path && /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=\"rails-env\""
+      `with_period' is only run for servers matching {}, but no servers matched
+      """

data/features/dsl/mirror_rake_tasks/with_defined_task_and_environment_variables.feature

@@ -0,0 +1,92 @@
+Feature: The #mirror_rake_tasks DSL method with a defined task and 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.
+
+  @deprecated
+  Scenario: mirror only the matching Rake task (deprecated)
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      Cape do
+        mirror_rake_tasks :with_period do |env|
+          env['RAILS_ENV'] = rails_env
+        end
+      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"
+    And the output should not contain "my_namespace"
+    And the output should contain:
+      """
+      *** DEPRECATED: Referencing Capistrano variables from Cape without wrapping them in a block, a lambda, or another callable object
+      """
+
+  Scenario: mirror only the matching Rake task
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      Cape do
+        mirror_rake_tasks :with_period do |recipes|
+          recipes.env['RAILS_ENV'] = lambda { rails_env }
+        end
+      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"
+    And the output should not contain "my_namespace"
+    And the output should not contain "DEPRECATED"
+
+  @deprecated
+  Scenario: mirror the matching Rake task with its implementation (deprecated)
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :current_path, '/current/path'
+      set :rails_env,    'rails-env'
+
+      Cape do
+        mirror_rake_tasks 'with_period' do |env|
+          env['RAILS_ENV'] = rails_env
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+      *** DEPRECATED: `mirror_rake_tasks("with_period") { |env| env["RAILS_ENV"] = "rails-env" }`. Use this instead: `mirror_rake_tasks("with_period") { |recipes| recipes.env["RAILS_ENV"] = "rails-env" }`
+        * executing `with_period'
+        * executing "cd /current/path && /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=\"rails-env\""
+      `with_period' is only run for servers matching {}, but no servers matched
+      """
+
+  Scenario: mirror the matching Rake task with its implementation
+    Given a full-featured Rakefile
+    And a Capfile with:
+      """
+      set :current_path, '/current/path'
+      set :rails_env,    'rails-env'
+
+      Cape do
+        mirror_rake_tasks 'with_period' do |recipes|
+          recipes.env['RAILS_ENV'] = lambda { rails_env }
+        end
+      end
+      """
+    When I run `cap with_period`
+    Then the output should contain:
+      """
+        * executing `with_period'
+        * executing "cd /current/path && /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=\"rails-env\""
+      `with_period' is only run for servers matching {}, but no servers matched
+      """
+    And the output should not contain "DEPRECATED"

data/features/dsl/mirror_rake_tasks/with_defined_task_and_rename.feature

@@ -0,0 +1,47 @@
+Feature: The #mirror_rake_tasks DSL method with a defined task and renaming logic
+
+  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 defining a Ruby-method-shadowing task
+    And a Capfile with:
+      """
+      Cape do
+        mirror_rake_tasks :load do |recipes|
+          recipes.rename do |task_name|
+            "do_#{task_name}"
+          end
+        end
+      end
+      """
+    When I run `cap -vT`
+    Then the output should contain:
+      """
+      cap do_load # A task that shadows a Ruby method.
+      """
+    And the output should not contain "period"
+    And the output should not contain "my_namespace"
+
+  Scenario: mirror the matching Rake task with its implementation
+    Given a full-featured Rakefile defining a Ruby-method-shadowing task
+    And a Capfile with:
+      """
+      set :current_path, '/current/path'
+
+      Cape do
+        mirror_rake_tasks :load do |recipes|
+          recipes.rename do |task_name|
+            "do_#{task_name}"
+          end
+        end
+      end
+      """
+    When I run `cap do_load`
+    Then the output should contain:
+      """
+        * executing `do_load'
+        * executing "cd /current/path && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake load"
+      `do_load' is only run for servers matching {}, but no servers matched
+      """

data/features/dsl/mirror_rake_tasks/with_defined_task_and_rename_and_cd.feature

@@ -0,0 +1,49 @@
+Feature: The #mirror_rake_tasks DSL method with a defined task, renaming logic, and a different directory
+
+  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 defining a Ruby-method-shadowing task
+    And a Capfile with:
+      """
+      Cape do
+        mirror_rake_tasks :load do |recipes|
+          recipes.rename do |task_name|
+            "do_#{task_name}"
+          end
+          recipes.cd { release_path }
+        end
+      end
+      """
+    When I run `cap -vT`
+    Then the output should contain:
+      """
+      cap do_load # A task that shadows a Ruby method.
+      """
+    And the output should not contain "period"
+    And the output should not contain "my_namespace"
+
+  Scenario: mirror the matching Rake task with its implementation
+    Given a full-featured Rakefile defining a Ruby-method-shadowing task
+    And a Capfile with:
+      """
+      set :release_path, '/release/path'
+
+      Cape do
+        mirror_rake_tasks :load do |recipes|
+          recipes.rename do |task_name|
+            "do_#{task_name}"
+          end
+          recipes.cd { release_path }
+        end
+      end
+      """
+    When I run `cap do_load`
+    Then the output should contain:
+      """
+        * executing `do_load'
+        * executing "cd /release/path && /usr/bin/env `/usr/bin/env bundle check >/dev/null 2>&1; case $? in 0|1 ) echo bundle exec ;; esac` rake load"
+      `do_load' is only run for servers matching {}, but no servers matched
+      """