[prev in list] [next in list] [prev in thread] [next in thread] 

List:       groovy-dev
Subject:    Re: [groovy-dev] pubic api polish for RC1
From:       Franck Rasolo <fraz () codehaus ! org>
Date:       2006-02-17 23:03:43
Message-ID: 20060217230343.15091.qmail () web53311 ! mail ! yahoo ! com
[Download RAW message or body]

I agree, your suggestions make sense.

--- Dierk Koenig <dierk.koenig@canoo.com> wrote:

> Hiall,
> 
> I guess the agreement is that we will not change the public
> API after RC1 anymore.
> Therefore, the current timeframe is kind of the last chance
> to iron out some of the wrinkles.
> 
> One name that I particularly dislike is
>  size()
> that should be named
>  getSize()
> to allow property access via
>  size
> .
> 
> BTW: the GroovyTestCase methods should not be named
> assertLength() but assertSize().
> Also: shouldFail() is better named assertFails().
> 
> All these changes are simple to do but will of course
> break a lot of code out there. 
> Anyway, I would not like to carry them beyond Groovy-1.0.
> 
> My suggestion is to implement the new versions and make the
> old ones throw a DeprecationException('renamed to xxx').
> Every such method is no longer considered part of the
> public API.
> 
> Before 1.0-final, we can safely remove them by searching
> for usage of DeprecationException.
> 
> Who agrees, who has better suggestions ?
> Mittie




Franck Rasolo
Independent Consultant
BeanLab Ltd - London, UK
E-mail franck@beanlab.com
Mobile 07990 505 564

[prev in list] [next in list] [prev in thread] [next in thread]