The conduit package

[Tags:benchmark, library, mit, test]

conduit is a solution to the streaming data problem, allowing for production, transformation, and consumption of streams of data in constant memory. It is an alternative to lazy I/O which guarantees deterministic resource handling, and fits in the same general solution space as enumerator/iteratee and pipes. For a brief tutorial, please see the Data.Conduit module.

Release history:

The internals of the package are now separated to the .Internal module, leaving only the higher-level interface in the advertised API. Internally, switched to a Leftover constructor and slightly tweaked the finalization semantics.
Inspired by the design of the pipes package: we now have a single unified type underlying Source, Sink, and Conduit. This type is named Pipe. There are type synonyms provided for the other three types. Additionally, BufferedSource is no longer provided. Instead, the connect-and-resume operator, $$+, can be used for the same purpose.
ResourceT has been greatly simplified, specialized for IO, and moved into a separate package. Instead of hard-coding ResourceT into the conduit datatypes, they can now live around any monad. The Conduit datatype has been enhanced to better allow generation of streaming output. The SourceResult, SinkResult, and ConduitResult datatypes have been removed entirely.
Instead of storing state in mutable variables, we now use CPS. A Source returns the next Source, and likewise for Sinks and Conduits. Not only does this take better advantage of GHC's optimizations (about a 20% speedup), but it allows some operations to have a reduction in algorithmic complexity from exponential to linear. This also allowed us to remove the Prepared set of types. Also, the State functions (e.g., sinkState) use better constructors for return types, avoiding the need for a dummy state on completion.
BufferedSource is now an abstract type, and has a much more efficient internal representation. The result was a 41% speedup on microbenchmarks (note: do not expect speedups anywhere near that in real usage). In general, we are moving towards BufferedSource being a specific tool used internally as needed, but using Source for all external APIs.
Initial release.


Versions 0.0.0,,, 0.0.1,, 0.0.2, 0.0.3, 0.0.4, 0.1.0, 0.1.1,, 0.2.0, 0.2.1, 0.2.2, 0.3.0, 0.4.0,, 0.4.1,, 0.4.2, 0.5.0, 0.5.1, 0.5.2,,,,,,,, 0.5.3, 0.5.4,,, 0.5.5, 0.5.6, 1.0.0,,, 1.0.1, 1.0.2, 1.0.3, 1.0.4,,, 1.0.5,, 1.0.6, 1.0.7,,,,, 1.0.8, 1.0.9,,,, 1.0.10,, 1.0.11,, 1.0.12, 1.0.13,, 1.0.14, 1.0.15,, 1.0.16, 1.0.17,, 1.1.0,,, 1.1.1,, 1.1.2,, 1.1.3, 1.1.4, 1.1.5, 1.1.6, 1.1.7, 1.2.0,,, 1.2.1, 1.2.2,,, 1.2.3,, 1.2.4,,,, 1.2.5,, 1.2.6,,,,,,, 1.2.7, 1.2.8, 1.2.9,, 1.2.10
Dependencies base (>=4.3 && <4.6), bytestring (>=0.9), containers, lifted-base (==0.1.*), monad-control (>=0.3.1 && <0.4), resourcet (==0.3.*), text (>=0.11), transformers (>=0.2.2 && <0.4), transformers-base (>=0.4.1 && <0.5), void (>=0.5.5 && <0.6) [details]
License BSD3
Author Michael Snoyman
Category Data, Conduit
Home page
Source repository head: git clone git://
Uploaded Mon Jul 16 03:52:00 UTC 2012 by MichaelSnoyman
Updated Mon May 25 18:01:03 UTC 2015 by AdamBergmark to revision 1
Distributions Arch:1.2.10, Debian:, Fedora:1.2.9, FreeBSD:1.2.5, LTSHaskell:1.2.10, NixOS:1.2.10, Stackage:1.2.10, Tumbleweed:
Downloads 194491 total (11343 in the last 30 days)
4 []
Status Docs uploaded by user
Build status unknown [no reports yet]




debugTurn on some runtime check to ensure invariants are respected.EnabledAutomatic

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info


Maintainer's Corner

For package maintainers and hackage trustees