# copyright 2003-2015 LOGILAB S.A. (Paris, FRANCE), all rights reserved. # contact http://www.logilab.fr/ -- mailto:contact@logilab.fr # # This file is part of astroid. # # astroid 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. # # astroid 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 astroid. If not, see . # # The code in this file was originally part of logilab-common, licensed under # the same license. import importlib import platform import sys import warnings import lazy_object_proxy import six import wrapt JYTHON = True if platform.python_implementation() == 'Jython' else False try: from functools import singledispatch as _singledispatch except ImportError: from singledispatch import singledispatch as _singledispatch def singledispatch(func): '''Modified singledispatch decorator that doesn't crash on old-style classes. This is a workaround in particular for the Python 2 standard library, because some modules export old-style classes that cause raw_building.py to crash. Old-style classes themselves (not their instances) have no __class__ attribute, so the standard library/backport singledispatch decorator raises an AttributeError. For forward compatibility, in particular for proxy objects like the zipper, the wrapper function tries __class__ first and if that fails, falls back to calling type(), which doesn't raise an exception on old-style classes. This new wrapped function is then used to replace the singledispatch wrapper function, avoiding the overhead of another function call. This will be slightly slower than the standard library/backport function because of the try/except block, but hopefully not enough to matter. ''' old_generic_func = _singledispatch(func) @wrapt.decorator def wrapper(func, instance, args, kws): try: return old_generic_func.dispatch(args[0].__class__)(*args, **kws) except AttributeError: return old_generic_func.dispatch(type(args[0]))(*args, **kws) new_generic_func = wrapper(func) new_generic_func.register = old_generic_func.register new_generic_func.dispatch = old_generic_func.dispatch new_generic_func.registry = old_generic_func.registry new_generic_func._clear_cache = old_generic_func._clear_cache return new_generic_func def lazy_import(module_name): return lazy_object_proxy.Proxy( lambda: importlib.import_module('.' + module_name, 'astroid')) def reraise(exception): '''Reraises an exception with the traceback from the current exception block.''' six.reraise(type(exception), exception, sys.exc_info()[2]) def generate_warning(message, warning): return lambda strings: warnings.warn(message % strings, warning, stacklevel=3) rename_warning = generate_warning("%r is deprecated and slated for removal in " "astroid 2.0, use %r instead", PendingDeprecationWarning) attr_to_method_warning = generate_warning("%s is deprecated and slated for " " removal in astroid 1.6, use the " "method '%s' instead.", PendingDeprecationWarning) @object.__new__ class Uninferable(object): """Special inference object, which is returned when inference fails.""" def __repr__(self): return 'Uninferable' __str__ = __repr__ def __getattribute__(self, name): if name == 'next': raise AttributeError('next method should not be called') if name.startswith('__') and name.endswith('__'): return object.__getattribute__(self, name) if name == 'accept': return object.__getattribute__(self, name) return self def __call__(self, *args, **kwargs): return self def accept(self, visitor): func = getattr(visitor, "visit_uninferable") return func(self) class BadOperationMessage(object): """Object which describes a TypeError occurred somewhere in the inference chain This is not an exception, but a container object which holds the types and the error which occurred. """ class BadUnaryOperationMessage(BadOperationMessage): """Object which describes operational failures on UnaryOps.""" def __init__(self, operand, op, error): self.operand = operand self.op = op self.error = error def __str__(self): operand_type = self.operand.name msg = "bad operand type for unary {}: {}" return msg.format(self.op, operand_type) class BadBinaryOperationMessage(BadOperationMessage): """Object which describes type errors for BinOps.""" def __init__(self, left_type, op, right_type): self.left_type = left_type self.right_type = right_type self.op = op def __str__(self): msg = "unsupported operand type(s) for {}: {!r} and {!r}" return msg.format(self.op, self.left_type.name, self.right_type.name) def _instancecheck(cls, other): wrapped = cls.__wrapped__ other_cls = other.__class__ is_instance_of = wrapped is other_cls or issubclass(other_cls, wrapped) rename_warning((cls.__class__.__name__, wrapped.__name__)) return is_instance_of def proxy_alias(alias_name, node_type): """Get a Proxy from the given name to the given node type.""" proxy = type(alias_name, (lazy_object_proxy.Proxy,), {'__class__': object.__dict__['__class__'], '__instancecheck__': _instancecheck}) return proxy(lambda: node_type) # Backwards-compatibility aliases YES = Uninferable def register_implementation(base): """Register an implementation for the given *base* The given base class is expected to have a `register` method, similar to what `abc.ABCMeta` provides when used. """ def wrapped(impl): base.register(impl) return impl return wrapped