streaming-cassava: Cassava support for the streaming ecosystem

[ data, library, mit, streaming ] [ Propose Tags ]

Stream values to/from CSV using Cassava.

Support is available for both named and "plain" data types, optional header support and option handling.


[Skip to Readme]
Versions 0.1.0.0, 0.1.0.1
Change log ChangeLog.md
Dependencies base (>=4.8 && <5), bytestring, cassava (==0.5.*), mtl, streaming (>=0.1.1.0 && <0.3), streaming-bytestring (<0.2), transformers [details]
License MIT
Copyright Ivan Lazar Miljenovic
Author Ivan Lazar Miljenovic
Maintainer Ivan.Miljenovic@gmail.com
Category Data, Streaming
Source repo head: git clone https://github.com/haskell-streaming/streaming-cassava.git
Uploaded by IvanMiljenovic at Tue Jan 23 04:21:11 UTC 2018
Distributions NixOS:0.1.0.1
Downloads 278 total (16 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2018-01-23 [all 1 reports]
Hackage Matrix CI

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for streaming-cassava-0.1.0.1

[back to package description]

streaming-cassava

Hackage Build Status

cassava support for the streaming ecosystem

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:

withBinaryFileContents \"myFile.csv\" $
  doSomethingWithStreamingCSV
  . 'decodeByName'