将节点插入抽象语法树

时间:2017-09-24 08:29:21

标签: python python-3.x python-2.7 abstract-syntax-tree

ast模块的documentation解释了如何使用NodeTransformer类替换AST中的节点,但没有解释如何将新节点插入树中。

例如,给定此模块:

import foo
import bar

class Baz(object):

    def spam(self):
        pass

我想添加另一个导入,并在Baz上设置一个类变量。

如何创建这些节点并将其插入AST?

1 个答案:

答案 0 :(得分:7)

Python AST基本上由嵌套列表组成,因此一旦构造了新节点,就可以将它们插入到这些列表中。

首先,获取要更改的AST:

>>> root = ast.parse(open('test.py').read())

>>> ast.dump(root)
"Module(body=[Import(names=[alias(name='foo', asname=None)]), Import(names=[alias(name='bar', asname=None)]), ClassDef(name='Baz', bases=[Name(id='object', ctx=Load())], body=[FunctionDef(name='spam', args=arguments(args=[Name(id='self', ctx=Param())], vararg=None, kwarg=None, defaults=[]), body=[Pass()], decorator_list=[])], decorator_list=[])])"

我们可以看到外部模块有一个body属性,其中包含模块的顶级元素:

>>> root.body
[<_ast.Import object at 0x7f81685385d0>, <_ast.Import object at 0x7f8168538950>, <_ast.ClassDef object at 0x7f8168538b10>]

构造导入节点并插入:

>>> import_node = ast.Import(names=[ast.alias(name='quux', asname=None)])
>>> root.body.insert(2, import_node)

与根模块节点类似,类定义节点具有包含其成员的body属性:

>>> classdef = root.body[-1]
>>> ast.dump(classdef)
"ClassDef(name='Baz', bases=[Name(id='object', ctx=Load())], body=[FunctionDef(name='spam', args=arguments(args=[Name(id='self', ctx=Param())], vararg=None, kwarg=None, defaults=[]), body=[Pass()], decorator_list=[])], decorator_list=[])"

所以我们构造一个赋值节点并插入它:

>>> assign_node = ast.Assign(targets=[ast.Name(id='eggs', ctx=ast.Store())], value=ast.Str(s='ham')) 
>>> classdef.body.insert(0, assign_node)

要完成,请修正行号:

>>> ast.fix_missing_locations(root)
<_ast.Module object at 0x7f816812ef90>

我们可以通过使用ast.dump转储根节点来验证我们的节点是否到位,或者使用CPython存储库中的unparse * 工具从AST生成源。

可以在CPython存储库的Tools目录中找到Python3 unparse脚本 ** 。在Python2中,它位于Demo目录中。

>>> from unparse import Unparser
>>> buf = StringIO()
>>> Unparser(root, buf)
<unparse.Unparser instance at 0x7f81685c6248>
>>> buf.seek(0)
>>> print(buf.read())

import foo
import bar
import quux

class Baz(object):
    eggs = 'ham'

    def spam(self):
        pass
>>> 

构建AST节点时,可以使用ast.parseast.dump(观察ast.parse将语句包装在模块中)来了解节点的外观:< / p>

>>> root = ast.parse('import foo')
>>> ast.dump(root)
"Module(body=[Import(names=[alias(name='foo', asname=None)])])"

* 感谢this answer记录了unsarse脚本的存在。

** 使用git分支中与正在使用的Python版本对应的脚本版本。例如,使用3.7代码中3.6分支的脚本可能会因版本各自的语法不同而失败。