Personally I'd recommend using Python's built-in warnings module and the standard DeprecationWarning and PendingDeprecation warning classes:
http://docs.python.org/library/warnings.html#warning-categories For an example of this in action (outside OpenStack) check out Django's usage here: https://github.com/django/django/blob/stable/1.4.x/django/core/management/sql.py#L99 - Gabriel > -----Original Message----- > From: openstack-bounces+gabriel.hurley=nebula....@lists.launchpad.net > [mailto:openstack- > bounces+gabriel.hurley=nebula....@lists.launchpad.net] On Behalf Of > Kevin L. Mitchell > Sent: Wednesday, August 01, 2012 12:19 PM > To: openstack@lists.launchpad.net > Subject: Re: [Openstack] [glance] legacy client removal and python- > glanceclient > > On Wed, 2012-08-01 at 18:37 +0000, Gabriel Hurley wrote: > > 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 an example of how it can be done properly, check out > https://review.openstack.org/#/c/10577/ (at least, I believe I did it > correctly > ;) > -- > Kevin L. Mitchell <kevin.mitch...@rackspace.com> > > > _______________________________________________ > Mailing list: https://launchpad.net/~openstack > Post to : openstack@lists.launchpad.net > Unsubscribe : https://launchpad.net/~openstack > More help : https://help.launchpad.net/ListHelp _______________________________________________ Mailing list: https://launchpad.net/~openstack Post to : openstack@lists.launchpad.net Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp
