blob: d458b75cd588c1b44e552f23d2e5f607fa350c2c [file] [log] [blame]
Jeremy Hylton5477f522001-08-29 18:08:02 +00001# This file describes the nodes of the AST in ast.py. The module is
2# generated by astgen.py.
3# The descriptions use the following special notation to describe
4# properties of the children:
5# * this child is not a node
6# ! this child is a sequence that contains nodes in it
7# & this child may be set to None
8# = ... a default value for the node constructor (optional args)
Andrew M. Kuchlinga6d4b682005-11-22 15:01:13 +00009#
10# If you add node types here, please be sure to update the list of
11# Node types in Doc/lib/asttable.tex.
Jeremy Hylton5477f522001-08-29 18:08:02 +000012Module: doc*, node
13Stmt: nodes!
Anthony Baxterc2a5a632004-08-02 06:10:11 +000014Decorators: nodes!
Neal Norwitzc1505362006-12-28 06:47:50 +000015Function: decorators&, name*, arguments!, defaults!, kwonlyargs!, returns&, flags*, doc*, code
16Lambda: arguments!, defaults!, kwonlyargs!, flags*, code
17SimpleArg: name*, annotation&
18NestedArgs: args!
19Kwarg: arg, expr
Jeremy Hylton5477f522001-08-29 18:08:02 +000020Class: name*, bases!, doc*, code
Jeremy Hylton821eee32000-10-25 17:59:17 +000021Pass:
22Break:
23Continue:
Jeremy Hylton5477f522001-08-29 18:08:02 +000024For: assign, list, body, else_&
25While: test, body, else_&
Guido van Rossumc2e20742006-02-27 22:32:47 +000026With: expr, vars&, body
Jeremy Hylton5477f522001-08-29 18:08:02 +000027If: tests!, else_&
Thomas Wouters7e2ac252006-03-03 18:11:37 +000028IfExp: test, then, else_
Thomas Wouters7e2ac252006-03-03 18:11:37 +000029From: modname*, names*, level*
Jeremy Hylton5477f522001-08-29 18:08:02 +000030Import: names*
31Raise: expr1&, expr2&, expr3&
Jeremy Hylton821eee32000-10-25 17:59:17 +000032TryFinally: body, final
Jeremy Hylton5477f522001-08-29 18:08:02 +000033TryExcept: body, handlers!, else_&
Jeremy Hylton821eee32000-10-25 17:59:17 +000034Return: value
Jeremy Hylton34aeeff2001-08-14 18:57:43 +000035Yield: value
Jeremy Hylton5477f522001-08-29 18:08:02 +000036Const: value*
Jeremy Hylton821eee32000-10-25 17:59:17 +000037Discard: expr
Jeremy Hylton5477f522001-08-29 18:08:02 +000038AugAssign: node, op*, expr
39Assign: nodes!, expr
40AssTuple: nodes!
41AssList: nodes!
42AssName: name*, flags*
43AssAttr: expr, attrname*, flags*
44ListComp: expr, quals!
45ListCompFor: assign, list, ifs!
Jeremy Hylton821eee32000-10-25 17:59:17 +000046ListCompIf: test
Guido van Rossumc2e20742006-02-27 22:32:47 +000047GenExpr: code
Raymond Hettinger354433a2004-05-19 08:20:33 +000048GenExprInner: expr, quals!
49GenExprFor: assign, iter, ifs!
50GenExprIf: test
Jeremy Hylton5477f522001-08-29 18:08:02 +000051List: nodes!
52Dict: items!
Guido van Rossum86e58e22006-08-28 15:27:34 +000053Set: items!
Jeremy Hylton821eee32000-10-25 17:59:17 +000054Not: expr
Jeremy Hylton5477f522001-08-29 18:08:02 +000055Compare: expr, ops!
56Name: name*
Jeremy Hyltonfff252d2001-09-14 22:40:36 +000057Global: names*
Jeremy Hylton5477f522001-08-29 18:08:02 +000058Getattr: expr, attrname*
59CallFunc: node, args!, star_args& = None, dstar_args& = None
60Keyword: name*, expr
61Subscript: expr, flags*, subs!
Jeremy Hylton5477f522001-08-29 18:08:02 +000062Sliceobj: nodes!
63Slice: expr, flags*, lower&, upper&
64Assert: test, fail&
65Tuple: nodes!
66Or: nodes!
67And: nodes!
68Bitor: nodes!
69Bitxor: nodes!
70Bitand: nodes!
Jeremy Hylton821eee32000-10-25 17:59:17 +000071LeftShift: (left, right)
72RightShift: (left, right)
73Add: (left, right)
74Sub: (left, right)
75Mul: (left, right)
76Div: (left, right)
77Mod: (left, right)
78Power: (left, right)
Jeremy Hylton5477f522001-08-29 18:08:02 +000079FloorDiv: (left, right)
Jeremy Hylton821eee32000-10-25 17:59:17 +000080UnaryAdd: expr
81UnarySub: expr
82Invert: expr
83
84init(Function):
85 self.varargs = self.kwargs = None
86 if flags & CO_VARARGS:
87 self.varargs = 1
88 if flags & CO_VARKEYWORDS:
89 self.kwargs = 1
90
91init(Lambda):
92 self.varargs = self.kwargs = None
93 if flags & CO_VARARGS:
94 self.varargs = 1
95 if flags & CO_VARKEYWORDS:
96 self.kwargs = 1
Neal Norwitzc1505362006-12-28 06:47:50 +000097 self.returns = None
Raymond Hettinger354433a2004-05-19 08:20:33 +000098
99init(GenExpr):
Neal Norwitzc1505362006-12-28 06:47:50 +0000100 self.arguments = [SimpleArg('.0', None)]
Raymond Hettinger354433a2004-05-19 08:20:33 +0000101 self.varargs = self.kwargs = None
Guido van Rossum4f72a782006-10-27 23:31:49 +0000102 self.kwonlyargs = ()
Raymond Hettinger354433a2004-05-19 08:20:33 +0000103
104init(GenExprFor):
105 self.is_outmost = False