Module documentation for 0.12.1.2
Welcome to attoparsec
attoparsec is a fast Haskell parser combinator library, aimed particularly at dealing efficiently with network protocols and complicated text/binary file formats.
I’m happy to receive bug reports, fixes, documentation enhancements, and other improvements.
Please report bugs via the github issue tracker.
Master git repository:
git clone git://github.com/bos/attoparsec.git
There’s also a Mercurial mirror:
hg clone https://bitbucket.org/bos/attoparsec
(You can create and contribute changes using either Mercurial or git.)
This library is written and maintained by Bryan O’Sullivan, [email protected].
- Fixed the incorrect tracking of capacity if the initial buffer was empty (https://github.com/bos/attoparsec/issues/75)
- Fixed a data corruption bug that occurred under some circumstances if a buffer grew after prompting for more input (https://github.com/bos/attoparsec/issues/74)
Now compatible with GHC 7.9
Reintroduced the Chunk class, used by the parsers package
A new internal representation makes almost all real-world parsers faster, sometimes by big margins. For example, parsing JSON data with aeson is now up to 70% faster. These performance improvements also come with reduced memory consumption and some new capabilities.
The new match combinator gives both the result of a parse and the input that it matched.
The test suite has doubled in size. This made it possible to switch to the new internal representation with a decent degree of confidence that everything was more or less working.
The benchmark suite now contains a small family of benchmarks taken from real-world uses of attoparsec.
A few types that ought to have been private now are.
A few obsolete modules and functions have been marked as deprecated. They will be removed from the next major release.
- New function scientific is compatible with rational, but parses integers more efficiently (https://github.com/bos/aeson/issues/198)
The new Chunk typeclass allows for some code sharing with Ed Kmett’s parsers package: http://hackage.haskell.org/package/parsers
New function runScanner generalises scan to return the final state of the scanner as well as the input consumed.
New dependency: the scientific package. This allows us to parse numbers much more efficiently.
peekWord8’, peekChar’: new primitive parsers that allow single-character lookahead.