Contents

# File: macro_steps.rb
# Purpose: step definitions that help to build macro-steps (i.e. a step that is equivalent to a sequence of steps)



# This step is used to define a macro-step
# Example:
#  Given I define the step "When I [log in as <userid>]" to mean:
#  """
#  Given I landed in the homepage
#  When I click "Sign in"
#  And I fill in "Username" with "<userid>"
#  And I fill in "Password" with "unguessable"
#  And I click "Submit"
#  """
# The regexp has two capturing group: one for the phrase, a second for the terminating colon (:)
Given(/^I define the step "(?:Given|When|Then) I \[((?:[^\\\]]|\\.)+)\](:?)" to mean:$/) do |macro_phrase, colon_capture, template|
  use_table = (colon_capture == ':')
  add_macro(macro_phrase, template, use_table)
end

# This step is used to invoke a simple macro-step
# Example:
#  When I [log in as "guest"]
#
When(/^I \[((?:[^\\\]]|\\.)+)\]$/) do |macro_phrase|
  invoke_macro(macro_phrase)  # This will call the macro with the given phrase
end


# This step is used to invoke a macro-step with a data table argument.
# Example:
#  When I [enter my credentials as]:
#  |userid  |guest      |
#  |password|unguessable|
When(/^I \[([^\]]+)\]:$/) do |macro_phrase, table_argument|
  # Ensure that the second argument is of the correct type
  unless table_argument.kind_of?(Cucumber::Ast::Table)
     raise Macros4Cuke::DataTableNotFound, "This step must have a data table as an argument."
  end

  # This will call the macro with the given phrase.
  # The second argument consists of an array with couples of the kind: [argument name, actual value]
  invoke_macro(macro_phrase, table_argument.raw)
end



# End of file

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
macros4cuke-0.3.00	lib/macro_steps.rb
macros4cuke-0.2.22	lib/macro_steps.rb
macros4cuke-0.2.21	lib/macro_steps.rb
macros4cuke-0.2.20	lib/macro_steps.rb
macros4cuke-0.2.19	lib/macro_steps.rb
macros4cuke-0.2.18	lib/macro_steps.rb