/usr/share/pyshared/gevent/util.py is in python-gevent 0.13.6-1ubuntu1.
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 | # Copyright (c) 2009 Denis Bilenko. See LICENSE for details.
__all__ = ['wrap_errors', 'lazy_property']
class wrap_errors(object):
    """Helper to make function return an exception, rather than raise it.
    Because every exception that is unhandled by greenlet will be logged,
    it is desirable to prevent non-error exceptions from leaving a greenlet.
    This can done with simple ``try``/``except`` construct::
        def wrapped_func(*args, **kwargs):
            try:
                return func(*args, **kwargs)
            except (A, B, C), ex:
                return ex
    :class:`wrap_errors` provides a shortcut to write that in one line::
        wrapped_func = wrap_errors((A, B, C), func)
    It also preserves ``__str__`` and ``__repr__`` of the original function.
    """
    # QQQ could also support using wrap_errors as a decorator
    def __init__(self, errors, func):
        """Make a new function from `func', such that it catches `errors' (an
        Exception subclass, or a tuple of Exception subclasses) and return
        it as a value.
        """
        self.errors = errors
        self.func = func
    def __call__(self, *args, **kwargs):
        func = self.func
        try:
            return func(*args, **kwargs)
        except self.errors, ex:
            return ex
    def __str__(self):
        return str(self.func)
    def __repr__(self):
        return repr(self.func)
    def __getattr__(self, item):
        return getattr(self.func, item)
# XXX no longer used anywhere, remove it
class lazy_property(object):
    '''A decorator similar to :meth:`property` that only calls the *function* once.'''
    def __init__(self, function):
        import warnings
        warnings.warn("gevent.util.lazy_propery is deprecated", DeprecationWarning, stacklevel=2)
        self._calculate = function
    def __get__(self, obj, _=None):
        if obj is None:
            return self
        value = self._calculate(obj)
        setattr(obj, self._calculate.func_name, value)
        return value
 |