syntax: Syntax descriptions for unified parsing and pretty-printing.

[ data, library, mit ] [ Propose Tags ] [ Report a vulnerability ]

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 Isos and Prisms 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

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

Package maintainers

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]