liquid/lib/liquid/parser.rb

module Liquid
  # This class is used by tags to parse themselves
  # it provides helpers and encapsulates state
  class Parser
    def initialize(input)
      l = Lexer.new(input)
      @tokens = l.tokenize
      @p = 0 # pointer to current location
    end

    def jump(point)
      @p = point
    end

    def consume(type = nil)
      token = @tokens[@p]
      if type && token.type != type
        raise SyntaxError, "Expected #{type} but found #{@tokens[@p]}"
      end
      @p += 1
      token.contents
    end

    # Only consumes the token if it matches the type
    # Returns the token's contents if it was consumed
    # or false otherwise.
    def consume?(type)
      token = @tokens[@p]
      return false unless token && token.type == type
      @p += 1
      token.contents
    end

    # Like consume? Except for an :id token of a certain name
    def id?(str)
      token = @tokens[@p]
      return false unless token && token.type == :id
      return false unless token.contents == str
      @p += 1
      token.contents
    end

    def look(type, ahead = 0)
      tok = @tokens[@p + ahead]
      return false unless tok
      tok.type == type
    end

    # === General Liquid parsing functions ===

    def expression
      token = @tokens[@p]
      if token.type == :id
        variable_signature
      elsif [:string, :integer, :float].include? token.type
        consume
        token.contents
      else
        raise SyntaxError, "#{token} is not a valid expression."
      end
    end

    def argument
      str = ""
      # might be a keyword argument (identifier: expression)
      if look(:id) && look(:colon, 1)
        str << consume << consume << ' '
      end

      str << expression
    end

    def variable_signature
      str = consume(:id)
      if look(:open_square)
        str << consume
        str << expression
        str << consume(:close_square)
      end
      if look(:dot)
        str << consume
        str << variable_signature
      end
      str
    end
  end
end