/usr/share/pyshared/gtk-2.0/gtk/deprecation.py is in python-gtk2 2.24.0-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 | # -*- Mode: Python; py-indent-offset: 4 -*-
# pygtk - Python bindings for the GTK toolkit.
# Copyright (C) 2004-2006 Johan Dahlin
#
# gtk/deprecation.py: deprecation helpers for gtk
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
# USA
import os
import sys
import warnings
from gtk._gtk import DeprecationWarning
def _is_pydoc():
if sys.argv:
name = os.path.basename(sys.argv[0])
if 'pydoc' in name:
return True
return False
class _Deprecated:
def __init__(self, module, funcname, oldname, modulename=''):
self.module = module
self.funcname = funcname
self.oldname = oldname
if modulename:
self.modulename = modulename
else:
self.modulename = 'gtk'
def __repr__(self):
return '<deprecated function %s>' % (self.oldname)
def __call__(self, *args, **kwargs):
if type(self.module) == str:
module = __import__(self.module, {}, {}, ' ')
else:
module = self.module
func = getattr(module, self.funcname)
if not _is_pydoc():
message = 'gtk.%s is deprecated, use %s.%s instead' % (
self.oldname, self.modulename, func.__name__)
# DeprecationWarning is imported from _gtk, so it's not the same
# as the one found in exceptions.
warnings.warn(message, DeprecationWarning, 2)
try:
return func(*args, **kwargs)
except TypeError, e:
raise TypeError(str(e).replace(func.__name__, self.oldname))
class _DeprecatedConstant:
def __init__(self, value, name, suggestion):
self._v = value
self._name = name
self._suggestion = suggestion
def _deprecated(self, value):
if not _is_pydoc():
message = '%s is deprecated, use %s instead' % (self._name,
self._suggestion)
warnings.warn(message, DeprecationWarning, 3)
return value
__nonzero__ = lambda self: self._deprecated(self._v == True)
__int__ = lambda self: self._deprecated(int(self._v))
__str__ = lambda self: self._deprecated(str(self._v))
__repr__ = lambda self: self._deprecated(repr(self._v))
__cmp__ = lambda self, other: self._deprecated(cmp(self._v, other))
|