Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 1 | # 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. Kuchling | a6d4b68 | 2005-11-22 15:01:13 +0000 | [diff] [blame] | 9 | # |
| 10 | # If you add node types here, please be sure to update the list of |
| 11 | # Node types in Doc/lib/asttable.tex. |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 12 | Module: doc*, node |
| 13 | Stmt: nodes! |
Anthony Baxter | c2a5a63 | 2004-08-02 06:10:11 +0000 | [diff] [blame] | 14 | Decorators: nodes! |
| 15 | Function: decorators&, name*, argnames*, defaults!, flags*, doc*, code |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 16 | Lambda: argnames*, defaults!, flags*, code |
Facundo Batista | 4219da4 | 2008-02-25 18:06:00 +0000 | [diff] [blame] | 17 | Class: name*, bases!, doc*, code, decorators& = None |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 18 | Pass: |
| 19 | Break: |
| 20 | Continue: |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 21 | For: assign, list, body, else_& |
| 22 | While: test, body, else_& |
Guido van Rossum | c2e2074 | 2006-02-27 22:32:47 +0000 | [diff] [blame] | 23 | With: expr, vars&, body |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 24 | If: tests!, else_& |
Thomas Wouters | 7e2ac25 | 2006-03-03 18:11:37 +0000 | [diff] [blame] | 25 | IfExp: test, then, else_ |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 26 | Exec: expr, locals&, globals& |
Thomas Wouters | 7e2ac25 | 2006-03-03 18:11:37 +0000 | [diff] [blame] | 27 | From: modname*, names*, level* |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 28 | Import: names* |
| 29 | Raise: expr1&, expr2&, expr3& |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 30 | TryFinally: body, final |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 31 | TryExcept: body, handlers!, else_& |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 32 | Return: value |
Jeremy Hylton | 34aeeff | 2001-08-14 18:57:43 +0000 | [diff] [blame] | 33 | Yield: value |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 34 | Const: value* |
| 35 | Print: nodes!, dest& |
| 36 | Printnl: nodes!, dest& |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 37 | Discard: expr |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 38 | AugAssign: node, op*, expr |
| 39 | Assign: nodes!, expr |
| 40 | AssTuple: nodes! |
| 41 | AssList: nodes! |
| 42 | AssName: name*, flags* |
| 43 | AssAttr: expr, attrname*, flags* |
| 44 | ListComp: expr, quals! |
| 45 | ListCompFor: assign, list, ifs! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 46 | ListCompIf: test |
Guido van Rossum | c2e2074 | 2006-02-27 22:32:47 +0000 | [diff] [blame] | 47 | GenExpr: code |
Raymond Hettinger | 354433a | 2004-05-19 08:20:33 +0000 | [diff] [blame] | 48 | GenExprInner: expr, quals! |
| 49 | GenExprFor: assign, iter, ifs! |
| 50 | GenExprIf: test |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 51 | List: nodes! |
| 52 | Dict: items! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 53 | Not: expr |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 54 | Compare: expr, ops! |
| 55 | Name: name* |
Jeremy Hylton | fff252d | 2001-09-14 22:40:36 +0000 | [diff] [blame] | 56 | Global: names* |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 57 | Backquote: expr |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 58 | Getattr: expr, attrname* |
| 59 | CallFunc: node, args!, star_args& = None, dstar_args& = None |
| 60 | Keyword: name*, expr |
| 61 | Subscript: expr, flags*, subs! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 62 | Ellipsis: |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 63 | Sliceobj: nodes! |
| 64 | Slice: expr, flags*, lower&, upper& |
| 65 | Assert: test, fail& |
| 66 | Tuple: nodes! |
| 67 | Or: nodes! |
| 68 | And: nodes! |
| 69 | Bitor: nodes! |
| 70 | Bitxor: nodes! |
| 71 | Bitand: nodes! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 72 | LeftShift: (left, right) |
| 73 | RightShift: (left, right) |
| 74 | Add: (left, right) |
| 75 | Sub: (left, right) |
| 76 | Mul: (left, right) |
| 77 | Div: (left, right) |
| 78 | Mod: (left, right) |
| 79 | Power: (left, right) |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 80 | FloorDiv: (left, right) |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 81 | UnaryAdd: expr |
| 82 | UnarySub: expr |
| 83 | Invert: expr |
| 84 | |
| 85 | init(Function): |
| 86 | self.varargs = self.kwargs = None |
| 87 | if flags & CO_VARARGS: |
| 88 | self.varargs = 1 |
| 89 | if flags & CO_VARKEYWORDS: |
| 90 | self.kwargs = 1 |
| 91 | |
| 92 | init(Lambda): |
| 93 | self.varargs = self.kwargs = None |
| 94 | if flags & CO_VARARGS: |
| 95 | self.varargs = 1 |
| 96 | if flags & CO_VARKEYWORDS: |
| 97 | self.kwargs = 1 |
Raymond Hettinger | 354433a | 2004-05-19 08:20:33 +0000 | [diff] [blame] | 98 | |
| 99 | init(GenExpr): |
Facundo Batista | 4219da4 | 2008-02-25 18:06:00 +0000 | [diff] [blame] | 100 | self.argnames = ['.0'] |
Raymond Hettinger | 354433a | 2004-05-19 08:20:33 +0000 | [diff] [blame] | 101 | self.varargs = self.kwargs = None |
| 102 | |
| 103 | init(GenExprFor): |
| 104 | self.is_outmost = False |