cucumber_analytics 0.0.9 → 1.0.0

data/spec/integration/world_integration_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+SimpleCov.command_name('World') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'World, Integration' do
+
+  before(:each) do
+    @world = CucumberAnalytics::World
+    @world.loaded_step_patterns.clear
+  end
+
+  context 'collecting stuff' do
+
+    before(:each) do
+      @patterns = [/a defined step/, /another defined step/]
+      @defined_steps = [CucumberAnalytics::Step.new('* a defined step'), CucumberAnalytics::Step.new('* another defined step')]
+      @undefined_steps = [CucumberAnalytics::Step.new('* an undefined step'), CucumberAnalytics::Step.new('* another undefined step')]
+
+      @patterns.each do |pattern|
+        @world.load_step_pattern(pattern)
+      end
+    end
+
+    it 'can collect defined steps from containers' do
+      nested_container = double(:steps => @defined_steps)
+      container = double(:steps => @undefined_steps, :contains => [nested_container])
+
+      @defined_steps.should =~ @world.defined_steps_in(container)
+    end
+
+    it 'can collect undefined steps from containers' do
+      nested_container = double(:steps => @defined_steps)
+      container = double(:steps => @undefined_steps, :contains => [nested_container])
+
+      @undefined_steps.should =~ @world.undefined_steps_in(container)
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -1,10 +1,14 @@
-require 'rspec'
-
 require 'simplecov' unless RUBY_VERSION.to_s < '1.9.0'
 
 require "#{File.dirname(__FILE__)}/../lib/cucumber_analytics"
 
-CucumberAnalytics::Logging.set_log_level(Logger::FATAL)
+require "#{File.dirname(__FILE__)}/unit/feature_element_unit_specs"
+require "#{File.dirname(__FILE__)}/unit/nested_element_unit_specs"
+require "#{File.dirname(__FILE__)}/unit/tagged_element_unit_specs"
+require "#{File.dirname(__FILE__)}/unit/containing_element_unit_specs"
+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"
 
 
 DEFAULT_FEATURE_FILE_NAME = 'test_feature.feature'

data/spec/unit/background_unit_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Background') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Background, Unit' do
+
+  clazz = CucumberAnalytics::Background
+
+  it_should_behave_like 'a feature element', clazz
+  it_should_behave_like 'a nested element', clazz
+  it_should_behave_like 'a containing element', clazz
+  it_should_behave_like 'a bare bones element', clazz
+  it_should_behave_like 'a prepopulated element', clazz
+  it_should_behave_like 'a test element', clazz
+
+  it 'can be parsed from stand alone text' do
+    source = 'Background: '
+
+    expect { clazz.new(source) }.to_not raise_error
+  end
+
+end

data/spec/unit/bare_bones_unit_specs.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+shared_examples_for 'a bare bones element' do |clazz|
+
+  before(:each) do
+    @element = clazz.new
+  end
+
+  it 'can be initialized empty' do
+    expect { clazz.new }.to_not raise_error
+  end
+
+end

data/spec/unit/containing_element_unit_specs.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+shared_examples_for 'a containing element' do |clazz|
+
+  before(:each) do
+    @element = clazz.new
+  end
+
+  it 'has children - #contains' do
+    @element.should respond_to(:contains)
+  end
+
+  it 'returns a collection of children - #contains' do
+    @element.contains.is_a?(Array).should be_true
+  end
+
+end

data/spec/unit/directory_unit_spec.rb

@@ -0,0 +1,91 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Directory') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Directory, Unit' do
+
+  clazz = CucumberAnalytics::Directory
+
+  it_should_behave_like 'a nested element', clazz
+  it_should_behave_like 'a containing element', clazz
+  it_should_behave_like 'a bare bones element', clazz
+  it_should_behave_like 'a prepopulated element', clazz
+
+  before(:each) do
+    @directory = clazz.new
+  end
+
+  it 'cannot model a non-existent directory' do
+    path = "#{DEFAULT_FILE_DIRECTORY}/missing_directory"
+
+    expect { CucumberAnalytics::Directory.new(path) }.to raise_error(ArgumentError)
+  end
+
+  it 'knows the name of the directory that it is modeling' do
+    path = "#{DEFAULT_FILE_DIRECTORY}"
+
+    directory = CucumberAnalytics::Directory.new(path)
+
+    directory.name.should == 'temp_files'
+  end
+
+  it 'knows the path of the directory that it is modeling' do
+    path = "#{DEFAULT_FILE_DIRECTORY}"
+
+    directory = CucumberAnalytics::Directory.new(path)
+
+    directory.path.should == path
+  end
+
+  it 'has feature files - #feature_files' do
+    @directory.should respond_to(:feature_files)
+  end
+
+  it 'can get and set its feature files - #feature_files, #feature_files=' do
+    @directory.feature_files = :some_feature_files
+    @directory.feature_files.should == :some_feature_files
+    @directory.feature_files = :some_other_feature_files
+    @directory.feature_files.should == :some_other_feature_files
+  end
+
+  it 'knows how many feature files it has - #feature_file_count' do
+    @directory.feature_files = [:file_1, :file_2, :file_3]
+
+    @directory.feature_file_count.should == 3
+  end
+
+  it 'has directories - #directories' do
+    @directory.should respond_to(:directories)
+  end
+
+  it 'can get and set its directories - #directories, #directories=' do
+    @directory.directories = :some_directories
+    @directory.directories.should == :some_directories
+    @directory.directories = :some_other_directories
+    @directory.directories.should == :some_other_directories
+  end
+
+  it 'knows how many directories it has - #directory_count' do
+    @directory.directories = [:directory_1, :directory_2, :directory_3]
+
+    @directory.directory_count.should == 3
+  end
+
+  it 'starts with no feature files or directories' do
+    @directory.feature_files.should == []
+    @directory.directories.should == []
+  end
+
+  it 'contains feature files and directories' do
+    directories = [:directory_1, :directory_2, :directory_3]
+    files = [:file_1, :file_2, :file_3]
+    everything = files + directories
+
+    @directory.directories = directories
+    @directory.feature_files = files
+
+    @directory.contains.should =~ everything
+  end
+
+end
+

data/spec/unit/doc_string_unit_spec.rb

@@ -0,0 +1,65 @@
+require 'spec_helper'
+
+SimpleCov.command_name('DocString') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'DocString, Unit' do
+
+  clazz = CucumberAnalytics::DocString
+
+  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 'can be parsed from stand alone text' do
+    source = "\"\"\"\nsome doc string\n\"\"\""
+
+    expect { clazz.new(source) }.to_not raise_error
+  end
+
+  before(:each) do
+    @doc_string = clazz.new
+  end
+
+  it 'has a content type - #content_type' do
+    @doc_string.should respond_to(:content_type)
+  end
+
+  it 'can get and set its content type - #content_type, #content_type=' do
+    @doc_string.content_type = :some_content_type
+    @doc_string.content_type.should == :some_content_type
+    @doc_string.content_type = :some_other_content_type
+    @doc_string.content_type.should == :some_other_content_type
+  end
+
+  it 'starts with no content type' do
+    @doc_string.content_type.should == nil
+  end
+
+  it 'has contents - #contents' do
+    @doc_string.should respond_to(:contents)
+  end
+
+  it 'can get and set its contents - #contents, #contents=' do
+    @doc_string.contents = :some_contents
+    @doc_string.contents.should == :some_contents
+    @doc_string.contents = :some_other_contents
+    @doc_string.contents.should == :some_other_contents
+  end
+
+  it 'starts with no contents' do
+    @doc_string.contents.should == []
+  end
+
+  it 'stores its contents as an array of strings' do
+    source = "\"\"\"\nsome text\nsome more text\n\"\"\""
+    doc_string = CucumberAnalytics::DocString.new(source)
+
+    contents = doc_string.contents
+
+    contents.is_a?(Array).should be_true
+    contents.each do |line|
+      line.is_a?(String).should be_true
+    end
+  end
+
+end

data/spec/unit/example_unit_spec.rb

@@ -0,0 +1,171 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Example') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Example, Unit' do
+
+  clazz = CucumberAnalytics::Example
+
+  it_should_behave_like 'a feature element', clazz
+  it_should_behave_like 'a nested element', clazz
+  it_should_behave_like 'a tagged element', clazz
+  it_should_behave_like 'a bare bones element', clazz
+  it_should_behave_like 'a prepopulated element', clazz
+
+
+  it 'can be parsed from stand alone text' do
+    source = ['Examples: ',
+              '|param| ']
+
+    source = source.join("\n")
+
+    expect { clazz.new(source) }.to_not raise_error
+  end
+
+
+  before(:each) do
+    @example = clazz.new
+  end
+
+
+  it 'has parameters - #parameters' do
+    @example.should respond_to(:parameters)
+  end
+
+  it 'can get and set its parameters - #parameters, #parameters=' do
+    @example.parameters = :some_parameters
+    @example.parameters.should == :some_parameters
+    @example.parameters = :some_other_parameters
+    @example.parameters.should == :some_other_parameters
+  end
+
+  it 'starts with no parameters' do
+    @example.parameters.should == []
+  end
+
+  it 'has rows - #rows' do
+    @example.should respond_to(:rows)
+  end
+
+  it 'can get and set its rows - #rows, #rows=' do
+    @example.rows = :some_rows
+    @example.rows.should == :some_rows
+    @example.rows = :some_other_rows
+    @example.rows.should == :some_other_rows
+  end
+
+  it 'starts with no rows' do
+    @example.rows.should == []
+  end
+
+  it 'stores its rows as an nested array of hashes' do
+    source = "Examples:\n|param1|param2|\n|value1|value2|"
+    example = CucumberAnalytics::Example.new(source)
+
+    rows = example.rows
+
+    rows.is_a?(Array).should be_true
+    rows.empty?.should be_false
+    rows.each { |row| row.is_a?(Hash).should be_true }
+  end
+
+  it 'does not include the parameter row as a row' do
+    source = "Examples:\n|param1|param2|\n|value1|value2|\n|value3|value4|"
+    example = CucumberAnalytics::Example.new(source)
+
+    rows = example.rows
+
+    rows.collect { |row| row.values }.should == [['value1', 'value2'], ['value3', 'value4']]
+  end
+
+  context '#add_row' do
+
+    it 'can add a new example row' do
+      clazz.new.should respond_to(:add_row)
+    end
+
+    it 'can add a new row as a hash' do
+      source = "Examples:\n|param1|param2|\n|value1|value2|"
+      example = CucumberAnalytics::Example.new(source)
+
+      new_row = {'param1' => 'value3', 'param2' => 'value4'}
+      example.add_row(new_row)
+
+      example.rows.collect { |row| row.values }.should == [['value1', 'value2'], ['value3', 'value4']]
+    end
+
+    it 'can add a new row as an array' do
+      source = "Examples:\n|param1|param2|\n|value1|value2|"
+      example = CucumberAnalytics::Example.new(source)
+
+      new_row = ['value3', 'value4']
+      example.add_row(new_row)
+
+      example.rows.collect { |row| row.values }.should == [['value1', 'value2'], ['value3', 'value4']]
+    end
+
+    it 'can only use a Hash or an Array to add a new row' do
+      expect { @example.add_row({}) }.to_not raise_error
+      expect { @example.add_row([]) }.to_not raise_error
+      expect { @example.add_row(:a_row) }.to raise_error(ArgumentError)
+    end
+
+    it 'trims whitespace from added rows' do
+      source = "Examples:\n|param1|param2|\n|value1|value2|"
+      example = CucumberAnalytics::Example.new(source)
+
+      hash_row = {'param1' => 'value3  ', 'param2' => '  value4'}
+      array_row = ['value5', ' value6 ']
+      example.add_row(hash_row)
+      example.add_row(array_row)
+
+      example.rows.collect { |row| row.values }.should == [['value1', 'value2'], ['value3', 'value4'], ['value5', 'value6']]
+    end
+  end
+
+  context '#remove_row' do
+
+    it 'can remove an existing example row' do
+      clazz.new.should respond_to(:remove_row)
+    end
+
+    it 'can remove an existing row as a hash' do
+      source = "Examples:\n|param1|param2|\n|value1|value2|\n|value3|value4|"
+      example = CucumberAnalytics::Example.new(source)
+
+      old_row = {'param1' => 'value3', 'param2' => 'value4'}
+      example.remove_row(old_row)
+
+      example.rows.collect { |row| row.values }.should == [['value1', 'value2']]
+    end
+
+    it 'can remove an existing row as an array' do
+      source = "Examples:\n|param1|param2|\n|value1|value2|\n|value3|value4|"
+      example = CucumberAnalytics::Example.new(source)
+
+      old_row = ['value3', 'value4']
+      example.remove_row(old_row)
+
+      example.rows.collect { |row| row.values }.should == [['value1', 'value2']]
+    end
+
+    it 'can only use a Hash or an Array to remove an existing row' do
+      expect { @example.remove_row({}) }.to_not raise_error
+      expect { @example.remove_row([]) }.to_not raise_error
+      expect { @example.remove_row(:a_row) }.to raise_error(ArgumentError)
+    end
+
+    it 'trims whitespace from removed rows' do
+      source = "Examples:\n|param1|param2|\n|value1|value2|\n|value3|value4|\n|value5|value6|"
+      example = CucumberAnalytics::Example.new(source)
+
+      hash_row = {'param1' => 'value3  ', 'param2' => '  value4'}
+      array_row = ['value5', ' value6 ']
+      example.remove_row(hash_row)
+      example.remove_row(array_row)
+
+      example.rows.collect { |row| row.values }.should == [['value1', 'value2']]
+    end
+  end
+
+end

data/spec/unit/feature_element_unit_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+SimpleCov.command_name('FeatureElement') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'FeatureElement, Unit' do
+
+  clazz = CucumberAnalytics::FeatureElement
+
+  it_should_behave_like 'a feature element', clazz
+  it_should_behave_like 'a nested element', clazz
+  it_should_behave_like 'a prepopulated element', clazz
+  it_should_behave_like 'a bare bones element', clazz
+
+
+  before(:each) do
+    @element = clazz.new
+  end
+
+end

data/spec/unit/feature_element_unit_specs.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+shared_examples_for 'a feature element' do |clazz|
+
+  before(:each) do
+    @element = clazz.new
+  end
+
+  it 'has a name - #name' do
+    @element.should respond_to(:name)
+  end
+
+  it 'can get and set its name - #name, #name=' do
+    @element.name = :some_name
+    @element.name.should == :some_name
+    @element.name = :some_other_name
+    @element.name.should == :some_other_name
+  end
+
+  it 'has a description - #description' do
+    @element.should respond_to(:description)
+  end
+
+  it 'can get and set its description - #description, #description=' do
+    @element.description = :some_description
+    @element.description.should == :some_description
+    @element.description = :some_other_description
+    @element.description.should == :some_other_description
+  end
+
+  it 'starts with no name' do
+    @element.name.should == ''
+  end
+
+  it 'starts with no description' do
+    @element.description.should == []
+  end
+
+end

data/spec/unit/feature_file_unit_spec.rb

@@ -0,0 +1,82 @@
+require 'spec_helper'
+
+SimpleCov.command_name('FeatureFile') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'FeatureFile, Unit' do
+
+  clazz = CucumberAnalytics::FeatureFile
+
+  it_should_behave_like 'a nested element', clazz
+  it_should_behave_like 'a containing element', clazz
+  it_should_behave_like 'a bare bones element', clazz
+  it_should_behave_like 'a prepopulated element', clazz
+
+
+  before(:each) do
+    @feature_file = clazz.new
+  end
+
+  it 'cannot model a non-existent directory' do
+    path = "#{DEFAULT_FILE_DIRECTORY}/missing_file.txt"
+
+    expect { CucumberAnalytics::FeatureFile.new(path) }.to raise_error(ArgumentError)
+  end
+
+  it 'knows the name of the file that it is modeling' do
+    path = "#{DEFAULT_FILE_DIRECTORY}/#{DEFAULT_FEATURE_FILE_NAME}"
+    File.open(path, "w") {}
+
+    feature = CucumberAnalytics::FeatureFile.new(path)
+
+    feature.name.should == DEFAULT_FEATURE_FILE_NAME
+  end
+
+  it 'knows the path of the file that it is modeling' do
+    path = "#{DEFAULT_FILE_DIRECTORY}/#{DEFAULT_FEATURE_FILE_NAME}"
+    File.open(path, "w") {}
+
+    directory = CucumberAnalytics::FeatureFile.new(path)
+
+    directory.path.should == path
+  end
+
+  it 'has features - #features' do
+    @feature_file.should respond_to(:features)
+  end
+
+  it 'can get and set its features - #features, #features=' do
+    @feature_file.features = :some_features
+    @feature_file.features.should == :some_features
+    @feature_file.features = :some_other_features
+    @feature_file.features.should == :some_other_features
+  end
+
+  it 'knows how many features it has - #feature_count' do
+    @feature_file.features = [:a_feature]
+    @feature_file.feature_count.should == 1
+    @feature_file.features = []
+    @feature_file.feature_count.should == 0
+  end
+
+  it 'starts with no features' do
+    @feature_file.features.should == []
+  end
+
+  it 'contains features' do
+    features = [:a_feature]
+    everything = features
+
+    @feature_file.features = features
+
+    @feature_file.contains.should =~ everything
+  end
+
+  it 'can easily access its sole feature' do
+    @feature_file.features = []
+    @feature_file.feature.should be_nil
+
+    @feature_file.features = [:a_feature]
+    @feature_file.feature.should == :a_feature
+  end
+
+end

data/spec/unit/feature_unit_spec.rb

@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+SimpleCov.command_name('Feature') unless RUBY_VERSION.to_s < '1.9.0'
+
+describe 'Feature, Unit' do
+
+  clazz = CucumberAnalytics::Feature
+
+  it_should_behave_like 'a feature element', clazz
+  it_should_behave_like 'a nested element', clazz
+  it_should_behave_like 'a containing element', clazz
+  it_should_behave_like 'a tagged element', clazz
+  it_should_behave_like 'a bare bones element', clazz
+  it_should_behave_like 'a prepopulated element', clazz
+
+  before(:each) do
+    @feature = clazz.new
+  end
+
+  it 'can be parsed from stand alone text' do
+    source = 'Feature: '
+
+    expect { clazz.new(source) }.to_not raise_error
+  end
+
+  it 'has a background - #background' do
+    @feature.should respond_to(:background)
+  end
+
+  it 'can get and set its background - #background, #background=' do
+    @feature.background = :some_background
+    @feature.background.should == :some_background
+    @feature.background = :some_other_background
+    @feature.background.should == :some_other_background
+  end
+
+  it 'knows whether or not it presently has a background - has_background?' do
+    @feature.background = :a_background
+    @feature.has_background?.should be_true
+    @feature.background = nil
+    @feature.has_background?.should be_false
+  end
+
+  it 'has tests - #tests' do
+    @feature.should respond_to(:tests)
+  end
+
+  it 'can get and set its tests - #tests, #tests=' do
+    @feature.tests = :some_tests
+    @feature.tests.should == :some_tests
+    @feature.tests = :some_other_tests
+    @feature.tests.should == :some_other_tests
+  end
+
+  it 'knows how many tests it has - #test_count' do
+    @feature.tests = []
+    @feature.test_count.should == 0
+    @feature.tests = [:test_1, :test_2]
+    @feature.test_count.should == 2
+  end
+
+  it 'contains backgrounds and tests' do
+    tests = [:test_1, :test_2]
+    background = :a_background
+    everything = [background] + tests
+
+    @feature.background = background
+    @feature.tests = tests
+
+    @feature.contains.should =~ everything
+  end
+
+  it 'starts with no background' do
+    @feature.background.should == nil
+  end
+
+  it 'starts with no tests' do
+    @feature.tests.should == []
+  end
+
+end

data/spec/unit/nested_element_unit_specs.rb

@@ -0,0 +1,24 @@
+require 'spec_helper'
+
+shared_examples_for 'a nested element' do |clazz|
+
+  before(:each) do
+    @nested_element = clazz.new
+  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 'starts with no parent element' do
+    @nested_element.parent_element.should == nil
+  end
+
+end