dwaite-cucumber 0.3.101

data/lib/cucumber/ast/comment.rb

@@ -0,0 +1,31 @@
+module Cucumber
+  module Ast
+    # Holds the value of a comment parsed from a feature file:
+    #
+    #   # Lorem ipsum
+    #   # dolor sit amet
+    #
+    # This gets parsed into a Comment with value <tt>"# Lorem ipsum\n# dolor sit amet\n"</tt>
+    #
+    class Comment #:nodoc:
+      def initialize(value)
+        @value = value
+      end
+
+      def empty?
+        @value.nil? || @value == ""
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        @value.strip.split("\n").each do |line|
+          visitor.visit_comment_line(line.strip)
+        end
+      end
+      
+      def to_sexp
+        (@value.nil? || @value == '') ? nil : [:comment, @value]
+      end
+    end
+  end
+end

data/lib/cucumber/ast/examples.rb

@@ -0,0 +1,32 @@
+module Cucumber
+  module Ast
+    class Examples #:nodoc:
+      def initialize(comment, line, keyword, name, outline_table)
+        @comment, @keyword, @name, @outline_table = comment, keyword, name, outline_table
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        visitor.visit_comment(@comment) unless @comment.empty?
+        visitor.visit_examples_name(@keyword, @name)
+        visitor.visit_outline_table(@outline_table)
+      end
+
+      def skip_invoke!
+        @outline_table.skip_invoke!
+      end
+
+      def each_example_row(&proc)
+        @outline_table.cells_rows[1..-1].each(&proc)
+      end
+
+      def to_sexp
+        sexp = [:examples, @keyword, @name]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        sexp += [@outline_table.to_sexp]
+        sexp
+      end
+    end
+  end
+end

data/lib/cucumber/ast/feature.rb

@@ -0,0 +1,81 @@
+module Cucumber
+  module Ast
+    # Represents the root node of a parsed feature.
+    class Feature #:nodoc:
+      attr_accessor :file, :language
+      attr_writer :features
+      attr_reader :name
+
+      def initialize(background, comment, tags, name, feature_elements)
+        @background, @comment, @tags, @name, @feature_elements = background, comment, tags, name.strip, feature_elements
+
+        background.feature = self if background
+        @feature_elements.each do |feature_element|
+          feature_element.feature = self
+        end
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        visitor.visit_comment(@comment) unless @comment.empty?
+        visitor.visit_tags(@tags)
+        visitor.visit_feature_name(@name)
+        visitor.visit_background(@background) if @background
+        @feature_elements.each do |feature_element|
+          visitor.visit_feature_element(feature_element)
+        end
+      end
+
+      def accept_hook?(hook)
+        @tags.accept_hook?(hook)
+      end
+
+      def next_feature_element(feature_element, &proc)
+        index = @feature_elements.index(feature_element)
+        next_one = @feature_elements[index+1]
+        proc.call(next_one) if next_one
+      end
+
+      def backtrace_line(step_name, line)
+        "#{file_colon_line(line)}:in `#{step_name}'"
+      end
+
+      def file_colon_line(line)
+        "#{@file}:#{line}"
+      end
+
+      def tag_count(tag)
+        if @tags.respond_to?(:count)
+          @tags.count(tag) # 1.9
+        else
+          @tags.select{|t| t == tag}.length  # 1.8
+        end
+      end
+
+      def feature_and_children_tag_count(tag)
+        children_tag_count = @feature_elements.inject(0){|count, feature_element| count += feature_element.tag_count(tag)}
+        children_tag_count + tag_count(tag)
+      end
+
+      def short_name
+        first_line = name.split(/\n/)[0]
+        if first_line =~ /#{language.keywords('feature', true)}:(.*)/
+          $1.strip
+        else
+          first_line
+        end
+      end
+
+      def to_sexp
+        sexp = [:feature, @file, @name]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        tags = @tags.to_sexp
+        sexp += tags if tags.any?
+        sexp += [@background.to_sexp] if @background
+        sexp += @feature_elements.map{|fe| fe.to_sexp}
+        sexp
+      end
+    end
+  end
+end

data/lib/cucumber/ast/feature_element.rb

@@ -0,0 +1,61 @@
+require 'enumerator'
+
+module Cucumber
+  module FeatureElement #:nodoc:
+    attr_accessor :feature
+
+    def attach_steps(steps)
+      steps.each {|step| step.feature_element = self}
+    end
+
+    def file_colon_line(line = @line)
+      @feature.file_colon_line(line) if @feature
+    end
+
+    def text_length
+      name_line_lengths.max
+    end
+
+    def first_line_length
+      name_line_lengths[0]
+    end
+
+    def name_line_lengths
+      if @name.strip.empty?
+        [@keyword.jlength]
+      else
+        @name.split("\n").enum_for(:each_with_index).map do |line, line_number|
+          line_number == 0 ? @keyword.jlength + line.jlength : line.jlength + Ast::Step::INDENT - 1 # We -1 as names which are not keyword lines are missing a space between keyword and name
+        end
+      end
+    end
+
+    def matches_scenario_names?(scenario_name_regexps)
+      scenario_name_regexps.detect{|name| name =~ @name}
+    end
+
+    def backtrace_line(name = "#{@keyword} #{@name}", line = @line)
+      @feature.backtrace_line(name, line) if @feature
+    end
+
+    def source_indent(text_length)
+      max_line_length - text_length
+    end
+
+    def max_line_length
+      @steps.max_line_length(self)
+    end
+
+    def accept_hook?(hook)
+      @tags.accept_hook?(hook) || @feature.accept_hook?(hook)
+    end
+
+    def tag_count(tag)
+      @feature.tag_count(tag) == 0 ? @tags.count(tag) : @feature.tag_count(tag)
+    end
+
+    def language
+      @feature.language
+    end
+   end
+end

data/lib/cucumber/ast/features.rb

@@ -0,0 +1,40 @@
+module Cucumber
+  module Ast
+    class Features #:nodoc:
+      include Enumerable
+
+      attr_reader :duration
+
+      def initialize
+        @features = []
+      end
+
+      def [](index)
+        @features[index]
+      end
+
+      def each(&proc)
+        @features.each(&proc)
+      end
+
+      def add_feature(feature)
+        feature.features = self
+        @features << feature
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        start = Time.now
+        self.each do |feature|
+          visitor.visit_feature(feature)
+        end
+        @duration = Time.now - start
+      end
+
+      def tag_count(tag)
+        @features.inject(0){|count, feature| count += feature.feature_and_children_tag_count(tag)}
+      end
+
+    end
+  end
+end

data/lib/cucumber/ast/outline_table.rb

@@ -0,0 +1,146 @@
+module Cucumber
+  module Ast
+    class OutlineTable < Table #:nodoc:
+      def initialize(raw, scenario_outline)
+        super(raw)
+        @scenario_outline = scenario_outline
+        @cells_class = ExampleRow
+        create_step_invocations_for_example_rows!(scenario_outline)
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        cells_rows.each_with_index do |row, n|
+          if(visitor.options[:expand])
+            row.accept(visitor)
+          else
+            visitor.visit_table_row(row)
+          end
+        end
+        nil
+      end
+
+      def accept_hook?(hook)
+        @scenario_outline.accept_hook?(hook)
+      end
+
+      def skip_invoke!
+        example_rows.each do |cells|
+          cells.skip_invoke!
+        end
+      end
+
+      def create_step_invocations_for_example_rows!(scenario_outline)
+        example_rows.each do |cells|
+          cells.create_step_invocations!(scenario_outline)
+        end
+      end
+      
+      def example_rows
+        cells_rows[1..-1]
+      end
+
+      def visit_scenario_name(visitor, row)
+        @scenario_outline.visit_scenario_name(visitor, row)
+      end
+
+      class ExampleRow < Cells #:nodoc:
+        attr_reader :scenario_outline # https://rspec.lighthouseapp.com/projects/16211/tickets/342
+
+        def create_step_invocations!(scenario_outline)
+          @scenario_outline = scenario_outline
+          @step_invocations = scenario_outline.step_invocations(self)
+        end
+        
+        def skip_invoke!
+          @step_invocations.each do |step_invocation|
+            step_invocation.skip_invoke!
+          end
+        end
+
+        def accept(visitor)
+          return if $cucumber_interrupted
+          visitor.options[:expand] ? accept_expand(visitor) : accept_plain(visitor)
+        end
+
+        def accept_plain(visitor)
+          if header?
+            @cells.each do |cell|
+              cell.status = :skipped_param
+              visitor.visit_table_cell(cell)
+            end
+          else
+            visitor.step_mother.before_and_after(self) do
+              @step_invocations.each do |step_invocation|
+                step_invocation.invoke(visitor.step_mother, visitor.options)
+                @exception ||= step_invocation.reported_exception
+              end
+
+              @cells.each do |cell|
+                visitor.visit_table_cell(cell)
+              end
+              
+              visitor.visit_exception(@scenario_exception, :failed) if @scenario_exception
+            end
+          end
+        end
+
+        def accept_expand(visitor)
+          if header?
+          else
+            visitor.step_mother.before_and_after(self) do
+              @table.visit_scenario_name(visitor, self)
+              @step_invocations.each do |step_invocation|
+                step_invocation.invoke(visitor.step_mother, visitor.options)
+                @exception ||= step_invocation.reported_exception
+                step_invocation.visit_step_result(visitor)
+              end
+            end
+          end
+        end
+
+        def accept_hook?(hook)
+          @table.accept_hook?(hook)
+        end
+        
+        def exception
+          @exception || @scenario_exception
+        end
+        
+        def fail!(exception)
+          @scenario_exception = exception
+        end
+        
+        # Returns true if one or more steps failed
+        def failed?
+          @step_invocations.failed? || !!@scenario_exception
+        end
+
+        # Returns true if all steps passed
+        def passed?
+          !failed?
+        end
+
+        # Returns the status
+        def status
+          return :failed if @scenario_exception
+          @step_invocations.status
+        end
+
+        def backtrace_line
+          @scenario_outline.backtrace_line(name, line)
+        end
+
+        def name
+          "| #{@cells.collect{|c| c.value }.join(' | ')} |"
+        end
+
+        private
+
+        def header?
+          index == 0
+        end
+      end
+    end
+  end
+end

data/lib/cucumber/ast/py_string.rb

@@ -0,0 +1,57 @@
+module Cucumber
+  module Ast
+    # Represents an inline argument in a step. Example:
+    #
+    #   Given the message
+    #     """
+    #     I like
+    #     Cucumber sandwich
+    #     """
+    #
+    # The text between the pair of <tt>"""</tt> is stored inside a PyString,
+    # which is yielded to the StepDefinition block as the last argument.
+    #
+    # The StepDefinition can then access the String via the #to_s method. In the
+    # example above, that would return: <tt>"I like\nCucumber sandwich"</tt>
+    #
+    # Note how the indentation from the source is stripped away.
+    #
+    class PyString #:nodoc:
+      def self.default_arg_name
+        "string"
+      end
+
+      def initialize(start_line, end_line, string, quotes_indent)
+        @start_line, @end_line = start_line, end_line
+        @string, @quotes_indent = string.gsub(/\\"/, '"'), quotes_indent
+      end
+
+      def to_s
+        @string.indent(-@quotes_indent)
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        visitor.visit_py_string(to_s)
+      end
+      
+      def arguments_replaced(arguments) #:nodoc:
+        string = @string
+        arguments.each do |name, value|
+          value ||= ''
+          string = string.gsub(name, value)
+        end
+        PyString.new(@start_line, @end_line, string, @quotes_indent)
+      end
+
+      def has_text?(text)
+        @string.index(text)
+      end
+
+      # For testing only
+      def to_sexp #:nodoc:
+        [:py_string, to_s]
+      end
+    end
+  end
+end

data/lib/cucumber/ast/scenario.rb

@@ -0,0 +1,108 @@
+require 'cucumber/ast/feature_element'
+
+module Cucumber
+  module Ast
+    class Scenario #:nodoc:
+      include FeatureElement
+      
+      attr_reader :name, :line
+      
+      class EmptyBackground 
+        def failed?
+          false
+        end
+        
+        def feature_elements
+          []
+        end
+        
+        def step_collection(step_invocations)
+          StepCollection.new(step_invocations)
+        end
+      end
+      
+      def initialize(background, comment, tags, line, keyword, name, steps)
+        @background = background || EmptyBackground.new
+        @comment, @tags, @line, @keyword, @name = comment, tags, line, keyword, name
+        attach_steps(steps)
+
+        step_invocations = steps.map{|step| step.step_invocation}
+        @steps = @background.step_collection(step_invocations)
+        @background.feature_elements << self
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        
+        with_visitor(visitor) do
+          visitor.visit_comment(@comment) unless @comment.empty?
+          visitor.visit_tags(@tags)
+          visitor.visit_scenario_name(@keyword, @name, file_colon_line(@line), source_indent(first_line_length))
+
+          skip_invoke! if @background.failed?
+          visitor.step_mother.before_and_after(self, skip_hooks?) do
+            skip_invoke! if failed?
+            visitor.visit_steps(@steps)
+          end
+          @executed = true
+        end
+      end
+
+      # Returns true if one or more steps failed
+      def failed?
+        @steps.failed? || !!@exception
+      end
+      
+      def fail!(exception)
+        @exception = exception
+        @current_visitor.visit_exception(@exception, :failed)
+      end
+
+      # Returns true if all steps passed
+      def passed?
+        !failed?
+      end
+
+      # Returns the first exception (if any)
+      def exception
+        @exception || @steps.exception
+      end
+
+      # Returns the status
+      def status
+        return :failed if @exception
+        @steps.status
+      end
+
+      def skip_invoke!
+        @steps.each{|step_invocation| step_invocation.skip_invoke!}
+        @feature.next_feature_element(self) do |next_one|
+          next_one.skip_invoke!
+        end
+      end
+
+      def to_sexp
+        sexp = [:scenario, @line, @keyword, @name]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        tags = @tags.to_sexp
+        sexp += tags if tags.any?
+        steps = @steps.to_sexp
+        sexp += steps if steps.any?
+        sexp
+      end
+      
+      private
+      
+      def with_visitor(visitor)
+        @current_visitor = visitor
+        yield
+        @current_visitor = nil
+      end
+      
+      def skip_hooks?
+        @background.failed? || @executed
+      end
+    end
+  end
+end

data/lib/cucumber/ast/scenario_outline.rb

@@ -0,0 +1,96 @@
+module Cucumber
+  module Ast
+    class ScenarioOutline #:nodoc:
+      include FeatureElement
+
+      module ExamplesArray #:nodoc:
+        def accept(visitor)
+          return if $cucumber_interrupted
+          each do |examples|
+            visitor.visit_examples(examples)
+          end
+        end
+      end
+
+      # The +example_sections+ argument must be an Array where each element is another array representing
+      # an Examples section. This array has 3 elements:
+      #
+      # * Examples keyword
+      # * Examples section name
+      # * Raw matrix
+      def initialize(background, comment, tags, line, keyword, name, steps, example_sections)
+        @background, @comment, @tags, @line, @keyword, @name = background, comment, tags, line, keyword, name
+        attach_steps(steps)
+        @steps = StepCollection.new(steps)
+
+        @examples_array = example_sections.map do |example_section|
+          examples_comment    = example_section[0]
+          examples_line       = example_section[1]
+          examples_keyword    = example_section[2]
+          examples_name       = example_section[3]
+          examples_matrix     = example_section[4]
+
+          examples_table = OutlineTable.new(examples_matrix, self)
+          Examples.new(examples_comment, examples_line, examples_keyword, examples_name, examples_table)
+        end
+        @examples_array.extend(ExamplesArray)
+
+        @background.feature_elements << self if @background
+      end
+
+      def accept(visitor)
+        return if $cucumber_interrupted
+        visitor.visit_comment(@comment) unless @comment.empty?
+        visitor.visit_tags(@tags)
+        visitor.visit_scenario_name(@keyword, @name, file_colon_line(@line), source_indent(first_line_length))
+        visitor.visit_steps(@steps)
+
+        skip_invoke! if @background && @background.failed?
+        visitor.visit_examples_array(@examples_array) unless @examples_array.empty?
+      end
+
+      def skip_invoke!
+        @examples_array.each{|examples| examples.skip_invoke!}
+        @feature.next_feature_element(self) do |next_one|
+          next_one.skip_invoke!
+        end
+      end
+
+      def step_invocations(cells)
+        step_invocations = @steps.step_invocations_from_cells(cells)
+        if @background
+          @background.step_collection(step_invocations)
+        else
+          StepCollection.new(step_invocations)
+        end
+      end
+
+      def each_example_row(&proc)
+        @examples_array.each do |examples|
+          examples.each_example_row(&proc)
+        end
+      end
+
+      def visit_scenario_name(visitor, row)
+        visitor.visit_scenario_name(
+          @feature.language.scenario_keyword,
+          row.name, 
+          file_colon_line(row.line), 
+          source_indent(first_line_length)
+        )
+      end
+
+      def to_sexp
+        sexp = [:scenario_outline, @keyword, @name]
+        comment = @comment.to_sexp
+        sexp += [comment] if comment
+        tags = @tags.to_sexp
+        sexp += tags if tags.any?
+        steps = @steps.to_sexp
+        sexp += steps if steps.any?
+        sexp += @examples_array.map{|e| e.to_sexp}
+        sexp
+      end
+    end
+  end
+end