WplAi.Parser (WPL-AI v2.1.0)

Parser for WPL-AI language.

Builds an AST from tokens produced by the Lexer. Uses recursive descent parsing.

Summary

parse_state()

repair()

parse(source)

Parse WPL-AI source text into an AST.

Parse tokens into an AST (for testing with pre-tokenized input).

@type parse_state() :: %{
  tokens: [WplAi.Lexer.token()],
  pos: non_neg_integer(),
  errors: [WplAi.Errors.ParseError.t()],
  repairs: [repair()]
}

@type repair() :: %{
  :type => atom(),
  :message => String.t(),
  optional(atom()) => any()
}

@spec parse(String.t()) ::
  {:ok, WplAi.AST.Document.t(), [repair()]} | {:error, list()}

Parse WPL-AI source text into an AST.

Returns {:ok, AST.Document.t(), [repair()]} on success, or {:error, errors} on failure.

@spec parse_tokens([WplAi.Lexer.token()]) ::
  {:ok, WplAi.AST.Document.t(), [repair()]} | {:error, list()}

Parse tokens into an AST (for testing with pre-tokenized input).