Flexible and powerful parser combinators for Haskell.
Hectoparsec's main feature is assuming very little about the input and output types of your parsing workflow. This means that it is very flexible, while still providing everything you need to create a powerful parser. In particular, Hectoparsec was originally created in order to support the lexing and parsing workflow more easily than existing parser combinator libraries in Haskell.
- Assumes very little about the type of input stream.
- Allows for custom parser error types and custom parser label types.
- Supports taking multiple tokens from the stream for higher performance.
- Keeps track of parser labels to generate informational error messages.
In addition, Hectoparsec is fairly lightweight. It does not define any general parser combinators, so it is recommended you use the parser-combinators library for that.
There is also no built-in error pretty printing. However, the information to generate pretty errors is generated, and it is recommended you convert it to a pretty error message with the errata library.
Hectoparsec is based on the parsec and megaparsec libraries, but it solves a different problem from them. In particular, they are much more focused on parsing directly from text, and have built-in methods for generating languages and pretty print error messages. If you are looking for a batteries-included parser combinator library, you should prefer one of those two.
If you want to parse directly from text and are looking for performance, incremental parsing, and not pretty error messages, you should take a look attoparsec instead.
There are examples in the examples directory, which includes using parser-combinators for combinators and integration with errata for error pretty-printing.
You can run the examples with cabal run hectoparsec-example-<name>.
Check out the contributing documentation.
Found a bug? Open an issue or a pull request if you can fix it!