Guido van Rossum | 526e909 | 1992-01-14 18:27:17 +0000 | [diff] [blame] | 1 | # Grammar for Python |
Guido van Rossum | 6cf1273 | 1991-12-31 13:11:56 +0000 | [diff] [blame] | 2 | |
Guido van Rossum | e5f6f45 | 1994-09-29 10:05:45 +0000 | [diff] [blame] | 3 | # Commands for Kees Blom's railroad program |
Guido van Rossum | a322862 | 1994-08-17 13:19:13 +0000 | [diff] [blame] | 4 | #diagram:token NAME |
| 5 | #diagram:token NUMBER |
| 6 | #diagram:token STRING |
| 7 | #diagram:token NEWLINE |
| 8 | #diagram:token ENDMARKER |
| 9 | #diagram:token INDENT |
| 10 | #diagram:output\input python.bla |
| 11 | #diagram:token DEDENT |
| 12 | #diagram:output\textwidth 20.04cm\oddsidemargin 0.0cm\evensidemargin 0.0cm |
| 13 | #diagram:rules |
Guido van Rossum | e5f6f45 | 1994-09-29 10:05:45 +0000 | [diff] [blame] | 14 | |
| 15 | # Start symbols for the grammar: |
| 16 | # single_input is a single interactive statement; |
| 17 | # file_input is a module or sequence of commands read from an input file; |
| 18 | # eval_input is the input for the eval() and input() functions. |
| 19 | # NB: compound_stmt in single_input is followed by extra NEWLINE! |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 20 | single_input: NEWLINE | simple_stmt | compound_stmt NEWLINE |
| 21 | file_input: (NEWLINE | stmt)* ENDMARKER |
Guido van Rossum | e785fbc | 1992-03-04 16:41:24 +0000 | [diff] [blame] | 22 | eval_input: testlist NEWLINE* ENDMARKER |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 23 | |
| 24 | funcdef: 'def' NAME parameters ':' suite |
Guido van Rossum | 526e909 | 1992-01-14 18:27:17 +0000 | [diff] [blame] | 25 | parameters: '(' [varargslist] ')' |
Guido van Rossum | 0bfd6c3 | 1996-01-12 01:00:58 +0000 | [diff] [blame] | 26 | varargslist: (fpdef ['=' test] ',')* ('*' NAME [',' ('**'|'*' '*') NAME] | ('**'|'*' '*') NAME) | fpdef ['=' test] (',' fpdef ['=' test])* [','] |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 27 | fpdef: NAME | '(' fplist ')' |
Guido van Rossum | 526e909 | 1992-01-14 18:27:17 +0000 | [diff] [blame] | 28 | fplist: fpdef (',' fpdef)* [','] |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 29 | |
| 30 | stmt: simple_stmt | compound_stmt |
Guido van Rossum | 56f7837 | 1991-07-17 18:39:15 +0000 | [diff] [blame] | 31 | simple_stmt: small_stmt (';' small_stmt)* [';'] NEWLINE |
Guido van Rossum | db3165e | 1993-10-18 17:06:59 +0000 | [diff] [blame] | 32 | small_stmt: expr_stmt | print_stmt | del_stmt | pass_stmt | flow_stmt | import_stmt | global_stmt | access_stmt | exec_stmt |
Guido van Rossum | e5f6f45 | 1994-09-29 10:05:45 +0000 | [diff] [blame] | 33 | expr_stmt: testlist ('=' testlist)* |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 34 | # For assignments, additional restrictions enforced by the interpreter |
Guido van Rossum | 56f7837 | 1991-07-17 18:39:15 +0000 | [diff] [blame] | 35 | print_stmt: 'print' (test ',')* [test] |
| 36 | del_stmt: 'del' exprlist |
| 37 | pass_stmt: 'pass' |
| 38 | flow_stmt: break_stmt | continue_stmt | return_stmt | raise_stmt |
| 39 | break_stmt: 'break' |
| 40 | continue_stmt: 'continue' |
| 41 | return_stmt: 'return' [testlist] |
Guido van Rossum | a996b91 | 1995-07-07 22:26:23 +0000 | [diff] [blame] | 42 | raise_stmt: 'raise' test [',' test [',' test]] |
Guido van Rossum | 4a1da26 | 1995-01-07 10:25:36 +0000 | [diff] [blame] | 43 | import_stmt: 'import' dotted_name (',' dotted_name)* | 'from' dotted_name 'import' ('*' | NAME (',' NAME)*) |
| 44 | dotted_name: NAME ('.' NAME)* |
Guido van Rossum | 68fc349 | 1991-12-10 13:51:08 +0000 | [diff] [blame] | 45 | global_stmt: 'global' NAME (',' NAME)* |
Guido van Rossum | e5f6f45 | 1994-09-29 10:05:45 +0000 | [diff] [blame] | 46 | access_stmt: 'access' ('*' | NAME (',' NAME)*) ':' accesstype (',' accesstype)* |
Guido van Rossum | 2583165 | 1993-05-19 14:50:45 +0000 | [diff] [blame] | 47 | accesstype: NAME+ |
| 48 | # accesstype should be ('public' | 'protected' | 'private') ['read'] ['write'] |
| 49 | # but can't be because that would create undesirable reserved words! |
Guido van Rossum | 12d12c5 | 1993-10-26 17:58:25 +0000 | [diff] [blame] | 50 | exec_stmt: 'exec' expr ['in' test [',' test]] |
Guido van Rossum | 2583165 | 1993-05-19 14:50:45 +0000 | [diff] [blame] | 51 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 52 | compound_stmt: if_stmt | while_stmt | for_stmt | try_stmt | funcdef | classdef |
Guido van Rossum | e5f6f45 | 1994-09-29 10:05:45 +0000 | [diff] [blame] | 53 | if_stmt: 'if' test ':' suite ('elif' test ':' suite)* ['else' ':' suite] |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 54 | while_stmt: 'while' test ':' suite ['else' ':' suite] |
Guido van Rossum | 56f7837 | 1991-07-17 18:39:15 +0000 | [diff] [blame] | 55 | for_stmt: 'for' exprlist 'in' testlist ':' suite ['else' ':' suite] |
Guido van Rossum | a322862 | 1994-08-17 13:19:13 +0000 | [diff] [blame] | 56 | try_stmt: ('try' ':' suite (except_clause ':' suite)+ #diagram:break |
| 57 | ['else' ':' suite] | 'try' ':' suite 'finally' ':' suite) |
Guido van Rossum | af82141 | 1992-03-31 18:49:18 +0000 | [diff] [blame] | 58 | # NB compile.c makes sure that the default except clause is last |
Guido van Rossum | 56f7837 | 1991-07-17 18:39:15 +0000 | [diff] [blame] | 59 | except_clause: 'except' [test [',' test]] |
Guido van Rossum | 7ac4a88 | 1991-07-27 21:29:47 +0000 | [diff] [blame] | 60 | suite: simple_stmt | NEWLINE INDENT stmt+ DEDENT |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 61 | |
Guido van Rossum | 57531fe | 1993-11-30 14:57:42 +0000 | [diff] [blame] | 62 | test: and_test ('or' and_test)* | lambdef |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 63 | and_test: not_test ('and' not_test)* |
| 64 | not_test: 'not' not_test | comparison |
| 65 | comparison: expr (comp_op expr)* |
Guido van Rossum | 6cf1273 | 1991-12-31 13:11:56 +0000 | [diff] [blame] | 66 | comp_op: '<'|'>'|'=='|'>='|'<='|'<>'|'!='|'in'|'not' 'in'|'is'|'is' 'not' |
Guido van Rossum | 9eb4f53 | 1991-10-24 14:54:25 +0000 | [diff] [blame] | 67 | expr: xor_expr ('|' xor_expr)* |
| 68 | xor_expr: and_expr ('^' and_expr)* |
| 69 | and_expr: shift_expr ('&' shift_expr)* |
| 70 | shift_expr: arith_expr (('<<'|'>>') arith_expr)* |
| 71 | arith_expr: term (('+'|'-') term)* |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 72 | term: factor (('*'|'/'|'%') factor)* |
Guido van Rossum | 0bfd6c3 | 1996-01-12 01:00:58 +0000 | [diff] [blame] | 73 | factor: ('+'|'-'|'~') factor | power |
| 74 | power: atom trailer* ('**' factor)* |
Guido van Rossum | da5d518 | 1994-08-01 11:00:20 +0000 | [diff] [blame] | 75 | atom: '(' [testlist] ')' | '[' [testlist] ']' | '{' [dictmaker] '}' | '`' testlist '`' | NAME | NUMBER | STRING+ |
Guido van Rossum | 590baa4 | 1993-11-30 13:40:46 +0000 | [diff] [blame] | 76 | lambdef: 'lambda' [varargslist] ':' test |
Guido van Rossum | 14f4451 | 1996-07-30 16:43:44 +0000 | [diff] [blame^] | 77 | trailer: '(' [arglist] ')' | '[' subscriptlist ']' | '.' NAME |
| 78 | subscriptlist: subscript (',' subscript)* [','] |
| 79 | subscript: '.' '.' '.' | test | [test] ':' [test] [sliceop] |
| 80 | sliceop: ':' [test] |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 81 | exprlist: expr (',' expr)* [','] |
| 82 | testlist: test (',' test)* [','] |
Guido van Rossum | 56f7837 | 1991-07-17 18:39:15 +0000 | [diff] [blame] | 83 | dictmaker: test ':' test (',' test ':' test)* [','] |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 84 | |
Guido van Rossum | 248a50c | 1993-12-20 12:53:10 +0000 | [diff] [blame] | 85 | classdef: 'class' NAME ['(' testlist ')'] ':' suite |
Guido van Rossum | a996b91 | 1995-07-07 22:26:23 +0000 | [diff] [blame] | 86 | |
| 87 | arglist: argument (',' argument)* [','] |
| 88 | argument: [test '='] test # Really [keyword '='] test |