Contents

module Screengem
  #
  # Mixin that allows an actor to perform tasks, ask questions, take actions, and
  # to remember and recall tagged values.
  #
  # Return self for those methods that may be chained in the step definition DSL.
  #
  # The ability to remember and recall values is used to carry state forward from one
  # step definition to another (as the preferred alternative to instance variables).
  #
  # Action, question, and task instances (aka primitives) are configured with:
  #   (1) a reference to the actor that is interacting with the primitive
  #   (2) a reference to the screen instance that hosts accessors to the page objects.
  #
  module Actor
    #
    # Used by an actor to ask one or more questions in a step definition.
    #
    def asks(*questions)
      questions.each do |question|
        question.configure(self, screen)

        next if question.answer

        raise incorrect_answer(question)
      end

      self
    end

    #
    # Used by an actor to perform one or more tasks in a step definition.
    #
    def performs(*tasks)
      tasks.each do |task|
        task.configure(self, screen)

        task.perform
      end

      self
    end

    #
    # Used by an actor to recall a value for the specified tag.
    #
    def recall(tag)
      recollections.fetch(tag)
    end

    #
    # Used by an actor to remember one or more tagged values.
    #
    def remember(facts)
      recollections.merge!(facts)

      self
    end

    #
    # Used by an actor to take one or more actions.
    #
    # Used to implement tasks. Actions do not appear in step definitions.
    #
    def takes_action(*actions)
      actions.each do |action|
        action.configure(self, screen)

        action.execute
      end
    end

    private

    def incorrect_answer(question)
      Screengem::IncorrectAnswer.new(question)
    end

    def recollections
      @recollections ||= ActiveSupport::HashWithIndifferentAccess.new
    end

    def screen
      Screengem::PageReferences.instance
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
screengem-0.3.0	lib/screengem/actor.rb