"""Fixer for it.next() -> next(it), per PEP 3114."""
# Things that currently aren't covered:
# - listcomp "next" names aren't warned
# - "with" statement targets aren't checked
from ..pgen2 import token
from ..pygram import python_symbols as syms
from .. import fixer_base
from ..fixer_util import Name, Call, find_binding
bind_warning = "Calls to builtin next() possibly shadowed by global binding"
class FixNext(fixer_base.BaseFix):
power< base=any+ trailer< '.' attr='next' > trailer< '(' ')' > >
power< head=any+ trailer< '.' attr='next' > not trailer< '(' ')' > >
classdef< 'class' any+ ':'
parameters< '(' NAME ')' > any+ >
global=global_stmt< 'global' any* 'next' any* >
order = "pre" # Pre-order tree traversal
def start_tree(self, tree, filename):
super(FixNext, self).start_tree(tree, filename)
n = find_binding('next', tree)
self.warning(n, bind_warning)
self.shadowed_next = True
self.shadowed_next = False
def transform(self, node, results):
base = results.get("base")
attr = results.get("attr")
name = results.get("name")
attr.replace(Name("__next__", prefix=attr.prefix))
base = [n.clone() for n in base]
node.replace(Call(Name("next", prefix=node.prefix), base))
n = Name("__next__", prefix=name.prefix)
# We don't do this transformation if we're assigning to "x.next".
# Unfortunately, it doesn't seem possible to do this in PATTERN,
# so it's being done here.
if is_assign_target(node):
if "".join([str(n) for n in head]).strip() == '__builtin__':
self.warning(node, bind_warning)
attr.replace(Name("__next__"))
elif "global" in results:
self.warning(node, bind_warning)
self.shadowed_next = True
### The following functions help test if node is part of an assignment
def is_assign_target(node):
assign = find_assign(node)
for child in assign.children:
if child.type == token.EQUAL:
elif is_subtree(child, node):
if node.type == syms.expr_stmt:
if node.type == syms.simple_stmt or node.parent is None:
return find_assign(node.parent)
def is_subtree(root, node):
return any(is_subtree(c, node) for c in root.children)