# encoding: utf-8
# File: macro-step_spec.rb

require_relative '../spec_helper'

# The class under test
require_relative '../../lib/macros4cuke/macro-step-support'	


module Macros4Cuke	# Open the module to avoid lengthy qualified names

# Class created just for testing purposes.
class MyWorld
  include Macros4Cuke::MacroStepSupport
  
  # The list of encountered sub-steps
  attr_reader(:substeps)
  
  # Let's mimicks the behaviour of a Cucumber::RbSupport::RbWorld 
  def steps(substep_text)
    @substeps ||= {}
    @substeps << substep_text
  end
  
  
end # class

describe MacroStepSupport do
  # Rule to build a custom world object
  let(:world) { MyWorld.new }
  
  let(:m1_phrase) { 'enter the credentials' }
  
  let(:m1_substeps) do
      ssteps = <<-SNIPPET
  Given I landed in the homepage
  When I click "Sign in"
  And I fill in "Username" with "<userid>"
  And I fill in "Password" with "<password>"
  And I click "Submit"      
SNIPPET
      ssteps
  end  
  
  context 'Defining macro(s):' do
    it 'should add valid new macro' do
      ->(){ world.add_macro(m1_phrase, m1_substeps, true) }.should_not raise_error
    end
    
    it 'should complain when entering the same macro again' do
      # Error case: trying to register another macro with same key/phrase.
      msg = "A macro-step with phrase 'enter the credentials' already exist."
      -> { world.add_macro(m1_phrase, m1_substeps, true) }.should raise_error(
        Macros4Cuke::DuplicateMacroError, msg)
    end
    
    it 'should complain macro uses no table and phrase is parameterless' do
      # Error case: substeps have arguments, 
      # but the macro has no mechanism to pass the needed data.
      phrase = 'fill in the credentials'
      msg = "The sub-step argument 'userid' does not appear in the phrase."
      ->(){ world.add_macro(phrase, m1_substeps, false) }.should raise_error(
        Macros4Cuke::UnreachableSubstepArgument, msg)    
    end
  end # context
  
  context 'Invoking macro(s):' do
  
    it 'should complain when invoking an unknown macro-step' do
      phrase_unknown = 'dream of a perfect world'
      msg = "Unknown macro-step with phrase: 'dream of a perfect world'."
      ->(){ world.invoke_macro(phrase_unknown) }.should raise_error(
        Macros4Cuke::UnknownMacroError, msg)
    end

  end # context  
  
  context 'Clearing macro(s):' do
  
    it 'should clear all macros' do
      ->(){ world.clear_macros() }.should_not raise_error
      
      # Control the post-condition
      MacroCollection.instance.macro_steps.should be_empty
    end  

  end # context

end # describe

end # module


# End of file