+-- Module : Data.Attoparsec.Lazy
+-- Copyright : Bryan O'Sullivan 2010
+-- Maintainer : firstname.lastname@example.org
+-- Stability : experimental
+-- Portability : unknown
+-- Simple, efficient combinator parsing for lazy 'ByteString'
+-- strings, loosely based on the Parsec library.
+-- This is essentially the same code as in the 'Data.Attoparsec'
+-- module, only with a 'parse' function that can consume a lazy
+-- 'ByteString' incrementally, and a 'Result' type that does not allow
+-- more input to be fed in. Think of this as suitable for use with a
+-- lazily read file, e.g. via 'L.readFile' or 'L.hGetContents'.
+-- Behind the scenes, strict 'B.ByteString' values are still used
+-- internally to store parser input and manipulate it efficiently.
+-- High-performance parsers such as 'string' still expect strict
+-- 'B.ByteString' parameters.
+ , module Data.Attoparsec
+ -- ** Result conversion
+import Data.ByteString.Lazy.Internal (ByteString(..), chunk)
+import qualified Data.ByteString.Lazy as L
+import qualified Data.ByteString as B
+import qualified Data.Attoparsec as A
+import Data.Attoparsec hiding (Result(..), eitherResult, maybeResult,
+ parse, parseWith, parseTest)
+-- | The result of a parse.
+data Result r = Fail ByteString [String] String
+ -- ^ The parse failed. The 'ByteString' is the input
+ -- that had not yet been consumed when the failure
+ -- occurred. The @[@'String'@]@ is a list of contexts
+ -- in which the error occurred. The 'String' is the
+ -- message describing the error, if any.
+ -- ^ The parse succeeded. The 'ByteString' is the
+ -- input that had not yet been consumed (if any) when
+ -- the parse succeeded.
+instance Show r => Show (Result r) where
+ show (Fail bs stk msg) =
+ "Fail " ++ show bs ++ " " ++ show stk ++ " " ++ show msg
+ show (Done bs r) = "Done " ++ show bs ++ " " ++ show r
+fmapR :: (a -> b) -> Result a -> Result b
+fmapR _ (Fail st stk msg) = Fail st stk msg
+fmapR f (Done bs r) = Done bs (f r)
+instance Functor Result where
+-- | Run a parser and return its result.
+parse :: A.Parser a -> ByteString -> Result a
+ Chunk x xs -> go (A.parse p x) xs
+ empty -> go (A.parse p B.empty) empty
+ go (A.Fail x stk msg) ys = Fail (chunk x ys) stk msg
+ go (A.Done x r) ys = Done (chunk x ys) r
+ go (A.Partial k) (Chunk y ys) = go (k y) ys
+ go (A.Partial k) empty = go (k B.empty) empty
+-- | Run a parser and print its result to standard output.
+parseTest :: (Show a) => A.Parser a -> ByteString -> IO ()
+parseTest p s = print (parse p s)
+-- | Convert a 'Result' value to a 'Maybe' value.
+maybeResult :: Result r -> Maybe r
+maybeResult (Done _ r) = Just r
+-- | Convert a 'Result' value to an 'Either' value.
+eitherResult :: Result r -> Either String r
+eitherResult (Done _ r) = Right r
+eitherResult (Fail _ _ msg) = Left msg