cucumber_analytics 1.1.1 → 1.2.0

data/lib/cucumber_analytics/row.rb

@@ -5,6 +5,8 @@ module CucumberAnalytics
   class Row
 
     include Sourceable
+    include Raw
+
 
     # The parent object that contains *self*
     attr_accessor :parent_element
@@ -48,6 +50,7 @@ module CucumberAnalytics
     def build_row(parsed_row)
       populate_element_source_line(parsed_row)
       populate_row_cells(parsed_row)
+      populate_raw_element(parsed_row)
     end
 
     def populate_row_cells(parsed_row)

data/lib/cucumber_analytics/scenario.rb

@@ -15,6 +15,7 @@ module CucumberAnalytics
       super(parsed_scenario)
 
       @tags = []
+      @tag_elements = []
 
       build_scenario(parsed_scenario) if parsed_scenario
     end

data/lib/cucumber_analytics/step.rb

@@ -6,6 +6,8 @@ module CucumberAnalytics
 
     include Containing
     include Sourceable
+    include Raw
+
 
     # The step's keyword
     attr_accessor :keyword
@@ -158,6 +160,7 @@ module CucumberAnalytics
       populate_block(step)
       populate_keyword(step)
       populate_element_source_line(step)
+      populate_raw_element(step)
 
       scan_arguments
     end

data/lib/cucumber_analytics/table.rb

@@ -4,6 +4,9 @@ module CucumberAnalytics
 
   class Table
 
+    include Raw
+
+
     # The parent object that contains *self*
     attr_accessor :parent_element
 
@@ -44,6 +47,11 @@ module CucumberAnalytics
     end
 
     def build_table(table)
+      populate_contents(table)
+      populate_raw_element(table)
+    end
+
+    def populate_contents(table)
       @contents = table.collect { |row| row['cells'] }
     end
 

data/lib/cucumber_analytics/tag.rb

@@ -0,0 +1,59 @@
+module CucumberAnalytics
+
+  # A class modeling a Tag.
+
+  class Tag
+
+    include Raw
+    include Sourceable
+
+
+    # The parent object that contains *self*
+    attr_accessor :parent_element
+
+    # The name of the Tag
+    attr_accessor :name
+
+
+    # Creates a new Tag object and, if *source* is provided, populates the
+    # object.
+    def initialize(source = nil)
+      parsed_tag = process_source(source)
+
+      build_tag(parsed_tag) if parsed_tag
+    end
+
+
+    private
+
+
+    def process_source(source)
+      case
+        when source.is_a?(String)
+          parse_tag(source)
+        else
+          source
+      end
+    end
+
+    def parse_tag(source_text)
+      base_file_string = "\nFeature: Fake feature to parse"
+      source_text = source_text + base_file_string
+
+      parsed_file = Parsing::parse_text(source_text)
+
+      parsed_file.first['tags'].first
+    end
+
+    def build_tag(parsed_tag)
+      populate_name(parsed_tag)
+      populate_raw_element(parsed_tag)
+      populate_element_source_line(parsed_tag)
+    end
+
+    def populate_name(parsed_tag)
+      @name = parsed_tag['name']
+    end
+
+  end
+end

data/lib/cucumber_analytics/taggable.rb

@@ -7,6 +7,9 @@ module CucumberAnalytics
     # The tags which are directly assigned to the element
     attr_accessor :tags
 
+    # The tag elements belonging to the element
+    attr_accessor :tag_elements
+
 
     # Returns the tags which are indirectly assigned to the element (i.e. they
     # have been inherited from a parent element).
@@ -14,11 +17,22 @@ module CucumberAnalytics
       @parent_element.respond_to?(:all_tags) ? @parent_element.all_tags : []
     end
 
+    # Returns the tags elements which are indirectly assigned to the element
+    # (i.e. they have been inherited from a parent element).
+    def applied_tag_elements
+      @parent_element.respond_to?(:all_tag_elements) ? @parent_element.all_tag_elements : []
+    end
+
     # Returns all of the tags which are applicable to the element.
     def all_tags
       applied_tags + @tags
     end
 
+    # Returns all of the tag elements which are applicable to the element.
+    def all_tag_elements
+      applied_tag_elements + @tag_elements
+    end
+
 
     private
 
@@ -27,6 +41,7 @@ module CucumberAnalytics
       if parsed_element['tags']
         parsed_element['tags'].each do |tag|
           @tags << tag['name']
+          @tag_elements << build_child_element(Tag, tag)
         end
       end
     end

data/lib/cucumber_analytics/version.rb

@@ -1,3 +1,3 @@
 module CucumberAnalytics
-  VERSION = '1.1.1'
+  VERSION = '1.2.0'
 end

data/lib/cucumber_analytics/world.rb

@@ -85,6 +85,11 @@ module CucumberAnalytics
         Array.new.tap { |accumulated_tags| collect_all_in(:tags, container, accumulated_tags) }
       end
 
+      # Returns all tag elements found in the passed container.
+      def tag_elements_in(container)
+        Array.new.tap { |accumulated_tag_elements| collect_all_in(:tag_elements, container, accumulated_tag_elements) }
+      end
+
       # Returns all directories found in the passed container.
       def directories_in(container)
         Array.new.tap { |accumulated_directories| collect_all_in(:directories, container, accumulated_directories) }

data/lib/cucumber_analytics.rb

@@ -2,6 +2,7 @@ require 'cucumber_analytics/version'
 require 'cucumber_analytics/parsing'
 require 'cucumber_analytics/containing'
 require 'cucumber_analytics/taggable'
+require 'cucumber_analytics/raw'
 require 'cucumber_analytics/sourceable'
 require 'cucumber_analytics/feature_file'
 require 'cucumber_analytics/directory'
@@ -17,3 +18,4 @@ require 'cucumber_analytics/doc_string'
 require 'cucumber_analytics/table'
 require 'cucumber_analytics/world'
 require 'cucumber_analytics/row'
+require 'cucumber_analytics/tag'

data/spec/integration/example_integration_spec.rb

@@ -5,16 +5,19 @@ SimpleCov.command_name('Example') unless RUBY_VERSION.to_s < '1.9.0'
 describe 'Example, Integration' do
 
   it 'properly sets its child elements' do
-    source = ['Examples:',
+    source = ['@a_tag',
+              'Examples:',
               '  | param   |',
               '  | value 1 |']
     source = source.join("\n")
 
     example = CucumberAnalytics::Example.new(source)
     rows = example.row_elements
+    tag = example.tag_elements.first
 
     rows[0].parent_element.should equal example
     rows[1].parent_element.should equal example
+    tag.parent_element.should equal example
   end
 
 end

data/spec/integration/feature_integration_spec.rb

@@ -11,7 +11,8 @@ describe 'Feature, Integration' do
   end
 
   it 'properly sets its child elements' do
-    source = ['Feature: Test feature',
+    source = ['@a_tag',
+              'Feature: Test feature',
               '  Background: Test background',
               '  Scenario: Test scenario',
               '  Scenario Outline: Test outline']
@@ -22,11 +23,13 @@ describe 'Feature, Integration' do
     background = feature.background
     scenario = feature.tests[0]
     outline = feature.tests[1]
+    tag = feature.tag_elements[0]
 
 
     outline.parent_element.should equal feature
     scenario.parent_element.should equal feature
     background.parent_element.should equal feature
+    tag.parent_element.should equal feature
   end
 
   it 'can distinguish scenarios from outlines - #scenarios, #outlines' do
@@ -66,13 +69,13 @@ describe 'Feature, Integration' do
     source_1 = source_1.join("\n")
 
     source_2 = ['Feature: Test feature',
-              '  Scenario: Test scenario',
-              '  Scenario Outline: Test outline',
-              '    * a step',
-              '  Examples: Test examples',
-              '    |param|',
-              '    |value_1|',
-              '    |value_2|']
+                '  Scenario: Test scenario',
+                '  Scenario Outline: Test outline',
+                '    * a step',
+                '  Examples: Test examples',
+                '    |param|',
+                '    |value_1|',
+                '    |value_2|']
     source_2 = source_2.join("\n")
 
     feature_1 = CucumberAnalytics::Feature.new(source_1)

data/spec/integration/outline_integration_spec.rb

@@ -5,7 +5,8 @@ SimpleCov.command_name('Outline') unless RUBY_VERSION.to_s < '1.9.0'
 describe 'Outline, Integration' do
 
   it 'properly sets its child elements' do
-    source = ['  Scenario Outline:',
+    source = ['@a_tag',
+              '  Scenario Outline:',
               '    * a step',
               '  Examples:',
               '    | param |']
@@ -14,9 +15,11 @@ describe 'Outline, Integration' do
     outline = CucumberAnalytics::Outline.new(source)
     example = outline.examples.first
     step = outline.steps.first
+    tag = outline.tag_elements.first
 
     example.parent_element.should equal outline
     step.parent_element.should equal outline
+    tag.parent_element.should equal outline
   end
 
 end

data/spec/integration/scenario_integration_spec.rb

@@ -5,14 +5,17 @@ SimpleCov.command_name('Scenario') unless RUBY_VERSION.to_s < '1.9.0'
 describe 'Scenario, Integration' do
 
   it 'properly sets its child elements' do
-    source = ['Scenario: Test scenario',
+    source = ['@a_tag',
+              'Scenario: Test scenario',
               '  * a step']
     source = source.join("\n")
 
     scenario = CucumberAnalytics::Scenario.new(source)
     step = scenario.steps.first
+    tag = scenario.tag_elements.first
 
     step.parent_element.should equal scenario
+    tag.parent_element.should equal scenario
   end
 
 end

data/spec/spec_helper.rb

@@ -10,6 +10,7 @@ require "#{File.dirname(__FILE__)}/unit/bare_bones_unit_specs"
 require "#{File.dirname(__FILE__)}/unit/test_element_unit_specs"
 require "#{File.dirname(__FILE__)}/unit/prepopulated_unit_specs"
 require "#{File.dirname(__FILE__)}/unit/sourced_element_unit_specs"
+require "#{File.dirname(__FILE__)}/unit/raw_element_unit_specs"
 
 
 DEFAULT_FEATURE_FILE_NAME = 'test_feature.feature'

data/spec/unit/background_unit_spec.rb

@@ -13,6 +13,7 @@ describe 'Background, Unit' do
   it_should_behave_like 'a prepopulated element', clazz
   it_should_behave_like 'a test element', clazz
   it_should_behave_like 'a sourced element', clazz
+  it_should_behave_like 'a raw element', clazz
 
   it 'can be parsed from stand alone text' do
     source = 'Background: '

data/spec/unit/doc_string_unit_spec.rb

@@ -9,6 +9,7 @@ describe 'DocString, Unit' do
   it_should_behave_like 'a nested element', clazz
   it_should_behave_like 'a bare bones element', clazz
   it_should_behave_like 'a prepopulated element', clazz
+  it_should_behave_like 'a raw element', clazz
 
   it 'can be parsed from stand alone text' do
     source = "\"\"\"\nsome doc string\n\"\"\""

data/spec/unit/example_unit_spec.rb

@@ -13,6 +13,7 @@ describe 'Example, Unit' do
   it_should_behave_like 'a prepopulated element', clazz
   it_should_behave_like 'a sourced element', clazz
   it_should_behave_like 'a containing element', clazz
+  it_should_behave_like 'a raw element', clazz
 
 
   it 'can be parsed from stand alone text' do

data/spec/unit/feature_unit_spec.rb

@@ -13,6 +13,7 @@ describe 'Feature, Unit' do
   it_should_behave_like 'a bare bones element', clazz
   it_should_behave_like 'a prepopulated element', clazz
   it_should_behave_like 'a sourced element', clazz
+  it_should_behave_like 'a raw element', clazz
 
   before(:each) do
     @feature = clazz.new
@@ -71,6 +72,17 @@ describe 'Feature, Unit' do
     @feature.contains.should =~ everything
   end
 
+  it 'contains a background only if one is present' do
+    tests = [:test_1, :test_2]
+    background = nil
+    everything = tests
+
+    @feature.background = background
+    @feature.tests = tests
+
+    @feature.contains.should =~ everything
+  end
+
   it 'starts with no background' do
     @feature.background.should == nil
   end

data/spec/unit/outline_unit_spec.rb

@@ -14,6 +14,7 @@ describe 'Outline, Unit' do
   it_should_behave_like 'a prepopulated element', clazz
   it_should_behave_like 'a test element', clazz
   it_should_behave_like 'a sourced element', clazz
+  it_should_behave_like 'a raw element', clazz
 
 
   it 'can be parsed from stand alone text' do

data/spec/unit/raw_element_unit_specs.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+shared_examples_for 'a raw element' do |clazz|
+
+  before(:each) do
+    @element = clazz.new
+  end
+
+  it 'has an underlying implementation representation - #raw_element' do
+    @element.should respond_to(:raw_element)
+  end
+
+  it 'can get and set its underlying implementation representation - #raw_element, #raw_element=' do
+    @element.raw_element = :some_raw_element
+    @element.raw_element.should == :some_raw_element
+    @element.raw_element = :some_other_raw_element
+    @element.raw_element.should == :some_other_raw_element
+  end
+
+  it 'starts with no underlying implementation representation' do
+    @element.raw_element.should == nil
+  end
+
+end

data/spec/unit/raw_unit_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Raw') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Raw, Unit' do
+
+  nodule = CucumberAnalytics::Raw
+
+  before(:each) do
+    @element = Object.new.extend(nodule)
+  end
+
+
+  it 'has a raw element - #raw_element' do
+    @element.should respond_to(:raw_element)
+  end
+
+  it 'can get and set its raw element - #raw_element, #raw_element=' do
+    @element.raw_element = :some_raw_element
+    @element.raw_element.should == :some_raw_element
+    @element.raw_element = :some_other_raw_element
+    @element.raw_element.should == :some_other_raw_element
+  end
+
+end

data/spec/unit/row_unit_spec.rb

@@ -10,6 +10,7 @@ describe 'Row, Unit' do
   it_should_behave_like 'a bare bones element', clazz
   it_should_behave_like 'a prepopulated element', clazz
   it_should_behave_like 'a sourced element', clazz
+  it_should_behave_like 'a raw element', clazz
 
   it 'can be parsed from stand alone text' do
     source = '| a | row |'

data/spec/unit/scenario_unit_spec.rb

@@ -14,6 +14,7 @@ describe 'Scenario, Unit' do
   it_should_behave_like 'a prepopulated element', clazz
   it_should_behave_like 'a test element', clazz
   it_should_behave_like 'a sourced element', clazz
+  it_should_behave_like 'a raw element', clazz
 
   it 'can be parsed from stand alone text' do
     source = 'Scenario: '