cpython/Lib/lib2to3/fixes/fix_operator.py

"""Fixer for operator functions.

operator.isCallable(obj)       -> hasattr(obj, '__call__')
operator.sequenceIncludes(obj) -> operator.contains(obj)
operator.isSequenceType(obj)   -> isinstance(obj, collections.Sequence)
operator.isMappingType(obj)    -> isinstance(obj, collections.Mapping)
operator.isNumberType(obj)     -> isinstance(obj, numbers.Number)
operator.repeat(obj, n)        -> operator.mul(obj, n)
operator.irepeat(obj, n)       -> operator.imul(obj, n)
"""

# Local imports
from lib2to3 import fixer_base
from lib2to3.fixer_util import Call, Name, String, touch_import


class FixOperator(fixer_base.BaseFix):

    methods = """
              method=('isCallable'|'sequenceIncludes'
                     |'isSequenceType'|'isMappingType'|'isNumberType'
                     |'repeat'|'irepeat')
              """
    obj = "'(' obj=any ')'"
    PATTERN = """
              power< module='operator'
                trailer< '.' %(methods)s > trailer< %(obj)s > >
              |
              power< %(methods)s trailer< %(obj)s > >
              """ % dict(methods=methods, obj=obj)

    def transform(self, node, results):
        method = self._check_method(node, results)
        if method is not None:
            return method(node, results)

    def _sequenceIncludes(self, node, results):
        """operator.contains(%s)"""
        return self._handle_rename(node, results, u"contains")

    def _isCallable(self, node, results):
        """hasattr(%s, '__call__')"""
        obj = results["obj"]
        args = [obj.clone(), String(u", "), String(u"'__call__'")]
        return Call(Name(u"hasattr"), args, prefix=node.prefix)

    def _repeat(self, node, results):
        """operator.mul(%s)"""
        return self._handle_rename(node, results, u"mul")

    def _irepeat(self, node, results):
        """operator.imul(%s)"""
        return self._handle_rename(node, results, u"imul")

    def _isSequenceType(self, node, results):
        """isinstance(%s, collections.Sequence)"""
        return self._handle_type2abc(node, results, u"collections", u"Sequence")

    def _isMappingType(self, node, results):
        """isinstance(%s, collections.Mapping)"""
        return self._handle_type2abc(node, results, u"collections", u"Mapping")

    def _isNumberType(self, node, results):
        """isinstance(%s, numbers.Number)"""
        return self._handle_type2abc(node, results, u"numbers", u"Number")

    def _handle_rename(self, node, results, name):
        method = results["method"][0]
        method.value = name
        method.changed()

    def _handle_type2abc(self, node, results, module, abc):
        touch_import(None, module, node)
        obj = results["obj"]
        args = [obj.clone(), String(u", " + u".".join([module, abc]))]
        return Call(Name(u"isinstance"), args, prefix=node.prefix)

    def _check_method(self, node, results):
        method = getattr(self, "_" + results["method"][0].value.encode("ascii"))
        if callable(method):
            if "module" in results:
                return method
            else:
                sub = (unicode(results["obj"]),)
                invocation_str = unicode(method.__doc__) % sub
                self.warning(node, u"You should use '%s' here." % invocation_str)
        return None