Contents

require 'cucumber/core/ast/describes_itself'
module Cucumber
  module Core
    module Ast
      # Represents an inline argument in a step. Example:
      #
      #   Given the message
      #     """
      #     I like
      #     Cucumber sandwich
      #     """
      #
      # The text between the pair of <tt>"""</tt> is stored inside a DocString,
      # which is yielded to the StepDefinition block as the last argument.
      #
      # The StepDefinition can then access the String via the #to_s method. In the
      # example above, that would return: <tt>"I like\nCucumber sandwich"</tt>
      #
      # Note how the indentation from the source is stripped away.
      #
      class DocString
        include HasLocation
        include DescribesItself
        attr_accessor :file

        attr_reader :content_type, :content

        def initialize(string, content_type, location)
          @content = string
          @content_type = content_type
          @location = location
        end

        def encoding
          @content.encoding
        end

        def to_str
          @content
        end

        def to_s
          to_str
        end

        def gsub(*args)
          @content.gsub(*args)
        end

        def map
          raise ArgumentError, "No block given" unless block_given?
          new_content = yield content
          self.class.new(new_content, content_type, location)
        end

        def to_step_definition_arg
          self
        end

        def ==(other)
          if other.respond_to?(:content_type)
            return false unless content_type == other.content_type
          end
          if other.respond_to?(:to_str)
            return content == other.to_str
          end
          raise ArgumentError, "Can't compare a #{self.class.name} with a #{other.class.name}"
        end

        private

        def description_for_visitors
          :doc_string
        end

      end
    end
  end
end

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
cucumber-core-1.0.0.beta.1	lib/cucumber/core/ast/doc_string.rb
cucumber-core-0.2.0	lib/cucumber/core/ast/doc_string.rb