module Cucumber
  # All steps are run in the context of an object that extends this module
  module World
    class << self
      def alias_adverb(adverb)
        alias_method adverb, :__cucumber_invoke
      end
    end
    
    attr_writer :__cucumber_step_mother, :__cucumber_visitor, :__cucumber_current_step

    # Call a step from within a step definition
    def __cucumber_invoke(name, multiline_argument=nil) #:nodoc:
      begin
        step_match = @__cucumber_step_mother.step_match(name)
        step_match.invoke(self, multiline_argument)
      rescue Exception => e
        e.nested! if Undefined === e
        @__cucumber_current_step.exception = e if @__cucumber_current_step
        raise e
      end
    end
    
    def table(text, file=nil, line_offset=0)
      @table_parser ||= Parser::TableParser.new
      @table_parser.parse_or_fail(text.strip, file, line_offset)
    end

    # Output +announcement+ alongside the formatted output.
    # This is an alternative to using Kernel#puts - it will display
    # nicer, and in all outputs (in case you use several formatters)
    #
    # Beware that the output will be printed *before* the corresponding
    # step. This is because the step itself will not be printed until
    # after it has run, so it can be coloured according to its status.
    def announce(announcement)
      @__cucumber_visitor.announce(announcement)
    end

    def pending(message = "TODO")
      if block_given?
        begin
          yield
        rescue Exception => e
          raise Pending.new(message)
        end
        raise Pending.new("Expected pending '#{message}' to fail. No Error was raised. No longer pending?")
      else
        raise Pending.new(message)
      end
    end

    # The default implementation of Object#inspect recursively
    # traverses all instance variables and invokes inspect. 
    # This can be time consuming if the object graph is large.
    #
    # This can cause unnecessary delays when certain exceptions 
    # occur. For example, MRI internally invokes #inspect on an 
    # object that raises a NoMethodError. (JRuby does not do this).
    #
    # A World object can have many references created by the user
    # or frameworks (Rails), so to avoid long waiting times on
    # such errors in World we define it to just return a simple String.
    #
    def inspect
      sprintf("#<%s:0x%x>", self.class, self.object_id)
    end
  end
end