RE: [MO-java-dev] dynamic branch and merge

[Vincent M. <vm...@pi...>]

Hi Nat,

> -----Original Message-----
> From: Nat Pryce [mailto:nat...@b1...]
> Sent: 03 July 2003 12:17
> To: Vincent Massol
> Subject: Re: [MO-java-dev] dynamic branch and merge
> 
> I think it will be very hard to provide complete backwards
compatability.
> Changing the dynamock library to use the ActiveCall class will change
the
> Callable method, and thereby change every class that implements or
calls
> Callable.

Just as long as it as the user public API is the same it is fine. BTW,
do we have a strategy so that users know what is public from what is
not?

What I am doing on my new projects is to include the keyword "internal"
for non-public packages. For example:

org.apache.cactus                    <-- public
org.apache.cactus.server             <-- public
org.apache.cactus.internal           <-- non public
org.apache.cactus.internal.server    <-- non public
[...]

[Note: I have taken this from Eclipse]

The strategy is then that we are not allowed to break public APIs
between subsequent releases. However items can be marked as deprecated
and new API introduced. We then keep deprecated classes/methods for at
least 2 releases and we are then free to remove it.

However for internal classes, we are free to change the implementation
whenever we want (of course provided the functional/acceptance tests
still pass).

> 
> If you just use the Mock class and the sugar methods it will be
possible.

Cool. I think I'm only using "terminal" APIs from DynaMock.

> In my branch I renamed some of the classes and sugar methods so that
they
> follow a regular system of names -- I found that less confusing.  I'm
sure
> we can use deprecated and overloaded methods to provide backwards
> compatability here.
> 

excellent.

> For example, instead of "expect" I used "expectVoid" to expect a void
> method.  I used "expect" to expect a user-defined stub.

That's fine, provided we mark the expect method as deprecated and not
remove it for a while.

Thanks 
-Vincent

> 
> Regards,
>             Nat.
> _______________________
> Dr. Nathaniel Pryce
> B13media Ltd.
> http://www.b13media.com
> +44 (0)7712 526 661
> 
> ----- Original Message -----
> From: "Vincent Massol" <vm...@pi...>
> To: "'Moc...@Li...'"
> <moc...@li...>
> Sent: Thursday, July 03, 2003 9:36 AM
> Subject: RE: [MO-java-dev] dynamic branch and merge
> 
> 
> > Is this going to break the DynaMock API from released version 0.09?
> >
> > In any case I believe we should absolutely provide backward
> > compatibility and mark changed methods as deprecated. All new public
> > methods should also be tagged with the "@since" javadoc tag.
> >
> > Thank you
> > -Vincent
> >
> > > -----Original Message-----
> > > From: moc...@li...
> > > [mailto:moc...@li...] On
Behalf Of
> > > Steve Freeman
> > > Sent: 03 July 2003 01:25
> > > To: moc...@li...
> > > Subject: [MO-java-dev] dynamic branch and merge
> > >
> > > folks, given that some people aren't totally happy with nat's
branch,
> > > how about we start implementing the few bits we agree on in the
HEAD?
> > > For example, adding the ActiveCall object. That way we can make
/some/
> > > progress and the merge will be less painful.
> > >
> > > S.
> > >
> > >
> > >
> > >
> > > -------------------------------------------------------
> > > This SF.Net email sponsored by: Free pre-built ASP.NET sites
including
> > > Data Reports, E-commerce, Portals, and Forums are available now.
> > > Download today and enter to win an XBOX or Visual Studio .NET.
> > >
> >
http://aspnet.click-url.com/go/psa00100006ave/direct;at.asp_061203_01/01
> > > _______________________________________________
> > > Mockobjects-java-dev mailing list
> > > Moc...@li...
> > > https://lists.sourceforge.net/lists/listinfo/mockobjects-java-dev
> >
> >
> >
> > -------------------------------------------------------
> > This SF.Net email sponsored by: Free pre-built ASP.NET sites
including
> > Data Reports, E-commerce, Portals, and Forums are available now.
> > Download today and enter to win an XBOX or Visual Studio .NET.
> >
http://aspnet.click-url.com/go/psa00100006ave/direct;at.asp_061203_01/01
> > _______________________________________________
> > Mockobjects-java-dev mailing list
> > Moc...@li...
> > https://lists.sourceforge.net/lists/listinfo/mockobjects-java-dev