mirror of https://github.com/mrkkrp/megaparsec.git synced 2024-12-24 16:51:38 +03:00

Industrial-strength monadic parser combinator library

Go to file

mrkkrp f9cfe390af various minor changes, renamed functions Among other changes two functions have been renamed: * ‘parseMaybe’ → ‘parse'’ (also added to change log) * ‘putState’ → ‘setState’ (for consistency)		2015-08-20 16:37:52 +06:00
benchmarks	renamed ‘MegaParsec’ → ‘Megaparsec’, close #10	2015-08-01 22:24:45 +06:00
old-tests	major improvements of ‘Text.Megaparsec.Prim’	2015-08-17 21:58:59 +06:00
tests	major improvements of ‘Text.Megaparsec.Prim’	2015-08-17 21:58:59 +06:00
Text	various minor changes, renamed functions	2015-08-20 16:37:52 +06:00
.gitignore	preparatory changes	2015-07-27 15:03:58 +06:00
.travis.yml	better test options for Travis CI	2015-08-09 00:50:29 +06:00
AUTHORS.md	clarify role of Daan Leijen in the project	2015-08-19 23:39:09 +06:00
CHANGELOG.md	various minor changes, renamed functions	2015-08-20 16:37:52 +06:00
LICENSE.md	renamed ‘MegaParsec’ → ‘Megaparsec’, close #10	2015-08-01 22:24:45 +06:00
megaparsec.cabal	derive ‘Monoid’ instance for ‘Hints’	2015-08-20 01:37:58 +06:00
megaparsec.ebal	use two threads for local testing	2015-08-09 00:49:30 +06:00
README.md	refreshed README.md	2015-08-18 02:15:21 +06:00
Setup.hs	Initial import	2008-01-13 17:53:15 +00:00

Megaparsec

Note that this is work in progress.

This is industrial-strength monadic parser combinator library. Megaparsec is a fork of Parsec library originally written by Daan Leijen.

Megaparsec is different from Parsec in the following ways:

Better error messages. We test our error messages using dense QuickCheck tests. Good error messages are just as important for us as correct return values of our parsers. Megaparsec will be especially useful if you write compiler or interpreter for some language.
Some quirks and “buggy features” (as well as plain bugs) of original Parsec are fixed. There is no undocumented surprising stuff in Megaparsec.
Better support for Unicode parsing in Text.Megaparsec.Char.
Megaparsec has more powerful combinators and can parse languages where indentation matters.
Comprehensive QuickCheck test suite covering nearly 100% of our code.
We have benchmarks to detect performance regressions.
Better documentation, with 100% of functions covered, without typos and obsolete information, with working examples. Megaparsec's documentation is well-structured and doesn't contain things useless to end user.
Megaparsec's code is clearer and doesn't contain “magic” found in original Parsec (just look at how Parsec generate error-messages, you can find more in issue #14 of Megaparsec, this is just one example).
Megaparsec looks into the future, it does not contain code that serves for compatibility purposes, it also requires more recent version of base.

Contributing

Issues (bugs, feature requests or otherwise feedback) may be reported in the Github issue tracker for this project.

Pull-requests are also welcome (and yes, they will get attention and will be merged quickly if they are good, we are progressive folks).

Distributed under BSD3 license.