Data.Conduit.Zlib
Description
Streaming compression and decompression using conduits.
Parts of this code were taken from zlib-enum and adapted for conduits.
- compress :: (MonadUnsafeIO m, MonadThrow m) => Int -> WindowBits -> Conduit ByteString m ByteString
- decompress :: (MonadUnsafeIO m, MonadThrow m) => WindowBits -> Conduit ByteString m ByteString
- gzip :: (MonadThrow m, MonadUnsafeIO m) => Conduit ByteString m ByteString
- ungzip :: (MonadUnsafeIO m, MonadThrow m) => Conduit ByteString m ByteString
- compressFlush :: (MonadUnsafeIO m, MonadThrow m) => Int -> WindowBits -> Conduit (Flush ByteString) m (Flush ByteString)
- decompressFlush :: (MonadUnsafeIO m, MonadThrow m) => WindowBits -> Conduit (Flush ByteString) m (Flush ByteString)
- data WindowBits = WindowBits Int
- defaultWindowBits :: WindowBits
Conduits
Arguments
| :: (MonadUnsafeIO m, MonadThrow m) | |
| => Int | Compression level |
| -> WindowBits | Zlib parameter (see the zlib-bindings package as well as the zlib C library) |
| -> Conduit ByteString m ByteString |
Compress (deflate) a stream of ByteStrings. The WindowBits also control
the format (zlib vs. gzip).
Arguments
| :: (MonadUnsafeIO m, MonadThrow m) | |
| => WindowBits | Zlib parameter (see the zlib-bindings package as well as the zlib C library) |
| -> Conduit ByteString m ByteString |
Decompress (inflate) a stream of ByteStrings. For example:
sourceFile "test.z" $= decompress defaultWindowBits $$ sinkFile "test"
gzip :: (MonadThrow m, MonadUnsafeIO m) => Conduit ByteString m ByteStringSource
Gzip compression with default parameters.
ungzip :: (MonadUnsafeIO m, MonadThrow m) => Conduit ByteString m ByteStringSource
Gzip decompression with default parameters.
Flushing
Arguments
| :: (MonadUnsafeIO m, MonadThrow m) | |
| => Int | Compression level |
| -> WindowBits | Zlib parameter (see the zlib-bindings package as well as the zlib C library) |
| -> Conduit (Flush ByteString) m (Flush ByteString) |
Same as compress, but allows you to explicitly flush the stream.
Arguments
| :: (MonadUnsafeIO m, MonadThrow m) | |
| => WindowBits | Zlib parameter (see the zlib-bindings package as well as the zlib C library) |
| -> Conduit (Flush ByteString) m (Flush ByteString) |
Same as decompress, but allows you to explicitly flush the stream.
Re-exported from zlib-bindings
data WindowBits
This specifies the size of the compression window. Larger values of this parameter result in better compression at the expense of higher memory usage.
The compression window size is the value of the the window bits raised to
the power 2. The window bits must be in the range 8..15 which corresponds
to compression window sizes of 256b to 32Kb. The default is 15 which is also
the maximum size.
The total amount of memory used depends on the window bits and the
MemoryLevel. See the MemoryLevel for the details.
Constructors
| WindowBits Int |
defaultWindowBits :: WindowBits
The default WindowBits is 15 which is also the maximum size.