http, attoparsec, pipes and other utilities for the streaming libraries

LTS Haskell 8.5:
Stackage Nightly 2017-03-25:
Latest on Hackage:
BSD3 licensed by michaelt
Maintained by

Module documentation for

This package includes http-client, aeson, attoparsec, zlib and pipes utilities for use with the streaming and streaming bytestring libraries. The modules generally closely follow similarly named modules in the pipes 'ecosystem', using similar function names, where possible.

Thus, for example, using the http client module, we might number the lines of a remote document thus:

import Streaming
import Streaming.Prelude (with, each)
import qualified Streaming.Prelude as S
import Data.ByteString.Streaming.HTTP
import qualified Data.ByteString.Streaming.Char8 as Q

main =  runResourceT $ do
   let output = numbers <|> Q.lines (simpleHTTP "")
   Q.putStrLn $ Q.unlines output

numbers :: Monad m => Stream (Q.ByteString m) m ()
numbers = with (each [1..]) $ \n -> Q.pack (each (show n ++ ".  "))
-- ["1. ", "2. " ..]

The memory requirements of this Prelude-ish program will not be affected by the fact that, say, the third 'line' is 10 terabytes long.

This package of course heaps together a number of dependencies, as it seemed best not to spam hackage with numerous packages. If it seems reasonable to detach some of it, please raise an issue on the github page.

Questions about usage can be raised as issues, or addressed to the pipes list.

comments powered byDisqus