streaming-cassava
=================
[](https://hackage.haskell.org/package/streaming-cassava) [](https://travis-ci.org/haskell-streaming/streaming-cassava)
> [cassava] support for the [streaming] ecosystem
[cassava]: http://hackage.haskell.org/package/cassava
[streaming]: http://hackage.haskell.org/package/streaming
This library allows you to easily stream CSV data in and out. You can
do so using both "plain" record-based (with optional header support)
or name-based (header required to determine ordering)
encoding/decoding.
All encoding/decoding options are supported, it's possible to
automatically add on default headers and you can even choose whether
to fail on the first parse error or handle errors on a row-by-row
basis.
Errors with `readFile`
----------------------
A common use-case is to stream CSV-encoded data in from a file. You
may be tempted to use `readFile` from [streaming-bytestring] to obtain
the file contents, but if you do you're likely to run into exceptions
such as `hGetBufSome: illegal operation (handle is closed)`.
The recommended solution is to use the [streaming-with] package for
the IO aspects. You can then write something like:
```haskell
withBinaryFileContents \"myFile.csv\" $
doSomethingWithStreamingCSV
. 'decodeByName'
```
[streaming-bytestring]: https://hackage.haskell.org/package/streaming-bytestring
[streaming-with]: https://hackage.haskell.org/package/streaming-with