commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: [csv] CSVFormat API names
Date Tue, 16 Oct 2012 23:14:15 GMT
On 16 October 2012 21:00, Gary Gregory <garydgregory@gmail.com> wrote:
> On Tue, Oct 16, 2012 at 3:38 PM, James Carman <james@carmanconsulting.com>wrote:
>
>> On Tue, Oct 16, 2012 at 2:25 PM, Gary Gregory <garydgregory@gmail.com>
>> wrote:
>> >
>> > I did not do this one as is it seems RFC4180 defines CR+LF as the record
>> > separator as noted in the Javadoc for
>> > org.apache.commons.csv.CSVFormat.DEFAULT.
>> >
>>
>> That's where the name of this component gets confusing to me.  Since
>> it's called "CSV", it would make sense that we follow RFC 4180, which
>> defines the standard for comma-separated value files and thus the
>> default record separator would be CRLF.  However, we are allowing
>> users to define whatever format they want using properties of the
>> CSVFormat class (of course, if you use delimiter != ',', then it's not
>> really CSV).  So, what's the intent?  This is more of a
>> delimited-record format parser/writer component which supports CSV.
>> Thus, it is not really very well-named.

CSV could stand for Character Separated Variables.

Although CSV usually means comma-separated, I think it is treated as a
generic name sufficiently often that the it is not likely to be a big
problem.

The difficulty with all the other names is that they are not at all well known.

>>
>
> Why not rename DEFAULT to RFC418?

I agree that DEFAULT is a poor name, but could not get agreement to
change it previously.

There is already an RFC4180; DEFAULT is RFC4180 + allow blank lines.

> Gary
>
>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> JUnit in Action, 2nd Ed: <http://goog_1249600977>http://bit.ly/ECvg0
> Spring Batch in Action: <http://s.apache.org/HOq>http://bit.ly/bqpbCK
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message