aslakhellesoy-cucumber 0.1.99.11 → 0.1.99.12

data/History.txt

@@ -69,6 +69,8 @@ pure Ruby users have been enjoying for a while.
 * Pending steps in > steps called from steps (#65 Aslak Hellesøy)
 
 === New features
+* Adding support for Background (#153 Joseph Wilk) 
+* Added Česky/Czech (Vojtech Salbaba)
 * New --no-multiline option to reduce noise. Useful if lots of features are failing.
 * Added ability to pass URIs to cucumber in addition to files and directories. Useful for troubleshooting! (Aslak Hellesøy)
 * Groups of tabular scenarios (#57 Aslak Hellesøy)

data/Manifest.txt

@@ -117,11 +117,19 @@ examples/selenium/Rakefile
 examples/selenium/features/search.feature
 examples/selenium/features/step_definitons/stories_steps.rb
 examples/self_test/README.textile
+examples/self_test/features/background/failing_background.feature
+examples/self_test/features/background/failing_background_after_success.feature
+examples/self_test/features/background/multiline_args_background.feature
+examples/self_test/features/background/passing_background.feature
+examples/self_test/features/background/pending_background.feature
+examples/self_test/features/background/scenario_outline_failing_background.feature
+examples/self_test/features/background/scenario_outline_passing_background.feature
 examples/self_test/features/call_undefined_step_from_step_def.feature
 examples/self_test/features/lots_of_undefined.feature
 examples/self_test/features/outline_sample.feature
 examples/self_test/features/sample.feature
 examples/self_test/features/step_definitions/sample_steps.rb
+examples/self_test/features/support/env.rb
 examples/test_unit/Rakefile
 examples/test_unit/features/step_definitions/test_unit_steps.rb
 examples/test_unit/features/test_unit.feature
@@ -139,6 +147,7 @@ examples/watir/Rakefile
 examples/watir/features/search.feature
 examples/watir/features/step_definitons/search_steps.rb
 examples/watir/features/support/env.rb
+features/background.feature
 features/cucumber_cli.feature
 features/cucumber_cli_outlines.feature
 features/report_called_undefined_steps.feature
@@ -161,6 +170,7 @@ lib/autotest/cucumber_rspec.rb
 lib/autotest/discover.rb
 lib/cucumber.rb
 lib/cucumber/ast.rb
+lib/cucumber/ast/background.rb
 lib/cucumber/ast/comment.rb
 lib/cucumber/ast/examples.rb
 lib/cucumber/ast/feature.rb
@@ -218,6 +228,7 @@ rails_generators/feature/USAGE
 rails_generators/feature/feature_generator.rb
 rails_generators/feature/templates/feature.erb
 rails_generators/feature/templates/steps.erb
+spec/cucumber/ast/background_spec.rb
 spec/cucumber/ast/feature_factory.rb
 spec/cucumber/ast/feature_spec.rb
 spec/cucumber/ast/py_string_spec.rb

data/examples/self_test/features/background/failing_background.feature

@@ -0,0 +1,10 @@
+Feature: Failing background sample
+  
+  Background:
+    Given failing without a table
+    
+  Scenario: failing background
+    Then I should have '10' cukes
+    
+  Scenario: another failing background
+    Then I should have '10' cukes

data/examples/self_test/features/background/failing_background_after_success.feature

@@ -0,0 +1,11 @@
+Feature: Failing background after previously successful background sample
+
+  Background:
+    Given passing without a table
+    And '10' global cukes
+
+  Scenario: passing background
+    Then I should have '10' global cukes
+    
+  Scenario: failing background
+    Then I should have '10' global cukes

data/examples/self_test/features/background/multiline_args_background.feature

@@ -0,0 +1,32 @@
+Feature: Passing background with multiline args
+
+  Background:
+    Given table
+      |a|b|
+      |c|d|
+    And multiline string
+    """
+      I'm a cucumber and I'm okay. 
+      I sleep all night and I test all day
+    """
+
+  Scenario: passing background
+    Then the table should be
+      |a|b|
+      |c|d|
+    Then the multiline string should be
+    """
+      I'm a cucumber and I'm okay. 
+      I sleep all night and I test all day
+    """
+
+  Scenario: another passing background
+    Then the table should be
+      |a|b|
+      |c|d|
+    Then the multiline string should be
+    """
+      I'm a cucumber and I'm okay. 
+      I sleep all night and I test all day
+    """
+    

data/examples/self_test/features/background/passing_background.feature

@@ -0,0 +1,10 @@
+Feature: Passing background sample
+
+  Background:
+    Given '10' cukes
+
+  Scenario: passing background
+    Then I should have '10' cukes
+    
+  Scenario: another passing background
+    Then I should have '10' cukes

data/examples/self_test/features/background/pending_background.feature

@@ -0,0 +1,10 @@
+Feature: Pending background sample
+
+  Background:
+    Given pending
+
+  Scenario: pending background
+    Then I should have '10' cukes
+    
+  Scenario: another pending background
+    Then I should have '10' cukes

data/examples/self_test/features/background/scenario_outline_failing_background.feature

@@ -0,0 +1,16 @@
+Feature: Failing background with scenario outlines sample
+
+  Background:
+    Given failing without a table
+
+  Scenario Outline: failing background
+    Then I should have '<count>' cukes
+    Examples:
+      |count|
+      | 10  |
+
+  Scenario Outline: another failing background
+    Then I should have '<count>' cukes
+    Examples:
+      |count|
+      | 10  |

data/examples/self_test/features/background/scenario_outline_passing_background.feature

@@ -0,0 +1,16 @@
+Feature: Passing background with scenario outlines sample
+
+  Background:
+    Given '10' cukes
+
+  Scenario Outline: passing background
+    Then I should have '<count>' cukes
+    Examples:
+      |count|
+      | 10  |
+
+  Scenario Outline: another passing background
+    Then I should have '<count>' cukes
+    Examples:
+      |count|
+      | 10  |

data/examples/self_test/features/step_definitions/sample_steps.rb

@@ -22,4 +22,41 @@ end
 
 Given /^call step "(.*)"$/ do |step|
   Given step
-end
+end
+
+Given /^'(.+)' cukes$/ do |cukes|
+  @cukes = cukes
+end
+
+Then /^I should have '(.+)' cukes$/ do |cukes|
+  @cukes.should == cukes
+end
+
+Given /^'(.+)' global cukes$/ do |cukes|
+  $scenario_runs ||= 0
+  flunker if $scenario_runs > 0
+  $cukes = cukes
+  $scenario_runs += 1
+end
+
+Then /^I should have '(.+)' global cukes$/ do |cukes|
+  $cukes.should == cukes
+end
+
+Given /^table$/ do |table|
+  @table = table
+end
+
+Given /^multiline string$/ do |string|
+  @multiline = string
+end
+
+Then /^the table should be$/ do |table|
+  @table.to_sexp.should == table.to_sexp
+end
+
+Then /^the multiline string should be$/ do |string|
+  @multiline.should == string
+end
+
+

data/examples/self_test/features/support/env.rb

@@ -0,0 +1 @@
+require 'spec/expectations'

data/features/background.feature

@@ -0,0 +1,223 @@
+Feature: backgrounds
+  In order to provide a context to my scenarios within a feature
+  As a feature editor
+  I want to write a background section in my features.
+
+  Scenario: run a specific scenario with a background
+    When I run cucumber -q features/background/passing_background.feature:9 --require features
+    Then it should pass with
+    """
+    Feature: Passing background sample
+    
+      Background: 
+        Given '10' cukes
+
+      Scenario: another passing background
+        Then I should have '10' cukes
+
+    1 scenario
+    2 passed steps
+    
+    """
+  
+  Scenario: run a feature with a background that passes
+    When I run cucumber -q features/background/passing_background.feature --require features
+    Then it should pass with
+    """
+    Feature: Passing background sample
+
+      Background: 
+        Given '10' cukes
+
+      Scenario: passing background
+        Then I should have '10' cukes
+
+      Scenario: another passing background
+        Then I should have '10' cukes
+
+    2 scenarios
+    4 passed steps
+    
+    """
+
+  Scenario: run a feature with scenario outlines that has a background that passes
+    When I run cucumber -q features/background/scenario_outline_passing_background.feature --require features
+    Then it should pass with
+    """
+    Feature: Passing background with scenario outlines sample
+
+      Background: 
+        Given '10' cukes
+
+      Scenario Outline: passing background
+        Then I should have '<count>' cukes
+
+      Examples: 
+        | count |
+        | 10    |
+
+      Scenario Outline: another passing background
+        Then I should have '<count>' cukes
+
+      Examples: 
+        | count |
+        | 10    |
+
+    2 scenarios
+    4 passed steps
+
+    """
+
+  Scenario: run a feature with a background that fails
+    When I run cucumber -q features/background/failing_background.feature --require features
+    Then it should fail with
+    """
+    Feature: Failing background sample
+
+      Background: 
+        Given failing without a table
+          FAIL (RuntimeError)
+          ./features/step_definitions/sample_steps.rb:2:in `flunker'
+          ./features/step_definitions/sample_steps.rb:16:in `/^failing without a table$/'
+          features/background/failing_background.feature:4:in `Given failing without a table'
+
+      Scenario: failing background
+        Then I should have '10' cukes
+
+      Scenario: another failing background
+        Then I should have '10' cukes
+
+    2 scenarios
+    2 failed steps
+    2 skipped steps
+
+    """
+
+  Scenario: run a feature with scenario outlines that has a background that fails
+    When I run cucumber -q features/background/scenario_outline_failing_background.feature --require features
+    Then it should fail with
+    """
+    Feature: Failing background with scenario outlines sample
+
+      Background: 
+        Given failing without a table
+          FAIL (RuntimeError)
+          ./features/step_definitions/sample_steps.rb:2:in `flunker'
+          ./features/step_definitions/sample_steps.rb:16:in `/^failing without a table$/'
+          features/background/scenario_outline_failing_background.feature:4:in `Given failing without a table'
+
+      Scenario Outline: failing background
+        Then I should have '<count>' cukes
+
+      Examples: 
+        | count |
+        | 10    |
+
+      Scenario Outline: another failing background
+        Then I should have '<count>' cukes
+
+      Examples: 
+        | count |
+        | 10    |
+
+    2 scenarios
+    2 failed steps
+    2 skipped steps
+
+    """
+
+  Scenario: run a feature with a background that is pending
+    When I run cucumber -q features/background/pending_background.feature --require features
+    Then it should pass with
+    """
+    Feature: Pending background sample
+
+      Background: 
+        Given pending
+
+      Scenario: pending background
+        Then I should have '10' cukes
+
+      Scenario: another pending background
+        Then I should have '10' cukes
+
+    2 scenarios
+    2 skipped steps
+    2 undefined steps
+
+    """
+
+  Scenario: background passes with first scenario but fails with second
+    When I run cucumber -q features/background/failing_background_after_success.feature --require features
+    Then it should fail with
+    """
+    Feature: Failing background after previously successful background sample
+
+      Background: 
+        Given passing without a table
+        And '10' global cukes
+
+      Scenario: passing background
+        Then I should have '10' global cukes
+
+      Background: 
+        Given passing without a table
+        And '10' global cukes
+          FAIL (RuntimeError)
+          ./features/step_definitions/sample_steps.rb:2:in `flunker'
+          ./features/step_definitions/sample_steps.rb:37:in `/^'(.+)' global cukes$/'
+          features/background/failing_background_after_success.feature:3:in `And '10' global cukes'
+
+      Scenario: failing background
+        Then I should have '10' global cukes
+
+    2 scenarios
+    1 failed step
+    1 skipped step
+    4 passed steps
+
+    """
+
+  Scenario: background with multline args
+  When I run cucumber -q features/background/multiline_args_background.feature --require features
+  Then it should pass with
+    """
+    Feature: Passing background with multiline args
+
+      Background: 
+        Given table
+          | a | b |
+          | c | d |
+        And multiline string
+          \"\"\"
+            I'm a cucumber and I'm okay. 
+            I sleep all night and I test all day
+          \"\"\"
+
+      Scenario: passing background
+        Then the table should be
+          | a | b |
+          | c | d |
+        Then the multiline string should be
+          \"\"\"
+            I'm a cucumber and I'm okay. 
+            I sleep all night and I test all day
+          \"\"\"
+
+      Scenario: another passing background
+        Then the table should be
+          | a | b |
+          | c | d |
+        Then the multiline string should be
+          \"\"\"
+            I'm a cucumber and I'm okay. 
+            I sleep all night and I test all day
+          \"\"\"
+
+    2 scenarios
+    8 passed steps
+    
+    """
+
+  @josephwilk
+  Scenario: run a scenario showing explicit background steps --explicit-background

data/features/cucumber_cli.feature

@@ -148,7 +148,7 @@ Feature: Cucumber command line
       """
 
   Scenario: --dry-run
-    When I run cucumber --dry-run --no-snippets features
+    When I run cucumber --dry-run --no-snippets features/*.feature
     Then it should pass with
       """
       Feature: Calling undefined step

data/lib/cucumber/ast.rb

@@ -4,6 +4,7 @@ require 'cucumber/ast/features'
 require 'cucumber/ast/feature'
 require 'cucumber/ast/scenario'
 require 'cucumber/ast/scenario_outline'
+require 'cucumber/ast/background'
 require 'cucumber/ast/step'
 require 'cucumber/ast/table'
 require 'cucumber/ast/py_string'

data/lib/cucumber/ast/background.rb

@@ -0,0 +1,88 @@
+module Cucumber
+  module Ast
+    class Background < Scenario
+
+      attr_accessor :world
+      attr_reader :status
+
+      def initialize(comment, line, keyword, steps)
+        @record_executed_steps = true
+        super(comment, Tags.new(1, []), line, keyword, "", steps)
+      end
+
+      def accept(visitor)
+        @world = visitor.new_world
+        if already_visited_steps?
+          @status = execute_steps(visitor)
+        else
+          @status = visit_background_and_steps(visitor, @steps)
+          @steps_visited = true
+        end
+      end
+
+      def step_executed(step)
+        @feature.step_executed(step) if @feature && @record_executed_steps
+      end
+
+      def already_visited_steps?
+        @steps_visited
+      end
+
+      def to_sexp #:nodoc:
+        sexp = [:background, @line, @keyword]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        tags = @tags.to_sexp
+        sexp += tags if tags.any?
+        steps = @steps.map{|step| step.to_sexp}
+        sexp += steps if steps.any?
+        sexp
+      end
+      
+      private
+
+      def visit_background_and_steps(visitor, steps)
+        visitor.visit_comment(@comment)
+        visitor.visit_scenario_name(@keyword, @name, file_line(@line), source_indent(text_length))
+
+        previous = :passed
+        steps.each do |step|
+          step.previous = previous
+          step.world    = @world
+          visitor.visit_step(step)
+          previous = step.status
+        end
+        previous
+      end
+      
+      def execute_steps(visitor)
+        previous = :passed
+        executed_steps = []
+        exception = nil
+        @steps.each do |step|
+          executed_step, previous, _ = step.execute_as_new(@world, previous, visitor, @line)
+          executed_steps << executed_step
+          exception ||= executed_step.exception
+        end
+        @steps = executed_steps
+        
+        if exception && @status != :failed
+          without_recording_steps do
+            @steps_visited = false
+            #Since the steps have already been executed they will not be re-run, they will just be displayed
+            visitor.visit_background(self)
+          end 
+        end
+
+        previous
+      end
+
+      def without_recording_steps
+        @record_executed_steps = false
+        yield
+        @record_executed_steps = true
+      end
+
+    end
+  end
+end

data/lib/cucumber/ast/feature.rb

@@ -5,9 +5,13 @@ module Cucumber
       attr_accessor :file
       attr_writer :features, :lines
 
-      def initialize(comment, tags, name, feature_elements)
-        @comment, @tags, @name, @feature_elements = comment, tags, name, feature_elements
-        feature_elements.each{|feature_element| feature_element.feature = self}
+      def initialize(comment, tags, name, feature_elements, background = nil)
+        @comment, @tags, @name, @feature_elements, @background = comment, tags, name, feature_elements, background
+        feature_elements.each do |feature_element| 
+          feature_element.feature = self
+          feature_element.background = background if background
+        end
+        background.feature = self if background
         @lines = []
       end
 
@@ -25,6 +29,7 @@ module Cucumber
         visitor.visit_comment(@comment)
         visitor.visit_tags(@tags)
         visitor.visit_feature_name(@name)
+        
         @feature_elements.each do |feature_element|
           visitor.visit_feature_element(feature_element) if @features.visit?(feature_element, @lines)
         end
@@ -52,6 +57,7 @@ module Cucumber
         sexp += [comment] if comment
         tags = @tags.to_sexp
         sexp += tags if tags.any?
+        sexp += [@background.to_sexp] if @background
         sexp += @feature_elements.map{|e| e.to_sexp}
         sexp
       end

data/lib/cucumber/ast/scenario.rb

@@ -1,7 +1,7 @@
 module Cucumber
   module Ast
     class Scenario
-      attr_writer :feature
+      attr_writer :feature, :background
       
       def initialize(comment, tags, line, keyword, name, steps)
         @comment, @tags, @line, @keyword, @name = comment, tags, line, keyword, name
@@ -22,11 +22,15 @@ module Cucumber
       end
 
       def accept(visitor)
+        visitor.visit_background(@background) if @background
         visitor.visit_comment(@comment)
         visitor.visit_tags(@tags)
         visitor.visit_scenario_name(@keyword, @name, file_line(@line), source_indent(text_length))
-        visitor.world(self) do |world|
-          previous = :passed
+
+        prior_world = @background ? @background.world : nil
+        visitor.world(self, prior_world) do |world|
+
+          previous = @background ? @background.status : :passed
           @steps.each do |step|
             step.previous = previous
             step.world    = world

data/lib/cucumber/ast/scenario_outline.rb

@@ -27,6 +27,7 @@ module Cucumber
       end
 
       def accept(visitor)
+        visitor.visit_background(@background) if @background
         visitor.visit_comment(@comment)
         visitor.visit_tags(@tags)
         visitor.visit_scenario_name(@keyword, @name, file_line(@line), source_indent(text_length))
@@ -40,8 +41,11 @@ module Cucumber
 
       def execute_row(cells, visitor, &proc)
         exception = nil
-        visitor.world(self) do |world|
-          previous_status = :passed
+        
+        prior_world = @background ? @background.world : nil
+        visitor.world(self, prior_world) do |world|
+          
+          previous_status = @background ? @background.status : :passed
           argument_hash = cells.to_hash
           cell_index = 0
           @steps.each do |step|

data/lib/cucumber/ast/step.rb

@@ -19,6 +19,10 @@ module Cucumber
 
         execute_twin(world, previous, visitor, row_line, name, *multiline_args)
       end
+      
+      def execute_as_new(world, previous, visitor, row_line)
+        execute_twin(world, previous, visitor, row_line, @name, *@multiline_args)
+      end
 
       def accept(visitor)
         execute(visitor)

data/lib/cucumber/ast/visitor.rb

@@ -8,8 +8,12 @@ module Cucumber
         @step_mother = step_mother
       end
 
-      def world(scenario, &proc)
-        @step_mother.world(scenario, &proc)
+      def world(scenario, world = nil, &proc)
+        @step_mother.world(scenario, world, &proc)
+      end
+      
+      def new_world
+        @step_mother.new_world
       end
 
       def step_definition(step_name)
@@ -53,6 +57,10 @@ module Cucumber
       def visit_feature_element(feature_element)
         feature_element.accept(self)
       end
+      
+      def visit_background(background)
+        background.accept(self)
+      end
 
       def visit_examples(examples)
         examples.accept(self)

data/lib/cucumber/formatter/pretty.rb

@@ -85,6 +85,13 @@ module Cucumber
         @io.flush
       end
 
+     def visit_background(background)
+        @indent = 2
+        background_already_visible = background.already_visited_steps?
+        background.accept(self)
+        @io.puts unless background_already_visible
+      end
+
       def visit_examples(examples)
         examples.accept(self)
       end

data/lib/cucumber/languages.yml

@@ -45,6 +45,20 @@
   then: Yna
   and: A
   but: Ond
+"cz":
+  name: Czech
+  native: Česky
+  encoding: UTF-8
+  feature: Požadavek
+  background: Pozadí
+  scenario: Scénář
+  scenario_outline: Náčrt Scénáře
+  examples: Příklady
+  given: Pokud
+  when: Když
+  then: Pak
+  and: A
+  but: Ale
 "da":
   name: Danish
   native: dansk
@@ -64,6 +78,7 @@
   native: Deutsch
   encoding: UTF-8
   feature: Funktionalität
+  background: Grundlage
   scenario: Szenario
   scenario_outline: Szenariogrundriss
   examples: Beispiele
@@ -314,4 +329,4 @@
   when: 만일
   then: 그러면
   and: 그리고
-  but: 하지만
+  but: 하지만

data/lib/cucumber/parser/feature.rb

@@ -42,14 +42,22 @@ module Cucumber
           elements[5]
         end
 
-        def feature_elements
+        def background
           elements[6]
         end
+
+        def feature_elements
+          elements[7]
+        end
       end
 
       module Feature2
         def build
-          Ast::Feature.new(comment.build, tags.build, header.text_value, feature_elements.build)
+          if background.respond_to?(:build)
+            Ast::Feature.new(comment.build, tags.build, header.text_value, feature_elements.build, background.build)
+          else
+            Ast::Feature.new(comment.build, tags.build, header.text_value, feature_elements.build)
+          end
         end
       end
 
@@ -90,8 +98,13 @@ module Cucumber
                       if r11
                         r9 = r11
                       else
-                        self.index = i9
-                        r9 = nil
+                        r12 = _nt_background
+                        if r12
+                          r9 = r12
+                        else
+                          self.index = i9
+                          r9 = nil
+                        end
                       end
                     end
                     if r9
@@ -103,13 +116,13 @@ module Cucumber
                     s7 << r8
                     if r8
                       if index < input_length
-                        r12 = (SyntaxNode).new(input, index...(index + 1))
+                        r13 = (SyntaxNode).new(input, index...(index + 1))
                         @index += 1
                       else
                         terminal_parse_failure("any character")
-                        r12 = nil
+                        r13 = nil
                       end
-                      s7 << r12
+                      s7 << r13
                     end
                     if s7.last
                       r7 = (SyntaxNode).new(input, i7...index, s7)
@@ -127,8 +140,17 @@ module Cucumber
                   r6 = SyntaxNode.new(input, i6...index, s6)
                   s0 << r6
                   if r6
-                    r13 = _nt_feature_elements
-                    s0 << r13
+                    r15 = _nt_background
+                    if r15
+                      r14 = r15
+                    else
+                      r14 = SyntaxNode.new(input, index...index)
+                    end
+                    s0 << r14
+                    if r14
+                      r16 = _nt_feature_elements
+                      s0 << r16
+                    end
                   end
                 end
               end
@@ -414,6 +436,115 @@ module Cucumber
         return r0
       end
 
+      module Background0
+        def comment
+          elements[0]
+        end
+
+        def white
+          elements[1]
+        end
+
+        def background_keyword
+          elements[2]
+        end
+
+        def steps
+          elements[5]
+        end
+      end
+
+      module Background1
+        def build
+          Ast::Background.new(
+            comment.build, 
+            background_keyword.line,
+            background_keyword.text_value, 
+            steps.build
+          )
+         end
+      end
+
+      def _nt_background
+        start_index = index
+        if node_cache[:background].has_key?(index)
+          cached = node_cache[:background][index]
+          @index = cached.interval.end if cached
+          return cached
+        end
+
+        i0, s0 = index, []
+        r1 = _nt_comment
+        s0 << r1
+        if r1
+          r2 = _nt_white
+          s0 << r2
+          if r2
+            r3 = _nt_background_keyword
+            s0 << r3
+            if r3
+              s4, i4 = [], index
+              loop do
+                r5 = _nt_space
+                if r5
+                  s4 << r5
+                else
+                  break
+                end
+              end
+              r4 = SyntaxNode.new(input, i4...index, s4)
+              s0 << r4
+              if r4
+                i6 = index
+                s7, i7 = [], index
+                loop do
+                  r8 = _nt_eol
+                  if r8
+                    s7 << r8
+                  else
+                    break
+                  end
+                end
+                if s7.empty?
+                  self.index = i7
+                  r7 = nil
+                else
+                  r7 = SyntaxNode.new(input, i7...index, s7)
+                end
+                if r7
+                  r6 = r7
+                else
+                  r9 = _nt_eof
+                  if r9
+                    r6 = r9
+                  else
+                    self.index = i6
+                    r6 = nil
+                  end
+                end
+                s0 << r6
+                if r6
+                  r10 = _nt_steps
+                  s0 << r10
+                end
+              end
+            end
+          end
+        end
+        if s0.last
+          r0 = (SyntaxNode).new(input, i0...index, s0)
+          r0.extend(Background0)
+          r0.extend(Background1)
+        else
+          self.index = i0
+          r0 = nil
+        end
+
+        node_cache[:background][start_index] = r0
+
+        return r0
+      end
+
       module FeatureElements0
         def build
           elements.map{|s| s.build}

data/lib/cucumber/parser/feature.tt

@@ -8,9 +8,13 @@ module Cucumber
       include Table
 
       rule feature
-        white comment white tags white header:(!(scenario_outline / scenario) .)* feature_elements {
+        white comment white tags white header:(!(scenario_outline / scenario / background) .)* background:(background)? feature_elements {
           def build
-            Ast::Feature.new(comment.build, tags.build, header.text_value, feature_elements.build)
+            if background.respond_to?(:build)
+              Ast::Feature.new(comment.build, tags.build, header.text_value, feature_elements.build, background.build)
+            else
+              Ast::Feature.new(comment.build, tags.build, header.text_value, feature_elements.build)
+            end
           end
         }
       end
@@ -40,6 +44,19 @@ module Cucumber
         '#' line_to_eol
       end
 
+      rule background
+         comment white background_keyword space* (eol+ / eof) steps {
+           def build
+             Ast::Background.new(
+               comment.build, 
+               background_keyword.line,
+               background_keyword.text_value, 
+               steps.build
+             )
+            end
+          }
+      end
+
       rule feature_elements
         (scenario / scenario_outline)* {
           def build

data/lib/cucumber/parser/i18n.tt

@@ -2,6 +2,10 @@ module Cucumber
   module Parser
     grammar I18n
 
+      rule background_keyword
+        "<%= keywords['background'] %>:"
+      end
+
       rule scenario_keyword
         '<%= keywords['scenario'] %>:'
       end

data/lib/cucumber/step_mother.rb

@@ -62,8 +62,8 @@ module Cucumber
       step_definition
     end
 
-    def world(scenario, &proc)
-      world = new_world
+    def world(scenario, prior_world = nil, &proc)
+      world = prior_world || new_world
       begin
         (@before_procs ||= []).each do |proc|
           world.cucumber_instance_exec(false, 'Before', scenario, &proc)

data/lib/cucumber/version.rb

@@ -3,7 +3,7 @@ module Cucumber #:nodoc:
     MAJOR = 0
     MINOR = 1
     TINY  = 99
-    PATCH = 11 # Set to nil for official release
+    PATCH = 12 # Set to nil for official release
 
     STRING = [MAJOR, MINOR, TINY, PATCH].compact.join('.')
   end

data/spec/cucumber/ast/background_spec.rb

@@ -0,0 +1,58 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'cucumber/ast'
+
+module Cucumber
+  module Ast
+    describe Background do
+
+      it "should visit a step on the first background run" do
+        step = Step.new(7, "Given", "passing")
+        background = Background.new(
+          comment=Comment.new(""), 
+          line=99,
+          keyword="", 
+          steps=[
+            step
+          ])
+          visitor = mock('visitor', :null_object => true)
+
+          visitor.should_receive(:visit_step).with(step)
+          
+          background.accept(visitor)
+      end
+      
+      describe "having already visited background once" do
+
+        before(:each) do
+          @mock_step = mock('step', :null_object => true, :text_length => 1)
+          @background = Background.new(
+            comment=Comment.new(""), 
+            line=99,
+            keyword="", 
+            steps=[
+              @mock_step
+            ])
+            
+          @visitor = mock('visitor', :null_object => true)
+          @background.accept(@visitor)
+        end
+      
+        it "should execute the steps" do
+          @mock_step.should_receive(:execute_as_new).and_return(mock('executed step', :null_object => true))
+        
+          @background.accept(@visitor)
+        end
+        
+        it "should visit the background if there was a exception when executing a step" do
+          mock_executed_step = mock('executed step', :null_object => true, :exception => Exception.new)
+          @mock_step.stub!(:execute_as_new).and_return(mock_executed_step)
+        
+          @visitor.should_receive(:visit_background).with(@background)
+        
+          @background.accept(@visitor)
+        end
+
+      end
+    end
+  end
+end

data/spec/cucumber/parser/feature_parser_spec.rb

@@ -89,6 +89,15 @@ Feature: hi
               [:tag, "st3"], [:tag, "st4"]]]
         end
       end
+      
+      describe "Background" do
+        it "should have steps" do
+          parse("Feature: Hi\nBackground:\nGiven I am a step\n").to_sexp.should ==
+          [:feature, "Feature: Hi",
+            [:background, 2, "Background:",
+              [:step, 3, "Given", "I am a step"]]]
+        end
+      end
 
       describe "Scenarios" do
         it "can be empty" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: aslakhellesoy-cucumber
 version: !ruby/object:Gem::Version 
-  version: 0.1.99.11
+  version: 0.1.99.12
 platform: ruby
 authors: 
 - "Aslak Helles\xC3\xB8y"
@@ -181,11 +181,19 @@ files:
 - examples/selenium/features/search.feature
 - examples/selenium/features/step_definitons/stories_steps.rb
 - examples/self_test/README.textile
+- examples/self_test/features/background/failing_background.feature
+- examples/self_test/features/background/failing_background_after_success.feature
+- examples/self_test/features/background/multiline_args_background.feature
+- examples/self_test/features/background/passing_background.feature
+- examples/self_test/features/background/pending_background.feature
+- examples/self_test/features/background/scenario_outline_failing_background.feature
+- examples/self_test/features/background/scenario_outline_passing_background.feature
 - examples/self_test/features/call_undefined_step_from_step_def.feature
 - examples/self_test/features/lots_of_undefined.feature
 - examples/self_test/features/outline_sample.feature
 - examples/self_test/features/sample.feature
 - examples/self_test/features/step_definitions/sample_steps.rb
+- examples/self_test/features/support/env.rb
 - examples/test_unit/Rakefile
 - examples/test_unit/features/step_definitions/test_unit_steps.rb
 - examples/test_unit/features/test_unit.feature
@@ -203,6 +211,7 @@ files:
 - examples/watir/features/search.feature
 - examples/watir/features/step_definitons/search_steps.rb
 - examples/watir/features/support/env.rb
+- features/background.feature
 - features/cucumber_cli.feature
 - features/cucumber_cli_outlines.feature
 - features/report_called_undefined_steps.feature
@@ -225,6 +234,7 @@ files:
 - lib/autotest/discover.rb
 - lib/cucumber.rb
 - lib/cucumber/ast.rb
+- lib/cucumber/ast/background.rb
 - lib/cucumber/ast/comment.rb
 - lib/cucumber/ast/examples.rb
 - lib/cucumber/ast/feature.rb
@@ -282,6 +292,7 @@ files:
 - rails_generators/feature/feature_generator.rb
 - rails_generators/feature/templates/feature.erb
 - rails_generators/feature/templates/steps.erb
+- spec/cucumber/ast/background_spec.rb
 - spec/cucumber/ast/feature_factory.rb
 - spec/cucumber/ast/feature_spec.rb
 - spec/cucumber/ast/py_string_spec.rb