Re: replace csv.rb with fastercsv.rb

On Dec 24, 2007, at 5:27 PM, Dave Thomas wrote:

>
> On Dec 24, 2007, at 4:31 PM, NAKAMURA, Hiroshi wrote:
>
>> We can download plain old CSV from
>> http://dev.ctor.org/csv/browser/trunk/lib/csv.rb?format=3Dtxt
>> As far as I know "the core team" does not use csv.rb.  You and I =20
>> are the
>> person who well knows 'how users use csv.rb in ruby' in comitters.  =20=

>> You
>> can help users who will posts compatibility questions to ruby-talk,
>> right?  Go ahead.
>
> James:
>
> Are there any points you'd like me to make about it when I update =20
> the CSV page in PickAxe 3?

Things you may want to point out in the prose:

* It's the FasterCSV code base, renamed to CSV.  Many people are =20
familiar with it.
* The API is almost the same as the old CSV, if you stick to the class =20=

methods of CSV itself.
* The main exception is CSV.open() which now behaves like File.open() =20=

instead of File.foreach().  Use CSV.foreach() if you want foreach() =20
behavior.
* Options are now passed in the Hash argument style, instead of as =20
positional parameters.  So the old CSV.foreach(path, "\r\n") changes =20
to CSV.foreach(path, :row_sep =3D> "\r\n").
* The new library has a lot more features, especially regarding CSV =20
files with a header row.
* The code is fully documented, so users can read up on the changes.

Notes about your existing examples:

* Change open() to foreach() and drop the "r" mode indicator and your =20=

first example runs the same.
* Your second example is where the new library really shines and =20
you'll probably want to rework it to show readers that.  I think you =20
should show the library reading the headers and referring to the =20
columns by name:

   total_cost =3D 0
   CSV.foreach("csvfile_hdr", :headers =3D> true) do |line_item|
     total_cost +=3D line_item["Count"] * line_item["Price"]
   end

* Your third example can be super short using the new code:

   CSV do |csv|
     # =85
   end

That's really a shortcut and if you prefer to show the longhand =20
version it is:

   CSV.instance($stdout) do |csv|
     # =85
   end

New stuff:

The new code has a table feature that might fun to show in an =20
example.  There's an example file in the FasterCSV source that should =20=

give you the feel of how it works:

   http://fastercsv.rubyforge.org/svn/trunk/examples/csv_table.rb

I understand if there just isn't room though.

I hope that helps you make the update.  I'm happy to answer any =20
questions for you as needed, of course.

James Edward Gray II