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 |
| 17 | Class: name*, bases!, doc*, code |
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_& |
| 25 | Exec: expr, locals&, globals& |
| 26 | From: modname*, names* |
| 27 | Import: names* |
| 28 | Raise: expr1&, expr2&, expr3& |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 29 | TryFinally: body, final |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 30 | TryExcept: body, handlers!, else_& |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 31 | Return: value |
Jeremy Hylton | 34aeeff | 2001-08-14 18:57:43 +0000 | [diff] [blame] | 32 | Yield: value |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 33 | Const: value* |
| 34 | Print: nodes!, dest& |
| 35 | Printnl: nodes!, dest& |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 36 | Discard: expr |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 37 | AugAssign: node, op*, expr |
| 38 | Assign: nodes!, expr |
| 39 | AssTuple: nodes! |
| 40 | AssList: nodes! |
| 41 | AssName: name*, flags* |
| 42 | AssAttr: expr, attrname*, flags* |
| 43 | ListComp: expr, quals! |
| 44 | ListCompFor: assign, list, ifs! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 45 | ListCompIf: test |
Guido van Rossum | c2e2074 | 2006-02-27 22:32:47 +0000 | [diff] [blame] | 46 | GenExpr: code |
Raymond Hettinger | 354433a | 2004-05-19 08:20:33 +0000 | [diff] [blame] | 47 | GenExprInner: expr, quals! |
| 48 | GenExprFor: assign, iter, ifs! |
| 49 | GenExprIf: test |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 50 | List: nodes! |
| 51 | Dict: items! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 52 | Not: expr |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 53 | Compare: expr, ops! |
| 54 | Name: name* |
Jeremy Hylton | fff252d | 2001-09-14 22:40:36 +0000 | [diff] [blame] | 55 | Global: names* |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 56 | Backquote: expr |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 57 | Getattr: expr, attrname* |
| 58 | CallFunc: node, args!, star_args& = None, dstar_args& = None |
| 59 | Keyword: name*, expr |
| 60 | Subscript: expr, flags*, subs! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 61 | Ellipsis: |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 62 | Sliceobj: nodes! |
| 63 | Slice: expr, flags*, lower&, upper& |
| 64 | Assert: test, fail& |
| 65 | Tuple: nodes! |
| 66 | Or: nodes! |
| 67 | And: nodes! |
| 68 | Bitor: nodes! |
| 69 | Bitxor: nodes! |
| 70 | Bitand: nodes! |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 71 | LeftShift: (left, right) |
| 72 | RightShift: (left, right) |
| 73 | Add: (left, right) |
| 74 | Sub: (left, right) |
| 75 | Mul: (left, right) |
| 76 | Div: (left, right) |
| 77 | Mod: (left, right) |
| 78 | Power: (left, right) |
Jeremy Hylton | 5477f52 | 2001-08-29 18:08:02 +0000 | [diff] [blame] | 79 | FloorDiv: (left, right) |
Jeremy Hylton | 821eee3 | 2000-10-25 17:59:17 +0000 | [diff] [blame] | 80 | UnaryAdd: expr |
| 81 | UnarySub: expr |
| 82 | Invert: expr |
| 83 | |
| 84 | init(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 | |
| 91 | init(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 |
Raymond Hettinger | 354433a | 2004-05-19 08:20:33 +0000 | [diff] [blame] | 97 | |
| 98 | init(GenExpr): |
| 99 | self.argnames = ['[outmost-iterable]'] |
| 100 | self.varargs = self.kwargs = None |
| 101 | |
| 102 | init(GenExprFor): |
| 103 | self.is_outmost = False |