cucumber_analytics 1.2.0 → 1.3.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MTM1OWIzMGY3Yjk5MTY5ZGUxZmM1ODFlNjJmMTlkZjM2MGNlOTljZA==
+    NzFmZGE0MWM0NzI0MmQ2NWMxYWM3MmI1YWRlMjIwYThjNTAwMWIzZg==
   data.tar.gz: !binary |-
-    OGIxYzY2MWNjMTk2NzMyNjJlMzU2NjgxZjVlNWVlMmQyNDg3NDRiMQ==
+    NDkzOWY5ODZkNjY5MWVhN2Q1ZGViM2VlMTkxN2EyNDY5M2Y0ODA2OQ==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    NGU1ZDU5NDc0NDVkNjAxNmNjZWZmM2RiODE2YzhiNmMyNjE5NGRiMjhjYjQ1
-    YjkwMmJkZWYzMjBmNzUwZTg5ZmE0NmZkMTQ3MGUzZjVmYWRjNDk5MTk3NDUx
-    OWZiNDgxNjU2ZDI0MmJiNjczMmE2OGFmZGI4ZWU1YzkwOTUyYTM=
+    ZGM5Mjc0ZTEwODZlMmViM2I2M2NiYmEzZDM3NzhhNmVkZmI4ZTMwY2IwZjhm
+    N2U1ZDAyYjg0OWJiN2U3ZDM2OTE4MjliM2U1MzdjZmFmM2UyMDFjNjlhNmI2
+    NDQxY2ZmZDUxZjIyMzYzOGU5M2FlYTUxZDFjZWNjYWQ1ZmRlMzE=
   data.tar.gz: !binary |-
-    NjgzZTRiYzU1N2M1ZjIxZWQ2OTJiN2I1MzZlMTNkZjE4YjA5ZjM0NDUxNDRk
-    NmFhYTExNTE4MzYzNTJkNGQ4NGQxZjExYjMzMzZiNjRmZWJlY2NhNThjOTY0
-    YmMzYzRmMThlMTY0YjhkNjczOTk3NjM5MTA1ZWVmYTU5Y2Q4ZDM=
+    ODBjNDRmN2JjOWY3ZGJlYmE0YWI5ZWJhMDkzNzAyMGRlM2IxOTJkMmMyNTk2
+    YjM1NzRiYjkyNzgzZDFiZWRhMGYxZTgzNGY0M2VjYzBiM2Y2MzQ5ZGE5Y2Vk
+    MjU3YTM0NmQ1NmMxYzQ5YzYzZjQ1ZjdjNzY3NjE2NGZiYjlhYTM=

data/History.rdoc

@@ -1,3 +1,8 @@
+=== Version 1.3.0 / 2013-10-02
+
+* Elements now have a convenience method for accessing their ancestor elements.
+
+
 === Version 1.2.0 / 2013-09-01
 
 * Bug fix: nil no longer shows up as a child element of a Feature if the Feature
@@ -81,9 +86,9 @@
 === Version 0.0.3 / 2012-11-10
 
 * 'But' has been added to the list of recognized step keywords (formerly Given,
-When,Then, And, and *).
+  When,Then, And, and *).
 * Bug fix: the number of test cases a feature is considered to contain now
-properly takes into account an outline's example rows.
+  properly takes into account an outline's example rows.
 
 
 === Version 0.0.2 / 2012-11-01

data/README.rdoc

@@ -67,10 +67,10 @@ also discovered that our team is creating several redundant steps that could be
 rewritten into a single, reusable step.
 
 
-===Other usages
-
-https://gist.github.com/enkessler/6408879 - Creating a step lexicon
+=== Other usages
 
+* https://gist.github.com/enkessler/6408879 - Creating a step lexicon
+* https://gist.github.com/enkessler/6519022 - Creating unique identifiers for all test cases
 
 == Contributing
 

data/cucumber_analytics.gemspec

@@ -8,6 +8,8 @@ Gem::Specification.new do |gem|
   gem.summary       = %q{This gem provides an API to programmatically break down Cucumber feature files so that they can be inspected and analyzed in a straightforward manner.}
   gem.homepage      = 'https://github.com/enkessler/cucumber_analytics'
 
+  gem.license       = 'MIT'
+
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})

data/features/modeling/doc_string_modeling.feature

@@ -46,5 +46,6 @@ Feature: Doc String elements can be modeled.
     When the corresponding specifications are run
     Then all of those specifications are met
   Examples:
-    | additional specifications |
-    | doc_string_unit_spec.rb   |
+    | additional specifications      |
+    | doc_string_unit_spec.rb        |
+    | doc_string_integration_spec.rb |

data/features/modeling/tag_modeling.feature

@@ -49,3 +49,4 @@ Feature: Tag elements can be modeled.
   Examples:
     | additional specifications |
     | tag_unit_spec.rb          |
+    | tag_integration_spec.rb   |

data/lib/cucumber_analytics/directory.rb

@@ -5,6 +5,7 @@ module CucumberAnalytics
   class Directory
 
     include Containing
+    include Nested
 
 
     # The FeatureFile objects contained by the Directory
@@ -13,9 +14,6 @@ module CucumberAnalytics
     # The Directory objects contained by the Directory
     attr_accessor :directories
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
 
     # Creates a new Directory object and, if *directory_parsed* is provided,
     # populates the object.

data/lib/cucumber_analytics/doc_string.rb

@@ -5,11 +5,9 @@ module CucumberAnalytics
   class DocString
 
     include Raw
+    include Nested
 
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
     # The content type associated with the doc string
     attr_accessor :content_type
 

data/lib/cucumber_analytics/feature_element.rb

@@ -6,6 +6,7 @@ module CucumberAnalytics
 
     include Sourceable
     include Raw
+    include Nested
 
 
     # The name of the FeatureElement
@@ -14,9 +15,6 @@ module CucumberAnalytics
     # The description of the FeatureElement
     attr_accessor :description
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
 
     # Creates a new FeatureElement object and, if *parsed_element* is provided,
     # populates the object.

data/lib/cucumber_analytics/feature_file.rb

@@ -5,14 +5,12 @@ module CucumberAnalytics
   class FeatureFile
 
     include Containing
+    include Nested
 
 
     # The Feature objects contained by the FeatureFile
     attr_accessor :features
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
 
     # Creates a new FeatureFile object and, if *file_parsed* is provided,
     # populates the object.

data/lib/cucumber_analytics/nested.rb

@@ -0,0 +1,33 @@
+module CucumberAnalytics
+
+  # A mix-in module containing methods used by elements that are nested inside
+  # of other elements.
+
+  module Nested
+
+    # The parent object that contains *self*
+    attr_accessor :parent_element
+
+
+    # Returns the ancestor of *self* that matches the given type.
+    def get_ancestor(ancestor_type)
+      ancestor = self.parent_element
+      target_type = {:directory => Directory,
+                     :feature_file => FeatureFile,
+                     :feature => Feature,
+                     :test => TestElement,
+                     :step => Step,
+                     :example => Example
+      }[ancestor_type]
+
+      raise(ArgumentError, "Unknown ancestor type '#{ancestor_type}'.") if target_type.nil?
+
+      until ancestor.is_a?(target_type) || ancestor.nil?
+        ancestor = ancestor.parent_element
+      end
+
+      ancestor
+    end
+
+  end
+end

data/lib/cucumber_analytics/row.rb

@@ -6,11 +6,9 @@ module CucumberAnalytics
 
     include Sourceable
     include Raw
+    include Nested
 
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
     # The cells that make up the row
     attr_accessor :cells
 

data/lib/cucumber_analytics/step.rb

@@ -7,6 +7,7 @@ module CucumberAnalytics
     include Containing
     include Sourceable
     include Raw
+    include Nested
 
 
     # The step's keyword
@@ -18,9 +19,6 @@ module CucumberAnalytics
     # The step's passed block
     attr_accessor :block
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
     # The step's arguments
     attr_accessor :arguments
 

data/lib/cucumber_analytics/table.rb

@@ -5,11 +5,9 @@ module CucumberAnalytics
   class Table
 
     include Raw
+    include Nested
 
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
     # The contents of the table
     attr_accessor :contents
 

data/lib/cucumber_analytics/tag.rb

@@ -6,11 +6,9 @@ module CucumberAnalytics
 
     include Raw
     include Sourceable
+    include Nested
 
 
-    # The parent object that contains *self*
-    attr_accessor :parent_element
-
     # The name of the Tag
     attr_accessor :name
 

data/lib/cucumber_analytics/version.rb

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

data/lib/cucumber_analytics.rb

@@ -4,6 +4,7 @@ require 'cucumber_analytics/containing'
 require 'cucumber_analytics/taggable'
 require 'cucumber_analytics/raw'
 require 'cucumber_analytics/sourceable'
+require 'cucumber_analytics/nested'
 require 'cucumber_analytics/feature_file'
 require 'cucumber_analytics/directory'
 require 'cucumber_analytics/feature_element.rb'

data/spec/integration/background_integration_spec.rb

@@ -15,4 +15,46 @@ describe 'Background, Integration' do
     step.parent_element.should equal background
   end
 
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature',
+                '',
+                '  Background: Test background',
+                '    * a step:']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/background_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @background = @directory.feature_files.first.features.first.background
+    end
+
+
+    it 'can get its directory' do
+      directory = @background.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @background.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @background.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @background.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
 end

data/spec/integration/directory_integration_spec.rb

@@ -21,4 +21,28 @@ describe 'Directory, Integration' do
     file.parent_element.should equal directory
   end
 
+  context 'getting stuff' do
+
+    before(:each) do
+      nested_directory = "#{@default_file_directory}/nested_directory"
+      FileUtils.mkdir(nested_directory)
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @nested_directory = @directory.directories.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @nested_directory.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @nested_directory.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
 end

data/spec/integration/doc_string_integration_spec.rb

@@ -0,0 +1,66 @@
+require 'spec_helper'
+
+SimpleCov.command_name('DocString') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'DocString, Integration' do
+
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature',
+                '',
+                '  Scenario: Test test',
+                '    * a big step:',
+                '  """',
+                '  a',
+                '  doc',
+                '  string',
+                '  """']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/doc_string_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @doc_string = @directory.feature_files.first.features.first.tests.first.steps.first.block
+    end
+
+
+    it 'can get its directory' do
+      directory = @doc_string.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @doc_string.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @doc_string.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'can get its test' do
+      test = @doc_string.get_ancestor(:test)
+
+      test.name.should == @directory.feature_files.first.features.first.tests.first.name
+    end
+
+    it 'can get its step' do
+      step = @doc_string.get_ancestor(:step)
+
+      step.base.should == @directory.feature_files.first.features.first.tests.first.steps.first.base
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @doc_string.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
+end

data/spec/integration/example_integration_spec.rb

@@ -20,4 +20,54 @@ describe 'Example, Integration' do
     tag.parent_element.should equal example
   end
 
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature',
+                '',
+                '  Scenario Outline: Test test',
+                '    * a step',
+                '  Examples: Test example',
+                '    | a param |']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/example_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @example = @directory.feature_files.first.features.first.tests.first.examples.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @example.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @example.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @example.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'can get its test' do
+      test = @example.get_ancestor(:test)
+
+      test.name.should == @directory.feature_files.first.features.first.tests.first.name
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @example.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
 end

data/spec/integration/feature_file_integration_spec.rb

@@ -17,4 +17,28 @@ describe 'FeatureFile, Integration' do
     feature.parent_element.should equal file
   end
 
+  context 'getting stuff' do
+
+    before(:each) do
+      file_path = "#{@default_file_directory}/feature_file_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write('Feature: Test feature') }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @feature_file = @directory.feature_files.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @feature_file.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @feature_file.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
 end

data/spec/integration/feature_integration_spec.rb

@@ -86,4 +86,38 @@ describe 'Feature, Integration' do
     feature_2.test_case_count.should == 3
   end
 
+
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/feature_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @feature = @directory.feature_files.first.features.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @feature.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @feature.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      test = @feature.get_ancestor(:test)
+
+      test.should be_nil
+    end
+
+  end
 end

data/spec/integration/outline_integration_spec.rb

@@ -22,4 +22,49 @@ describe 'Outline, Integration' do
     tag.parent_element.should equal outline
   end
 
+
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature',
+                '',
+                '  Scenario Outline: Test test',
+                '    * a step',
+                '  Examples: Test example',
+                '    | a param |']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/outline_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @outline = @directory.feature_files.first.features.first.tests.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @outline.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @outline.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @outline.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      test = @outline.get_ancestor(:test)
+
+      test.should be_nil
+    end
+
+  end
 end

data/spec/integration/scenario_integration_spec.rb

@@ -18,4 +18,47 @@ describe 'Scenario, Integration' do
     tag.parent_element.should equal scenario
   end
 
+
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature',
+                '',
+                '  Scenario: Test test',
+                '    * a step']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/scenario_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @scenario = @directory.feature_files.first.features.first.tests.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @scenario.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @scenario.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @scenario.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      test = @scenario.get_ancestor(:test)
+
+      test.should be_nil
+    end
+
+  end
 end

data/spec/integration/step_integration_spec.rb

@@ -62,55 +62,103 @@ describe 'Step, Integration' do
   end
 
   it 'can determine its equality with another Step' do
-      source_1 = "Given a test step with *parameter 1* and *parameter 2*\n|a block|"
-      source_2 = "Given a test step with *parameter 3* and *parameter 4*\n|another block|"
-      source_3 = 'Given a different *parameterized* step'
+    source_1 = "Given a test step with *parameter 1* and *parameter 2*\n|a block|"
+    source_2 = "Given a test step with *parameter 3* and *parameter 4*\n|another block|"
+    source_3 = 'Given a different *parameterized* step'
 
-      step_1 = CucumberAnalytics::Step.new(source_1)
-      step_2 = CucumberAnalytics::Step.new(source_2)
-      step_3 = CucumberAnalytics::Step.new(source_3)
+    step_1 = CucumberAnalytics::Step.new(source_1)
+    step_2 = CucumberAnalytics::Step.new(source_2)
+    step_3 = CucumberAnalytics::Step.new(source_3)
 
-      step_1.delimiter = '*'
-      step_2.delimiter = '*'
-      step_3.delimiter = '*'
+    step_1.delimiter = '*'
+    step_2.delimiter = '*'
+    step_3.delimiter = '*'
 
 
-      (step_1 == step_2).should be_true
-      (step_1 == step_3).should be_false
+    (step_1 == step_2).should be_true
+    (step_1 == step_3).should be_false
   end
 
   context '#step_text ' do
 
-      before(:each) do
-        source = "Given a test step with -parameter 1- ^and@ *parameter 2!!\n|a block|"
-        @step = CucumberAnalytics::Step.new(source)
-      end
+    before(:each) do
+      source = "Given a test step with -parameter 1- ^and@ *parameter 2!!\n|a block|"
+      @step = CucumberAnalytics::Step.new(source)
+    end
 
 
-      it 'returns the step\'s entire text by default' do
-        source = "Given a test step with -parameter 1- ^and@ *parameter 2!!\n|a block|"
-        step_with_block = CucumberAnalytics::Step.new(source)
+    it 'returns the step\'s entire text by default' do
+      source = "Given a test step with -parameter 1- ^and@ *parameter 2!!\n|a block|"
+      step_with_block = CucumberAnalytics::Step.new(source)
 
-        expected_output = ['Given a test step with -parameter 1- ^and@ *parameter 2!!',
-                           '|a block|']
+      expected_output = ['Given a test step with -parameter 1- ^and@ *parameter 2!!',
+                         '|a block|']
 
-        step_with_block.step_text.should == expected_output
+      step_with_block.step_text.should == expected_output
 
-        source = 'Given a test step with -parameter 1- ^and@ *parameter 2!!'
-        step_without_block = CucumberAnalytics::Step.new(source)
+      source = 'Given a test step with -parameter 1- ^and@ *parameter 2!!'
+      step_without_block = CucumberAnalytics::Step.new(source)
 
-        expected_output = ['Given a test step with -parameter 1- ^and@ *parameter 2!!']
+      expected_output = ['Given a test step with -parameter 1- ^and@ *parameter 2!!']
 
-        step_without_block.step_text.should == expected_output
-      end
+      step_without_block.step_text.should == expected_output
+    end
 
-      it 'can provide the step\'s text without the keyword' do
-        expected_output = ['a test step with -parameter 1- ^and@ *parameter 2!!',
-                           '|a block|']
+    it 'can provide the step\'s text without the keyword' do
+      expected_output = ['a test step with -parameter 1- ^and@ *parameter 2!!',
+                         '|a block|']
 
-        @step.step_text(with_keywords: false).should == expected_output
-      end
+      @step.step_text(with_keywords: false).should == expected_output
+    end
 
   end
 
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['Feature: Test feature',
+                '',
+                '  Scenario: Test test',
+                '    * a step:']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/step_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @step = @directory.feature_files.first.features.first.tests.first.steps.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @step.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @step.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @step.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'can get its test' do
+      test = @step.get_ancestor(:test)
+
+      test.name.should == @directory.feature_files.first.features.first.tests.first.name
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @step.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
 end

data/spec/integration/tag_integration_spec.rb

@@ -0,0 +1,67 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Tag') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Tag, Integration' do
+
+  context 'getting stuff' do
+
+    before(:each) do
+      source = ['@feature_tag',
+                'Feature: Test feature',
+                '',
+                '  Scenario Outline: Test test',
+                '    * a step',
+                '',
+                '  @example_tag',
+                '  Examples: Test example',
+                '    | a param |']
+      source = source.join("\n")
+
+      file_path = "#{@default_file_directory}/tag_test_file.feature"
+      File.open(file_path, 'w') { |file| file.write(source) }
+
+      @directory = CucumberAnalytics::Directory.new(@default_file_directory)
+      @tag = @directory.feature_files.first.features.first.tests.first.examples.first.tag_elements.first
+      @high_level_tag = @directory.feature_files.first.features.first.tag_elements.first
+    end
+
+
+    it 'can get its directory' do
+      directory = @tag.get_ancestor(:directory)
+
+      directory.path.should == @directory.path
+    end
+
+    it 'can get its feature file' do
+      feature_file = @tag.get_ancestor(:feature_file)
+
+      feature_file.path.should == @directory.feature_files.first.path
+    end
+
+    it 'can get its feature' do
+      feature = @tag.get_ancestor(:feature)
+
+      feature.name.should == @directory.feature_files.first.features.first.name
+    end
+
+    it 'can get its test' do
+      test = @tag.get_ancestor(:test)
+
+      test.name.should == @directory.feature_files.first.features.first.tests.first.name
+    end
+
+    it 'can get its example' do
+      example = @tag.get_ancestor(:example)
+
+      example.name.should == @directory.feature_files.first.features.first.tests.first.examples.first.name
+    end
+
+    it 'returns nil if it does not have the requested type of ancestor' do
+      example = @high_level_tag.get_ancestor(:example)
+
+      example.should be_nil
+    end
+
+  end
+end

data/spec/unit/background_unit_spec.rb

@@ -16,9 +16,12 @@ describe 'Background, Unit' do
   it_should_behave_like 'a raw element', clazz
 
   it 'can be parsed from stand alone text' do
-    source = 'Background: '
+    source = 'Background: test background'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.name.should == 'test background'
   end
 
 end

data/spec/unit/doc_string_unit_spec.rb

@@ -14,7 +14,10 @@ describe 'DocString, Unit' do
   it 'can be parsed from stand alone text' do
     source = "\"\"\"\nsome doc string\n\"\"\""
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.contents.should == ["some doc string"]
   end
 
   before(:each) do

data/spec/unit/example_unit_spec.rb

@@ -17,12 +17,15 @@ describe 'Example, Unit' do
 
 
   it 'can be parsed from stand alone text' do
-    source = ['Examples: ',
+    source = ['Examples: test example',
               '|param| ']
 
     source = source.join("\n")
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.name.should == 'test example'
   end
 
 

data/spec/unit/feature_unit_spec.rb

@@ -20,9 +20,12 @@ describe 'Feature, Unit' do
   end
 
   it 'can be parsed from stand alone text' do
-    source = 'Feature: '
+    source = 'Feature: test feature'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.name.should == 'test feature'
   end
 
   it 'has a background - #background' do

data/spec/unit/nested_element_unit_specs.rb

@@ -10,15 +10,27 @@ shared_examples_for 'a nested element' do |clazz|
     @nested_element.should respond_to(:parent_element)
   end
 
-   it 'can get and set its parent element - #parent_element, #parent_element=' do
-     @nested_element.parent_element = :some_parent_element
-     @nested_element.parent_element.should == :some_parent_element
-     @nested_element.parent_element = :some_other_parent_element
-     @nested_element.parent_element.should == :some_other_parent_element
-   end
+  it 'can get and set its parent element - #parent_element, #parent_element=' do
+    @nested_element.parent_element = :some_parent_element
+    @nested_element.parent_element.should == :some_parent_element
+    @nested_element.parent_element = :some_other_parent_element
+    @nested_element.parent_element.should == :some_other_parent_element
+  end
 
   it 'starts with no parent element' do
     @nested_element.parent_element.should == nil
   end
 
+  it 'has access to its ancestors' do
+    @nested_element.should respond_to(:get_ancestor)
+  end
+
+  it 'gets an ancestor based on type' do
+    (clazz.instance_method(:get_ancestor).arity == 1).should be_true
+  end
+
+  it 'raises and exception if an unknown ancestor type is requested' do
+    expect { @nested_element.get_ancestor(:bad_ancestor_type) }.to raise_exception(ArgumentError)
+  end
+
 end

data/spec/unit/nested_unit_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Nested') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Nested, Unit' do
+
+  nodule = CucumberAnalytics::Nested
+
+  before(:each) do
+    @nested_element = Object.new.extend(nodule)
+  end
+
+
+  it 'has a parent element - #parent_element' do
+    @nested_element.should respond_to(:parent_element)
+  end
+
+  it 'can get and set its parent element - #parent_element, #parent_element=' do
+    @nested_element.parent_element = :some_parent_element
+    @nested_element.parent_element.should == :some_parent_element
+    @nested_element.parent_element = :some_other_parent_element
+    @nested_element.parent_element.should == :some_other_parent_element
+  end
+
+  it 'has access to its ancestors' do
+    @nested_element.should respond_to(:get_ancestor)
+  end
+
+  it 'gets an ancestor based on type' do
+    (nodule.instance_method(:get_ancestor).arity == 1).should be_true
+  end
+
+  it 'raises and exception if an unknown ancestor type is requested' do
+    expect { @nested_element.get_ancestor(:bad_ancestor_type) }.to raise_exception(ArgumentError)
+  end
+
+end

data/spec/unit/outline_unit_spec.rb

@@ -18,9 +18,12 @@ describe 'Outline, Unit' do
 
 
   it 'can be parsed from stand alone text' do
-    source = 'Scenario Outline: '
+    source = 'Scenario Outline: test outline'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.name.should == 'test outline'
   end
 
 

data/spec/unit/row_unit_spec.rb

@@ -15,7 +15,10 @@ describe 'Row, Unit' do
   it 'can be parsed from stand alone text' do
     source = '| a | row |'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.cells.should == ['a', 'row']
   end
 
   before(:each) do

data/spec/unit/scenario_unit_spec.rb

@@ -17,9 +17,12 @@ describe 'Scenario, Unit' do
   it_should_behave_like 'a raw element', clazz
 
   it 'can be parsed from stand alone text' do
-    source = 'Scenario: '
+    source = 'Scenario: test scenario'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.name.should == 'test scenario'
   end
 
   before(:each) do

data/spec/unit/step_unit_spec.rb

@@ -179,9 +179,12 @@ describe 'Step, Unit' do
   end
 
   it 'can be parsed from stand alone text' do
-    source = '* some step'
+    source = '* test step'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.base.should == 'test step'
   end
 
   context '#step_text ' do

data/spec/unit/table_unit_spec.rb

@@ -14,7 +14,10 @@ describe 'Table, Unit' do
   it 'can be parsed from stand alone text' do
     source = '| a table |'
 
-    expect { clazz.new(source) }.to_not raise_error
+    expect { @element = clazz.new(source) }.to_not raise_error
+
+    # Sanity check in case instantiation failed in a non-explosive manner
+    @element.contents.should == [['a table']]
   end
 
   before(:each) do

data/spec/unit/world_unit_spec.rb

@@ -67,7 +67,7 @@ describe 'World, Unit' do
     end
 
     it 'can load step definition files - #load_step_file' do
-      file_path = "#{DEFAULT_FILE_DIRECTORY}/step_file.rb"
+      file_path = "#{@default_file_directory}/step_file.rb"
       patterns = [/a pattern/, /another pattern/]
 
       File.open(file_path, 'w') { |file|
@@ -75,13 +75,14 @@ describe 'World, Unit' do
           file.puts "Given #{pattern.inspect} do end"
         end
       }
+
       @world.load_step_file(file_path)
 
       @world.loaded_step_patterns.should =~ patterns
     end
 
     it 'can handle different step keywords - #load_step_file' do
-      file_path = "#{DEFAULT_FILE_DIRECTORY}/step_file.rb"
+      file_path = "#{@default_file_directory}/step_file.rb"
       patterns = [/given pattern/, /when pattern/, /then pattern/, /and pattern/, /but pattern/]
 
       File.open(file_path, 'w') { |file|
@@ -98,7 +99,7 @@ describe 'World, Unit' do
     end
 
     it 'can handle a variety of declaration structures - #load_step_file' do
-      file_path = "#{DEFAULT_FILE_DIRECTORY}/step_file.rb"
+      file_path = "#{@default_file_directory}/step_file.rb"
       patterns = [/parentheses pattern/, /no parentheses pattern/, /excess whitespace pattern/]
 
       File.open(file_path, 'w') { |file|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cucumber_analytics
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Eric Kessler
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-02 00:00:00.000000000 Z
+date: 2013-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gherkin
@@ -139,6 +139,7 @@ files:
 - lib/cucumber_analytics/feature.rb
 - lib/cucumber_analytics/feature_element.rb
 - lib/cucumber_analytics/feature_file.rb
+- lib/cucumber_analytics/nested.rb
 - lib/cucumber_analytics/outline.rb
 - lib/cucumber_analytics/parsing.rb
 - lib/cucumber_analytics/raw.rb
@@ -154,12 +155,14 @@ files:
 - lib/cucumber_analytics/world.rb
 - spec/integration/background_integration_spec.rb
 - spec/integration/directory_integration_spec.rb
+- spec/integration/doc_string_integration_spec.rb
 - spec/integration/example_integration_spec.rb
 - spec/integration/feature_file_integration_spec.rb
 - spec/integration/feature_integration_spec.rb
 - spec/integration/outline_integration_spec.rb
 - spec/integration/scenario_integration_spec.rb
 - spec/integration/step_integration_spec.rb
+- spec/integration/tag_integration_spec.rb
 - spec/integration/world_integration_spec.rb
 - spec/spec_helper.rb
 - spec/unit/background_unit_spec.rb
@@ -173,6 +176,7 @@ files:
 - spec/unit/feature_file_unit_spec.rb
 - spec/unit/feature_unit_spec.rb
 - spec/unit/nested_element_unit_specs.rb
+- spec/unit/nested_unit_spec.rb
 - spec/unit/outline_unit_spec.rb
 - spec/unit/parsing_unit_spec.rb
 - spec/unit/prepopulated_unit_specs.rb
@@ -191,7 +195,8 @@ files:
 - spec/unit/test_element_unit_specs.rb
 - spec/unit/world_unit_spec.rb
 homepage: https://github.com/enkessler/cucumber_analytics
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -252,12 +257,14 @@ test_files:
 - features/support/transforms.rb
 - spec/integration/background_integration_spec.rb
 - spec/integration/directory_integration_spec.rb
+- spec/integration/doc_string_integration_spec.rb
 - spec/integration/example_integration_spec.rb
 - spec/integration/feature_file_integration_spec.rb
 - spec/integration/feature_integration_spec.rb
 - spec/integration/outline_integration_spec.rb
 - spec/integration/scenario_integration_spec.rb
 - spec/integration/step_integration_spec.rb
+- spec/integration/tag_integration_spec.rb
 - spec/integration/world_integration_spec.rb
 - spec/spec_helper.rb
 - spec/unit/background_unit_spec.rb
@@ -271,6 +278,7 @@ test_files:
 - spec/unit/feature_file_unit_spec.rb
 - spec/unit/feature_unit_spec.rb
 - spec/unit/nested_element_unit_specs.rb
+- spec/unit/nested_unit_spec.rb
 - spec/unit/outline_unit_spec.rb
 - spec/unit/parsing_unit_spec.rb
 - spec/unit/prepopulated_unit_specs.rb