Fastercsv is a project mainly written in Ruby, based on the Unknown, GPL-2.0 licenses found.
A complete replacement for the standard Ruby CSV library
= Read Me
by James Edward Gray II
== Description
Welcome to FasterCSV.
FasterCSV is intended as a replacement to Ruby's standard CSV library. It was designed to address concerns users of that library had and it has three primary goals:
Obviously, the last one is subjective. If you love CSV's interface, odds are good this one won't suit you. I did try to defer to that interface whenever I didn't have a compelling reason to change it though, so hopefully this won't be too radically different.
== What's Different From CSV?
I'm sure I'll miss something, but I'll try to mention most of the major differences I am aware of, to help others quickly get up to speed:
=== CSV Parsing
=== Interface
If you use this library and find yourself missing any functionality I have trimmed, please {let me know}[mailto:[email protected]].
== Documentation
See FasterCSV for documentation.
== Installing
See the INSTALL file for instructions.
== What is CSV, really?
FasterCSV maintains a pretty strict definition of CSV taken directly from {the RFC}[http://www.ietf.org/rfc/rfc4180.txt]. I relax the rules in only one place and that is to make using this library easier. FasterCSV will parse all valid CSV.
What you don't want to do is feed FasterCSV invalid CSV. Because of the way the CSV format works, it's common for a parser to need to read until the end of the file to be sure a field is invalid. This eats a lot of time and memory.
Luckily, when working with invalid CSV, Ruby's built-in methods will almost always be superior in every way. For example, parsing non-quoted fields is as easy as:
data.split(",")
== Questions and/or Comments
Feel free to email {James Edward Gray II}[mailto:[email protected]] with any questions.