cucumber 0.3.9 → 0.3.10

data/History.txt

@@ -1,3 +1,43 @@
+== 0.3.10 2009-06-05
+
+The Spork Release!
+
+This release has an exciting new feature - a new --drb switch! This magic switch lets you run your
+features much faster than before, because you can eliminate the startup time for your code. This is
+thanks to a brand new gem called Spork by Tim Harper and Ben Mabey. (You can find out more about Spork 
+here: http://github.com/timcharper/spork/tree/master). You can start Spork and have it preload your 
+application in a separate process. Spork listens for DRb connections, and when you run cucumber with 
+--drb the features will run inside the Spork server instead. Spork provides two simple hooks for preloading 
+your application - one for framework/stable code (Spork.prefork) and one for the code that *you* write and 
+change often (Spork.each_run). Keep in mind that all World, Before, and other Cucumber hooks need to be
+in the Spork.each_run block.  Using Spork works great for Ruby on Rails, which can take a while to load, 
+but --drb and Spork aren't tied to Rails at all. The new --drb switch also works great alongside autotest 
+(just add --drb to your autotest profile in cucumber.yml), so now you can get even faster feedback.
+
+Cucumber's built-in cucumber generator now has a new --spork switch, so when you bootstrap your Rails
+application for cucumber, you can have spork configuration set up out of the box. (It's just a
+slightly different env.rb.)
+
+Although Spork was in mind when the --drb switch was added it is important to realize that all that was added
+to Cucumber was a DRb client.  Any DRb server that adheres to this protocol can be used with Cucumber's --drb
+switch. While Spork is geared towards removing the load time to give you a faster feedback loop you could 
+just as easily use this client with a server that distributes your features to run in parallel. Someone just
+needs to write such a server. ;)
+
+This release also has some minor bugfixes related to RSpec and Rails interop.
+
+=== Bugfixes
+* RSpec's be_* matchers did not work in 0.3.9 and probably earlier versions. Now they do. (Aslak Hellesøy)
+* The Rails cucumber environment won't declare gem dependencies if the plugin exists. (Aslak Hellesøy)
+* The Rails cucumber generator will no longer declare gem dependencies on rspec if you use --testunit. (Aslak Hellesøy)
+
+=== New features
+* Spork support via --drb. (Ben Mabey)
+* Added a Ast::Feature#name method for convenience. (Aslak Hellesøy)
+
+=== Changed features
+* The HTML formatter wraps examples in a div, and distinguishes between Scenario and Scenario Outline. (Aslak Hellesøy)
+
 == 0.3.9 2009-05-27
 
 Bugfix release for 0.3.8 released earlier today. 0.3.8 had a bug in the Rails cucumber

data/Manifest.txt

@@ -115,6 +115,12 @@ examples/i18n/no/features/step_definitons/kalkulator_steps.rb
 examples/i18n/no/features/summering.feature
 examples/i18n/no/features/support/env.rb
 examples/i18n/no/lib/kalkulator.rb
+examples/i18n/pl/Rakefile
+examples/i18n/pl/features/addition.feature
+examples/i18n/pl/features/division.feature
+examples/i18n/pl/features/step_definitons/calculator_steps.rb
+examples/i18n/pl/features/support/env.rb
+examples/i18n/pl/lib/calculator.rb
 examples/i18n/pt/Rakefile
 examples/i18n/pt/features/adicao.feature
 examples/i18n/pt/features/step_definitions/calculadora_steps.rb
@@ -244,6 +250,7 @@ features/cucumber_cli.feature
 features/cucumber_cli_diff_disabled.feature
 features/cucumber_cli_outlines.feature
 features/custom_formatter.feature
+features/drb_server_integration.feature
 features/exclude_files.feature
 features/expand.feature
 features/html_formatter.feature
@@ -292,6 +299,7 @@ lib/cucumber/ast/tags.rb
 lib/cucumber/ast/visitor.rb
 lib/cucumber/broadcaster.rb
 lib/cucumber/cli/configuration.rb
+lib/cucumber/cli/drb_client.rb
 lib/cucumber/cli/language_help_formatter.rb
 lib/cucumber/cli/main.rb
 lib/cucumber/core_ext/exception.rb
@@ -339,6 +347,7 @@ rails_generators/cucumber/templates/cucumber.rake
 rails_generators/cucumber/templates/cucumber_environment.rb
 rails_generators/cucumber/templates/env.rb
 rails_generators/cucumber/templates/paths.rb
+rails_generators/cucumber/templates/spork_env.rb
 rails_generators/cucumber/templates/webrat_steps.rb
 rails_generators/feature/USAGE
 rails_generators/feature/feature_generator.rb
@@ -357,6 +366,7 @@ spec/cucumber/ast/table_spec.rb
 spec/cucumber/ast/visitor_spec.rb
 spec/cucumber/broadcaster_spec.rb
 spec/cucumber/cli/configuration_spec.rb
+spec/cucumber/cli/drb_client_spec.rb
 spec/cucumber/cli/main_spec.rb
 spec/cucumber/core_ext/proc_spec.rb
 spec/cucumber/core_ext/string_spec.rb

data/cucumber.yml

@@ -1 +1 @@
-default: --format progress features --tags ~@pending
+default: --format progress features --tags ~@proposed,~@in_progress

data/examples/i18n/pl/Rakefile

@@ -0,0 +1,6 @@
+$:.unshift(File.dirname(__FILE__) + '/../../../lib')
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new do |t|
+  t.cucumber_opts = %w{--language pl}
+end

data/examples/i18n/pl/features/addition.feature

@@ -0,0 +1,16 @@
+Właściwość: Dodawanie
+  W celu uniknięcia głupich błędów
+  Jako matematyczny idiota
+  Chcę sprawdzić wartość sumy dwóch liczb
+
+  Szablon scenariusza: Dodaj dwie liczby
+    Zakładając wprowadzenie do kalkulatora liczby <liczba_1>
+    Oraz wprowadzenie do kalkulatora liczby <liczba_2>
+    Jeżeli nacisnę <przycisk>
+    Wtedy rezultat <wynik> wyświetli się na ekranie
+
+  Przykłady:
+    | liczba_1 | liczba_2 | przycisk | wynik  |
+    | 20       | 30       | dodaj    | 50     |
+    | 2        | 5        | dodaj    | 7      |
+    | 0        | 40       | dodaj    | 40     |

data/examples/i18n/pl/features/division.feature

@@ -0,0 +1,9 @@
+Właściwość: Dzielenie
+  W celu uniknięcia głupich błędów
+  Kasjer musi znać się na ułamkach
+
+  Scenariusz: Zwykłe liczby
+    Zakładając wprowadzenie do kalkulatora liczby 3
+    Oraz wprowadzenie do kalkulatora liczby 2
+    Jeżeli nacisnę podziel
+    Wtedy rezultat 1.5 wyświetli się na ekranie

data/examples/i18n/pl/features/step_definitons/calculator_steps.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+require 'spec/expectations'
+$:.unshift(File.dirname(__FILE__) + '/../../lib') # This line is not needed in your own project
+require 'cucumber/formatter/unicode'
+require 'calculator'
+
+Before do
+  @calc = Calculator.new
+end
+
+After do
+end
+
+Zakładając /wprowadzenie do kalkulatora liczby (\d+)/ do |n|
+  @calc.push n.to_i
+end
+
+Jeżeli /nacisnę (\w+)/ do |op|
+  @result = @calc.send op
+end
+
+Wtedy /rezultat (.*) wyświetli się na ekranie/ do |result|
+  @result.should == result.to_f
+end

data/examples/i18n/pl/features/support/env.rb

@@ -0,0 +1,6 @@
+# encoding: utf-8
+require 'spec/expectations'
+$:.unshift(File.dirname(__FILE__) + '/../../lib')
+require 'cucumber/formatter/unicode'
+require 'calculator'
+$KCODE='u' unless Cucumber::RUBY_1_9

data/examples/i18n/pl/lib/calculator.rb

@@ -0,0 +1,14 @@
+class Calculator
+  def push(n)
+    @args ||= []
+    @args << n
+  end
+  
+  def dodaj
+    @args.inject(0){|n,sum| sum+=n}
+  end
+
+  def podziel
+    @args[0].to_f / @args[1].to_f
+  end
+end

data/examples/self_test/features/sample.feature

@@ -1,3 +1,4 @@
+# Feature comment
 @one
 Feature: Sample
 
@@ -5,6 +6,7 @@ Feature: Sample
   Scenario: Missing
     Given missing
 
+# Scenario comment
 @three
   Scenario: Passing
     Given passing

data/features/cucumber_cli.feature

@@ -6,6 +6,7 @@ Feature: Cucumber command line
     When I run cucumber -q features/sample.feature:5
     Then it should pass with      
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -22,6 +23,7 @@ Feature: Cucumber command line
     When I run cucumber -q features/sample.feature:5 --strict
     Then it should fail with
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -29,7 +31,7 @@ Feature: Cucumber command line
         Scenario: Missing
           Given missing
             Undefined step: "missing" (Cucumber::Undefined)
-            features/sample.feature:6:in `Given missing'
+            features/sample.feature:7:in `Given missing'
 
       1 scenario (1 undefined)
       1 step (1 undefined)
@@ -37,12 +39,14 @@ Feature: Cucumber command line
       """
 
   Scenario: Succeed with --strict
-    When I run cucumber -q features/sample.feature:9 --strict
+    When I run cucumber -q features/sample.feature:10 --strict
     Then it should pass with
     """
+    # Feature comment
     @one
     Feature: Sample
 
+      # Scenario comment
       @three
       Scenario: Passing
         Given passing
@@ -56,9 +60,10 @@ Feature: Cucumber command line
 
   @mri186
   Scenario: Specify 2 line numbers where one is a tag
-    When I run cucumber -q features/sample.feature:5:14
+    When I run cucumber -q features/sample.feature:5:16
     Then it should fail with
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -75,7 +80,7 @@ Feature: Cucumber command line
             FAIL (RuntimeError)
             ./features/step_definitions/sample_steps.rb:2:in `flunker'
             ./features/step_definitions/sample_steps.rb:9:in `/^failing$/'
-            features/sample.feature:16:in `Given failing'
+            features/sample.feature:18:in `Given failing'
 
       2 scenarios (1 failed, 1 undefined)
       2 steps (1 failed, 1 undefined)
@@ -86,6 +91,7 @@ Feature: Cucumber command line
     When I run cucumber -q -r ../../features/step_definitions/extra_steps.rb features/sample.feature:5
     Then it should pass with
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -102,9 +108,11 @@ Feature: Cucumber command line
     When I run cucumber -q features/sample.feature:12
     Then it should pass with
       """
+      # Feature comment
       @one
       Feature: Sample
 
+        # Scenario comment
         @three
         Scenario: Passing
           Given passing
@@ -128,7 +136,7 @@ Feature: Cucumber command line
       FAIL (RuntimeError)
       ./features/step_definitions/sample_steps.rb:2:in `flunker'
       ./features/step_definitions/sample_steps.rb:9:in `/^failing$/'
-      features/sample.feature:16:in `Given failing'
+      features/sample.feature:18:in `Given failing'
 
       3 scenarios (1 failed, 1 undefined, 1 passed)
       3 steps (1 failed, 1 undefined, 1 passed)
@@ -238,6 +246,7 @@ Feature: Cucumber command line
             | state   | other_state |
             | passing | passing     |
 
+      # Feature comment
       @one
       Feature: Sample
 
@@ -245,6 +254,7 @@ Feature: Cucumber command line
         Scenario: Missing
           Given missing
 
+        # Scenario comment
         @three
         Scenario: Passing
           Given passing
@@ -388,6 +398,7 @@ Feature: Cucumber command line
     When I run cucumber -q features --tags three
     Then it should pass with
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -395,6 +406,7 @@ Feature: Cucumber command line
         Scenario: Missing
           Given missing
 
+        # Scenario comment
         @three
         Scenario: Passing
           Given passing
@@ -411,6 +423,7 @@ Feature: Cucumber command line
     When I run cucumber -q features --tags one
     Then it should fail with
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -418,6 +431,7 @@ Feature: Cucumber command line
         Scenario: Missing
           Given missing
 
+        # Scenario comment
         @three
         Scenario: Passing
           Given passing
@@ -433,7 +447,7 @@ Feature: Cucumber command line
             FAIL (RuntimeError)
             ./features/step_definitions/sample_steps.rb:2:in `flunker'
             ./features/step_definitions/sample_steps.rb:9:in `/^failing$/'
-            features/sample.feature:16:in `Given failing'
+            features/sample.feature:18:in `Given failing'
 
       3 scenarios (1 failed, 1 undefined, 1 passed)
       3 steps (1 failed, 1 undefined, 1 passed)
@@ -444,6 +458,7 @@ Feature: Cucumber command line
     When I run cucumber -q features/sample.feature --dry-run -t ~four
     Then it should pass with
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -451,6 +466,7 @@ Feature: Cucumber command line
         Scenario: Missing
           Given missing
 
+        # Scenario comment
         @three
         Scenario: Passing
           Given passing
@@ -466,6 +482,7 @@ Feature: Cucumber command line
     When I run cucumber --autoformat tmp/formatted features
     Then "examples/self_test/tmp/formatted/features/sample.feature" should contain
       """
+      # Feature comment
       @one
       Feature: Sample
 
@@ -473,6 +490,7 @@ Feature: Cucumber command line
         Scenario: Missing
           Given missing
 
+        # Scenario comment
         @three
         Scenario: Passing
           Given passing

data/features/drb_server_integration.feature

@@ -0,0 +1,92 @@
+@in_progress
+Feature: DRb Server Integration
+  To prevent waiting for Rails and other large Ruby applications to load their environments
+  for each feature run Cucumber ships with a DRb client that can speak to a server which
+  loads up the environment only once.
+
+  Background: App with Spork support
+              Spork is a gem that has a DRb server and the scenarios below use illustarate how to use it.
+              However, any DRb server that adheres to the protocol that the client expects would work.
+
+    Given a standard Cucumber project directory structure
+    And a file named "features/support/env.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+
+      Spork.prefork do
+        puts "I'm loading all the heavy stuff..."
+      end
+
+      Spork.each_run do
+        puts "I'm loading the stuff just for this run..."
+      end
+      """
+    And a file named "features/sample.feature" with:
+      """
+      Feature: Sample
+        Scenario: this is a test
+          Given I am just testing stuff
+      """
+    And a file named "features/step_definitions/all_your_steps_are_belong_to_us.rb" with:
+    """
+    Given /^I am just testing stuff$/ do
+      # no-op
+    end
+    """
+
+  Scenario: Feature Run with --drb flag
+    Given I am running "spork cuc" in the background
+
+    When I run cucumber features/sample.feature --drb
+    Then it should pass
+    And the output should contain
+      """
+      1 step (1 passed)
+      """
+    And the output should contain
+      """
+      I'm loading the stuff just for this run...
+      """
+    And the output should not contain
+      """
+      I'm loading all the heavy stuff...
+      """
+
+
+  Scenario: Feature Run with --drb flag with no DRb server running
+            Cucumber will fall back on running the features locally in this case.
+
+    Given I am not running a DRb server in the background
+
+    When I run cucumber features/sample.feature --drb
+    Then it should pass
+    And STDERR should match
+      """
+      No DRb server is running. Running features locally:
+      """
+    And the output should contain
+      """
+      I'm loading all the heavy stuff...
+      I'm loading the stuff just for this run...
+      """
+
+  Scenario: Feature Run with --drb flag *defined in a profile* with no DRb server running
+
+    Given I am not running a DRb server in the background
+    And the following profile is defined:
+      """
+      server: --drb features
+      """
+
+    When I run cucumber --profile server
+    Then it should pass
+    And STDERR should match
+      """
+      No DRb server is running. Running features locally:
+      """
+    And the output should contain
+      """
+      I'm loading all the heavy stuff...
+      I'm loading the stuff just for this run...
+      """