commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Benedikt Ritter <brit...@apache.org>
Subject Re: [csv] type name consistency
Date Fri, 13 Sep 2013 11:22:34 GMT
We never finished the discussion about Quote. I agree with Gary that it's
weird to have Quote as the only class that doesn't have the "CSV" prefix.

I'll change this if nobody objects.

Benedikt


2013/8/7 Gary Gregory <garydgregory@gmail.com>

> On Wed, Aug 7, 2013 at 10:39 AM, sebb <sebbaz@gmail.com> wrote:
>
> > On 7 August 2013 14:15, Gary Gregory <garydgregory@gmail.com> wrote:
> > > On Wed, Aug 7, 2013 at 2:45 AM, Benedikt Ritter <britter@apache.org>
> > wrote:
> > >
> > >> 2013/8/7 Gary Gregory <garydgregory@gmail.com>
> > >>
> > >> > I think we can be done unless other opinions come in...
> > >> >
> > >>
> > >> What about Quote? Do we want to move it to CSVFormat? Makes sense
> > because
> > >> it is really part of a CSVFormat. OTOH CSVFormat.Quote.ALL is more
> > verbose
> > >> then simply Quote.ALL
> > >>
> > >
> > > If we consider an inner class, I think it should be one of:
> > >
> > > CSVFormat.Quote.ALL
> > > CSVQuote.ALL
> > >
> > > It's too weird to leave Quote as the only public name that is not
> > prefixed.
> >
> > CSVLexer is package private.
> > Is this weird?
> > Should it be renamed to Lexer?
> >
>
> I'm OK with that.
>
> Gary
>
> >
> > > Gary
> > >
> > >
> > >>
> > >> >
> > >> > G
> > >> >
> > >> >
> > >> > On Tue, Aug 6, 2013 at 6:57 PM, sebb <sebbaz@gmail.com> wrote:
> > >> >
> > >> > > On 6 August 2013 17:47, Gary Gregory <garydgregory@gmail.com>
> > wrote:
> > >> > > > On Tue, Aug 6, 2013 at 11:27 AM, Benedikt Ritter <
> > britter@apache.org
> > >> >
> > >> > > wrote:
> > >> > > >
> > >> > > >> 2013/8/6 sebb <sebbaz@gmail.com>
> > >> > > >>
> > >> > > >> > On 6 August 2013 15:48, Gary Gregory <garydgregory@gmail.com
> >
> > >> > wrote:
> > >> > > >> > > The class names in [csv] are (pp) means package
private,
> > others
> > >> > are
> > >> > > >> > public
> > >> > > >> > >
> > >> > > >> > > org.apache.commons.csv.Constants (pp)
> > >> > > >> > > org.apache.commons.csv.CSVFormat
> > >> > > >> > > org.apache.commons.csv.CSVLexer
> > >> > > >> >
> > >> > > >> > That is also (pp)
> > >> > > >> >
> > >> > > >> > > org.apache.commons.csv.CSVParser
> > >> > > >> > > org.apache.commons.csv.CSVPrinter
> > >> > > >> > > org.apache.commons.csv.CSVRecord
> > >> > > >> > > org.apache.commons.csv.ExtendedBufferedReader
(pp)
> > >> > > >> > > org.apache.commons.csv.Lexer (pp)
> > >> > > >> > > org.apache.commons.csv.Quote
> > >> > > >> > > org.apache.commons.csv.Token (pp)
> > >> > > >> > >
> > >> > > >> > > So all of the _public_ types except Quote
are prefixed with
> > >> "CSV".
> > >> > > >> > >
> > >> > > >> > > - Should all types be prefixed with "CSV"?
> > >> > > >> > > - Should Quote be renamed to CSVQuote?
> > >> > > >> > >
> > >> > > >> > > - I personally, prefer the prefix "Csv", but
I might be in
> > the
> > >> > > minority
> > >> > > >> > > here.
> > >> > > >> >
> > >> > > >> > Could also rename Lexer as AbstractLexer and then
drop all
> the
> > >> > CSV/Csv
> > >> > > >> > prefixes.
> > >> > > >> >
> > >> > > >> > And/or possibly merge Lexer and CSVLexer.
> > >> > > >> >
> > >> > > >>
> > >> > > >> big +1 from me. There is no need to have a package private
> > abstract
> > >> > base
> > >> > > >> class if we only have one package private implementation.
> > >> > > >>
> > >> > > >
> > >> > > > Sebb just did this work, thank you Sebb!
> > >> > >
> > >> > > I only merged Lexer into CSVLexer.
> > >> > >
> > >> > > The naming issue (if it is one) still remains.
> > >> > >
> > >> > > > Gary
> > >> > > >
> > >> > > >
> > >> > > >>
> > >> > > >>
> > >> > > >> > I think they were separated to make testing alternate
> > >> > implementations
> > >> > > >> > easier.
> > >> > > >> > But it's probably better to just copy all the relevant
> classes
> > if
> > >> we
> > >> > > >> > need to revisit the benchmarks.
> > >> > > >> >
> > >> > > >> > > Gary
> > >> > > >> > >
> > >> > > >> > > --
> > >> > > >> > > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > >> > > >> > > Java Persistence with Hibernate, Second Edition<
> > >> > > >> > http://www.manning.com/bauer3/>
> > >> > > >> > > JUnit in Action, Second Edition <
> > >> http://www.manning.com/tahchiev/
> > >> > >
> > >> > > >> > > Spring Batch in Action <http://www.manning.com/templier/>
> > >> > > >> > > 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
> > >> > > >> >
> > >> > > >> >
> > >> > > >>
> > >> > > >>
> > >> > > >> --
> > >> > > >> http://people.apache.org/~britter/
> > >> > > >> http://www.systemoutprintln.de/
> > >> > > >> http://twitter.com/BenediktRitter
> > >> > > >> http://github.com/britter
> > >> > > >>
> > >> > > >
> > >> > > >
> > >> > > >
> > >> > > > --
> > >> > > > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > >> > > > Java Persistence with Hibernate, Second Edition<
> > >> > > http://www.manning.com/bauer3/>
> > >> > > > JUnit in Action, Second Edition <
> http://www.manning.com/tahchiev/
> > >
> > >> > > > Spring Batch in Action <http://www.manning.com/templier/>
> > >> > > > 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
> > >> > >
> > >> > >
> > >> >
> > >> >
> > >> > --
> > >> > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > >> > Java Persistence with Hibernate, Second Edition<
> > >> > http://www.manning.com/bauer3/>
> > >> > JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> > >> > Spring Batch in Action <http://www.manning.com/templier/>
> > >> > Blog: http://garygregory.wordpress.com
> > >> > Home: http://garygregory.com/
> > >> > Tweet! http://twitter.com/GaryGregory
> > >> >
> > >>
> > >>
> > >>
> > >> --
> > >> http://people.apache.org/~britter/
> > >> http://www.systemoutprintln.de/
> > >> http://twitter.com/BenediktRitter
> > >> http://github.com/britter
> > >>
> > >
> > >
> > >
> > > --
> > > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > > Java Persistence with Hibernate, Second Edition<
> > http://www.manning.com/bauer3/>
> > > JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> > > Spring Batch in Action <http://www.manning.com/templier/>
> > > 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
> >
> >
>
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> Java Persistence with Hibernate, Second Edition<
> http://www.manning.com/bauer3/>
> JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> Spring Batch in Action <http://www.manning.com/templier/>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory
>



-- 
http://people.apache.org/~britter/
http://www.systemoutprintln.de/
http://twitter.com/BenediktRitter
http://github.com/britter

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message