/usr/lib/python2.7/dist-packages/envisage/safeweakref.py is in python-envisage 4.4.0-1.
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 84 85 86 87 88 | """ An implementation of weak references that works for bound methods.
This code is based on the code in the Python Cookbook, but you can call `ref`
for objects that are *not* bound methods too, in which case it just returns a
standard `weakref.ref`.
Weak references to bound methods are cached so that `ref(x) is ref(x)` as for
standard weakrefs, and the `ref` class defined here is therefore intended to be
used as a drop-in replacement for 'weakref.ref'.
"""
# Standard library imports.
import new, weakref
# Because this module is intended as a drop-in replacement for weakref, we
# import everything from that module here (so the user can do things like
# "import safeweakref as weakref" etc).
from weakref import *
class ref(object):
""" An implementation of weak references that works for bound methods. """
# A cache containing the weak references we have already created.
#
# We cache the weak references by the object containing the associated
# bound methods, hence this is a dictionary of dictionaries in the form:-
#
# { bound_method.im_self : { bound_method.im_func : ref } }
#
# This makes sure that when the object is garbage collected, any cached
# weak references are garbage collected too.
_cache = weakref.WeakKeyDictionary()
def __new__(cls, obj, *args, **kw):
""" Create a new instance of the class. """
# If the object is a bound method then either get from the cache, or
# create an instance of *this* class.
if hasattr(obj, 'im_self'):
func_cache = ref._cache.setdefault(obj.im_self, {})
# If we haven't created a weakref to this bound method before, then
# create one and cache it.
self = func_cache.get(obj.im_func)
if self is None:
self = object.__new__(cls, obj, *args, **kw)
func_cache[obj.im_func] = self
# Otherwise, just return a regular weakref (because we aren't
# returning an instance of *this* class our constructor does not get
# called).
else:
self = weakref.ref(obj)
return self
def __init__(self, obj):
""" Create a weak reference to a bound method object.
'obj' is *always* a bound method because in the '__new__' method we
don't return an instance of this class if it is not, and hence this
constructor doesn't get called.
"""
self._cls = obj.im_class
self._fn = obj.im_func
self._ref = weakref.ref(obj.im_self)
return
def __call__(self):
""" Return a strong reference to the object.
Return None if the object has been garbage collected.
"""
obj = self._ref()
if obj is not None:
obj = new.instancemethod(self._fn, obj, self._cls)
return obj
#### EOF ######################################################################
|