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: [email protected] > [mailto:openstack- > [email protected]] On Behalf Of > Kevin L. Mitchell > Sent: Wednesday, August 01, 2012 12:19 PM > To: [email protected] > 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 <[email protected]> > > > _______________________________________________ > Mailing list: https://launchpad.net/~openstack > Post to : [email protected] > Unsubscribe : https://launchpad.net/~openstack > More help : https://help.launchpad.net/ListHelp _______________________________________________ Mailing list: https://launchpad.net/~openstack Post to : [email protected] Unsubscribe : https://launchpad.net/~openstack More help : https://help.launchpad.net/ListHelp
