Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 1 | #ifndef Py_TOKENIZER_H |
| 2 | #define Py_TOKENIZER_H |
| 3 | #ifdef __cplusplus |
| 4 | extern "C" { |
| 5 | #endif |
| 6 | |
Martin v. Löwis | 00f1e3f | 2002-08-04 17:29:52 +0000 | [diff] [blame] | 7 | #include "object.h" |
Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 8 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 9 | /* Tokenizer interface */ |
| 10 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 11 | #include "token.h" /* For token types */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 12 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 13 | #define MAXINDENT 100 /* Max indentation level */ |
Serhiy Storchaka | 94cf308 | 2018-12-17 17:34:14 +0200 | [diff] [blame] | 14 | #define MAXLEVEL 200 /* Max parentheses level */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 15 | |
Neil Schemenauer | 3f993c3 | 2007-09-21 20:50:26 +0000 | [diff] [blame] | 16 | enum decoding_state { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 17 | STATE_INIT, |
| 18 | STATE_RAW, |
Georg Brandl | 2b15bd8 | 2010-10-29 04:54:13 +0000 | [diff] [blame] | 19 | STATE_NORMAL /* have a codec associated with input */ |
Neil Schemenauer | 3f993c3 | 2007-09-21 20:50:26 +0000 | [diff] [blame] | 20 | }; |
| 21 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 22 | /* Tokenizer state */ |
| 23 | struct tok_state { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 24 | /* Input state; buf <= cur <= inp <= end */ |
| 25 | /* NB an entire line is held in the buffer */ |
| 26 | char *buf; /* Input buffer, or NULL; malloc'ed if fp != NULL */ |
| 27 | char *cur; /* Next character in buffer */ |
| 28 | char *inp; /* End of data in buffer */ |
Andy Lester | 384f3c5 | 2020-02-27 20:44:52 -0600 | [diff] [blame] | 29 | const char *end; /* End of input buffer if buf != NULL */ |
| 30 | const char *start; /* Start of current token if not NULL */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 31 | int done; /* E_OK normally, E_EOF at EOF, otherwise error code */ |
| 32 | /* NB If done != E_OK, cur must be == inp!!! */ |
| 33 | FILE *fp; /* Rest of input; NULL if tokenizing a string */ |
| 34 | int tabsize; /* Tab spacing */ |
| 35 | int indent; /* Current indentation index */ |
| 36 | int indstack[MAXINDENT]; /* Stack of indents */ |
| 37 | int atbol; /* Nonzero if at begin of new line */ |
| 38 | int pendin; /* Pending indents (if > 0) or dedents (if < 0) */ |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 39 | const char *prompt, *nextprompt; /* For interactive prompting */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 40 | int lineno; /* Current line number */ |
Anthony Sottile | 995d9b9 | 2019-01-12 20:05:13 -0800 | [diff] [blame] | 41 | int first_lineno; /* First line of a single line or multi line string |
| 42 | expression (cf. issue 16806) */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 43 | int level; /* () [] {} Parentheses nesting level */ |
| 44 | /* Used to allow free continuations inside them */ |
Serhiy Storchaka | 94cf308 | 2018-12-17 17:34:14 +0200 | [diff] [blame] | 45 | char parenstack[MAXLEVEL]; |
| 46 | int parenlinenostack[MAXLEVEL]; |
Victor Stinner | 7f2fee3 | 2011-04-05 00:39:01 +0200 | [diff] [blame] | 47 | PyObject *filename; |
Serhiy Storchaka | 94cf308 | 2018-12-17 17:34:14 +0200 | [diff] [blame] | 48 | /* Stuff for checking on different tab sizes */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 49 | int altindstack[MAXINDENT]; /* Stack of alternate indents */ |
| 50 | /* Stuff for PEP 0263 */ |
| 51 | enum decoding_state decoding_state; |
| 52 | int decoding_erred; /* whether erred in decoding */ |
| 53 | int read_coding_spec; /* whether 'coding:...' has been read */ |
| 54 | char *encoding; /* Source encoding. */ |
| 55 | int cont_line; /* whether we are in a continuation line. */ |
| 56 | const char* line_start; /* pointer to start of current line */ |
Anthony Sottile | 995d9b9 | 2019-01-12 20:05:13 -0800 | [diff] [blame] | 57 | const char* multi_line_start; /* pointer to start of first line of |
| 58 | a single line or multi line string |
| 59 | expression (cf. issue 16806) */ |
Victor Stinner | 22a351a | 2010-10-14 12:04:34 +0000 | [diff] [blame] | 60 | PyObject *decoding_readline; /* open(...).readline */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 61 | PyObject *decoding_buffer; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 62 | const char* enc; /* Encoding for the current str. */ |
Andy Lester | 384f3c5 | 2020-02-27 20:44:52 -0600 | [diff] [blame] | 63 | char* str; |
| 64 | char* input; /* Tokenizer's newline translated copy of the string. */ |
Guido van Rossum | dcfcd14 | 2019-01-31 03:40:27 -0800 | [diff] [blame] | 65 | |
| 66 | int type_comments; /* Whether to look for type comments */ |
Guido van Rossum | 495da29 | 2019-03-07 12:38:08 -0800 | [diff] [blame] | 67 | |
| 68 | /* async/await related fields (still needed depending on feature_version) */ |
| 69 | int async_hacks; /* =1 if async/await aren't always keywords */ |
| 70 | int async_def; /* =1 if tokens are inside an 'async def' body. */ |
| 71 | int async_def_indent; /* Indentation level of the outermost 'async def'. */ |
| 72 | int async_def_nl; /* =1 if the outermost 'async def' had at least one |
| 73 | NEWLINE token after it. */ |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 74 | }; |
| 75 | |
Benjamin Peterson | aeaa592 | 2009-11-13 00:17:59 +0000 | [diff] [blame] | 76 | extern struct tok_state *PyTokenizer_FromString(const char *, int); |
| 77 | extern struct tok_state *PyTokenizer_FromUTF8(const char *, int); |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 78 | extern struct tok_state *PyTokenizer_FromFile(FILE *, const char*, |
| 79 | const char *, const char *); |
Tim Peters | dbd9ba6 | 2000-07-09 03:09:57 +0000 | [diff] [blame] | 80 | extern void PyTokenizer_Free(struct tok_state *); |
Andy Lester | 384f3c5 | 2020-02-27 20:44:52 -0600 | [diff] [blame] | 81 | extern int PyTokenizer_Get(struct tok_state *, const char **, const char **); |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 82 | |
Pablo Galindo | f2cf1e3 | 2019-04-13 17:05:14 +0100 | [diff] [blame] | 83 | #define tok_dump _Py_tok_dump |
| 84 | |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 85 | #ifdef __cplusplus |
| 86 | } |
| 87 | #endif |
| 88 | #endif /* !Py_TOKENIZER_H */ |