A parser combinator library inspired by Parsec.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bench
lib
test
.gitignore
.travis.yml
LICENSE
README.md
docs.exs
mix.exs
mix.lock

README.md

ExParsec

Build Status Hex Version Hex Downloads

A parser combinator library inspired by Parsec.

Usage

Add ExParsec as a dependency in your mix.exs file:

def deps do
  [ {:ex_parsec, "~> x.y.z"} ]
end

Replace x.y.z with whatever released version you would like to depend on.

After you are done, run mix deps.get in your shell to fetch and compile ExParsec. Start an interactive Elixir shell with iex -S mix.

iex> import ExParsec.Base; import ExParsec.Text
nil
iex> ExParsec.parse_value "foo", many(any_char())
{:ok, nil, ["f", "o", "o"]}
iex> ExParsec.parse_value "[x]", between(char("["), char("x"), char("]"))
{:ok, nil, "x"}
iex> ExParsec.parse_value "  spa ces  ",
                          sequence([skip(spaces),
                                    times(any_char(), 3),
                                    skip(space),
                                    times(any_char(), 3),
                                    skip(spaces),
                                    eof])
{:ok, nil, [nil, ["s", "p", "a"], nil, ["c", "e", "s"], nil, nil]}

Features

  • Can parse context-sensitive grammars.
  • High-quality, customizable error messages.
  • Full UTF-8 string support.
  • Non-text input such as binary data and tokens.
  • Support for theoretically infinitely large files.
  • Monadic parse blocks based on Elixir macros.
  • Simple, extensible API surface.

Examples