openstack team mailing list archive

[Gabriel Hurley <Gabriel.Hurley@xxxxxxxxxx>]

As a rule of thumb, we need to start doing proper deprecation on all public interfaces, whether that's a CLI, client method signatures, APIs, etc. It's a little late for this on the old vs. new glance client/CLI (unless Brian feels the work can be reasonably done to make them compatible) but it's something we need to be really mindful of going forward.

As a community we've tacitly made an N+1 promise of compatibility, so changes like this would ideally support both code paths in Folsom and raise a DeprecationWarning on the old one, then be completely removed in Grizzly. If we wanted to be even nicer to people relying on these public interfaces we'd move towards an N+2 timeline and start with a PendingDeprecationWarning in Folsom, escalate to a DeprecationWarning in Grizzly, and finish with complete removal in H***.

All the best,

    - Gabriel

> -----Original Message-----
> From: openstack-bounces+gabriel.hurley=nebula.com@xxxxxxxxxxxxxxxxxxx
> [mailto:openstack-
> bounces+gabriel.hurley=nebula.com@xxxxxxxxxxxxxxxxxxx] On Behalf Of
> Vishvananda Ishaya
> Sent: Wednesday, August 01, 2012 10:35 AM
> To: Brian Waldon
> Cc: openstack@xxxxxxxxxxxxxxxxxxx
> Subject: Re: [Openstack] [glance] legacy client removal and python-
> glanceclient
> 
> 
> On Jul 31, 2012, at 10:09 PM, Brian Waldon <bcwaldon@xxxxxxxxx> wrote:
> >
> > I do agree that this current upgrade story could be better, but how much
> better do you expect it to be and in what specific ways? If the command-line
> interface were backwards-compatibile, would that solve all your problems?
> I'm fine doing that for the v1.0.0 release as long as we can deprecate all the
> old behavior out for a v2.0.0 release. Do you expect the legacy python library
> to get installed with folsom? As a side note, I do want to point out that the
> python module paths do not conflict.
> 
> Legacy compatibility would be a huge win if it is feasible.
> 
> Vish
> 
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to     : openstack@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openstack
> More help   : https://help.launchpad.net/ListHelp