syntax: Syntax descriptions for unified parsing and pretty-printing.
syntax
allows you to write a single syntax description and instantiate is both as a parser and a pretty printer.
The interface is based on a custom Functor/Applicative/Monad hierarchy, provided by the 'semi-iso' package. You fmap using
a semi-isomorphism instead of function. A semi-isomorphism is a isomorphism that can fail in both directions, with slightly
weakened laws. It is worth to note that Iso
s and Prism
s from lens
are valid semi-isomorphisms :)
Once you write a description you can, for example turn it into an Attoparsec parser.
See syntax-example
for an example, 'syntax-attoparsec' and 'syntax-pretty' for a parser/printer implementation.
The library was inspired by:
Rendel, Tillmann, and Klaus Ostermann. "Invertible syntax descriptions: unifying parsing and pretty printing." ACM Sigplan Notices. Vol. 45. No. 11. ACM, 2010.
TODO:
a printer library based on Text/ByteString builders (wrapping
pretty
is inefficient and doesn't use any features of it),try to implement indentation and Haskell layout rule,
combinators for binary data formats, vectors,
implementation of do notation for SemiIsoMonad with QuasiQuoters.
Downloads
- syntax-0.2.1.0.tar.gz [browse] (Cabal source package)
- Package description (revised from the package)
Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
- No Candidates
Versions [RSS] | 0.1.0.0, 0.1.1.0, 0.2.0.0, 0.2.1.0, 0.3.0.0, 1.0.0.0 |
---|---|
Dependencies | base (>=4 && <5), lens (>=4), mono-traversable, scientific (>=0.3), semi-iso (>=0.4.1) [details] |
License | MIT |
Copyright | Paweł Nowak 2014 |
Author | Paweł Nowak |
Maintainer | Paweł Nowak <pawel834@gmail.com> |
Revised | Revision 1 made by pawel834 at 2014-11-24T15:43:23Z |
Category | Data |
Source repo | head: git clone git@github.com:Pawel834/syntax.git |
Uploaded | by pawel834 at 2014-11-24T15:42:16Z |
Distributions | |
Reverse Dependencies | 4 direct, 0 indirect [details] |
Downloads | 5092 total (17 in the last 30 days) |
Rating | (no votes yet) [estimated by Bayesian average] |
Your Rating | |
Status | Docs uploaded by user Build status unknown [no reports yet] |