parsec 3.1.10 → 3.1.11
raw patch · 3 files changed
+102/−2 lines, 3 filesdep ~basePVP ok
version bump matches the API change (PVP)
Dependency ranges changed: base
API changes (from Hackage documentation)
+ Text.Parsec: infix 0 <?>
+ Text.Parsec: infixr 1 <|>
+ Text.Parsec.Perm: infixl 1 <|?>
+ Text.Parsec.Perm: infixl 2 <$?>
+ Text.Parsec.Prim: infix 0 <?>
+ Text.Parsec.Prim: infixr 1 <|>
+ Text.ParserCombinators.Parsec.Perm: infixl 1 <|?>
+ Text.ParserCombinators.Parsec.Perm: infixl 2 <$?>
+ Text.ParserCombinators.Parsec.Prim: infix 0 <?>
+ Text.ParserCombinators.Parsec.Prim: infixr 1 <|>
Files
- CHANGES +4/−0
- README.md +95/−0
- parsec.cabal +3/−2
CHANGES view
@@ -1,3 +1,7 @@+3.1.11++- Include `README.md` in package.+ 3.1.10 - Most types now have a `Typeable` instance. Some instances are dropped from
+ README.md view
@@ -0,0 +1,95 @@+Parsec [](https://travis-ci.org/aslatter/parsec)+======++A monadic parser combinator library, written by Daan Leijen. Parsec is designed+from scratch as an industrial-strength parser library. It is simple, safe, well+documented, has extensive libraries, good error messages, and is fast.++Some links:++* [Parsec on Hackage](https://hackage.haskell.org/package/parsec),+ contains the generated documentation.+* The 2001 paper written by Daan Leijen, some what outdated+ ([PDF](https://web.archive.org/web/20140528151730/http://legacy.cs.uu.nl/daan/download/parsec/parsec.pdf),+ [HTML](https://web.archive.org/web/20140528151730/http://legacy.cs.uu.nl/daan/download/parsec/parsec.html),+ thanks to [archive.org](http://web.archive.org);+ and [PDF](https://research.microsoft.com/en-us/um/people/daan/download/parsec/parsec.pdf),+ thanks to Microsoft Research).+* [Using Parsec](http://book.realworldhaskell.org/read/using-parsec.html),+ chapter 16 of [Real World Haskell](http://book.realworldhaskell.org/).+* [An introduction to the Parsec library](http://kunigami.wordpress.com/2014/01/21/an-introduction-to-the-parsec-library)+ on Kunigami's blog.+* [An introduction to parsing text in Haskell with Parsec](http://unbui.lt/#!/post/haskell-parsec-basics) on Wilson's blog.+* Differences between Parsec and+ [Attoparsec](http://hackage.haskell.org/package/attoparsec)+ (Haskell's other prominent parser library) as explained in+ [an answer on StackExchange](http://stackoverflow.com/a/19213247).+* Differences between Parsec and [Happy](http://www.haskell.org/happy)+ (Haskell's parser generator) as explained in two+ answers on separate StackExchange questions+ ([1](http://stackoverflow.com/a/7270904),+ [2](http://stackoverflow.com/a/14775331)).++By analyzing [Parsec's reverse dependencies on Hackage](http://packdeps.haskellers.com/reverse/parsec)+we can find open source project that make use of Parsec. For example+[bibtex](http://hackage.haskell.org/package/bibtex),+[ConfigFile](http://hackage.haskell.org/package/ConfigFile),+[csv](http://hackage.haskell.org/package/csv) and+[hjson](http://hackage.haskell.org/package/hjson).+++## Getting started++This requires a working version of `cabal` and `ghci`, which are part of+any modern installation of Haskell, such as+[Haskell Platform](https://www.haskell.org/platform).++First install Parsec.++ cabal install parsec++Below we show how a very simple parser that tests matching parentheses+was made from GHCI (the interactive GHC environment), which we started+with the `ghci` command).++```+Prelude> :m +Text.Parsec+Prelude Text.Parsec> let parenSet = char '(' >> many parenSet >> char ')'+Loading package transformers-0.3.0.0 ... linking ... done.+Loading package array-0.5.0.0 ... linking ... done.+Loading package deepseq-1.3.0.2 ... linking ... done.+Loading package bytestring-0.10.4.0 ... linking ... done.+Loading package mtl-2.1.3.1 ... linking ... done.+Loading package text-1.1.1.3 ... linking ... done.+Loading package parsec-3.1.5 ... linking ... done.+Prelude Text.Parsec> let parens = (many parenSet >> eof) <|> eof+Prelude Text.Parsec> parse parens "" "()"+Right ()+Prelude Text.Parsec> parse parens "" "()(())"+Right ()+Prelude Text.Parsec> parse parens "" "("+Left (line 1, column 2):+unexpected end of input+expecting "(" or ")"+```++The `Right ()` results indicate successes: the parentheses matched.+The `Left [...]` result indicates a parse failure, and is detailed+with an error message.++For a more thorough introduction to Parsec we recommend the links at+the top of this README file.+++## Contributing++Issues (bugs, feature requests or otherwise feedback) may be reported in+[the Github issue tracker for this project](https://github.com/aslatter/parsec/issues).++Pull-requests are also welcome.+++## License++See the [LICENSE](https://github.com/aslatter/parsec/blob/master/LICENSE)+file in the repository.
parsec.cabal view
@@ -1,5 +1,5 @@ name: parsec-version: 3.1.10+version: 3.1.11 cabal-version: >= 1.8 license: BSD3 license-file: LICENSE@@ -17,7 +17,8 @@ and is fast. It is defined as a monad transformer that can be stacked on arbitrary monads, and it is also parametric in the input stream type.-extra-source-files: CHANGES+extra-source-files: CHANGES, README.md+tested-with: GHC==7.10.*, GHC==7.8.*, GHC==7.6.* source-repository head type: git