tokenizer.h 3.75 KB
Newer Older
1 2 3 4 5 6
#ifndef Py_TOKENIZER_H
#define Py_TOKENIZER_H
#ifdef __cplusplus
extern "C" {
#endif

7
#include "object.h"
8

Guido van Rossum's avatar
Guido van Rossum committed
9 10
/* Tokenizer interface */

11
#include "token.h"      /* For token types */
Guido van Rossum's avatar
Guido van Rossum committed
12

13
#define MAXINDENT 100   /* Max indentation level */
14
#define MAXLEVEL 200    /* Max parentheses level */
Guido van Rossum's avatar
Guido van Rossum committed
15

16
enum decoding_state {
17 18
    STATE_INIT,
    STATE_RAW,
19
    STATE_NORMAL        /* have a codec associated with input */
20 21
};

Guido van Rossum's avatar
Guido van Rossum committed
22 23
/* Tokenizer state */
struct tok_state {
24 25 26 27 28 29 30 31 32 33 34 35 36 37 38
    /* Input state; buf <= cur <= inp <= end */
    /* NB an entire line is held in the buffer */
    char *buf;          /* Input buffer, or NULL; malloc'ed if fp != NULL */
    char *cur;          /* Next character in buffer */
    char *inp;          /* End of data in buffer */
    char *end;          /* End of input buffer if buf != NULL */
    char *start;        /* Start of current token if not NULL */
    int done;           /* E_OK normally, E_EOF at EOF, otherwise error code */
    /* NB If done != E_OK, cur must be == inp!!! */
    FILE *fp;           /* Rest of input; NULL if tokenizing a string */
    int tabsize;        /* Tab spacing */
    int indent;         /* Current indentation index */
    int indstack[MAXINDENT];            /* Stack of indents */
    int atbol;          /* Nonzero if at begin of new line */
    int pendin;         /* Pending indents (if > 0) or dedents (if < 0) */
39
    const char *prompt, *nextprompt;          /* For interactive prompting */
40
    int lineno;         /* Current line number */
41 42
    int first_lineno;   /* First line of a single line or multi line string
                           expression (cf. issue 16806) */
43 44
    int level;          /* () [] {} Parentheses nesting level */
            /* Used to allow free continuations inside them */
45 46
    char parenstack[MAXLEVEL];
    int parenlinenostack[MAXLEVEL];
47
    PyObject *filename;
48
    /* Stuff for checking on different tab sizes */
49 50 51 52 53 54 55 56
    int altindstack[MAXINDENT];         /* Stack of alternate indents */
    /* Stuff for PEP 0263 */
    enum decoding_state decoding_state;
    int decoding_erred;         /* whether erred in decoding  */
    int read_coding_spec;       /* whether 'coding:...' has been read  */
    char *encoding;         /* Source encoding. */
    int cont_line;          /* whether we are in a continuation line. */
    const char* line_start;     /* pointer to start of current line */
57 58 59
    const char* multi_line_start; /* pointer to start of first line of
                                     a single line or multi line string
                                     expression (cf. issue 16806) */
60
    PyObject *decoding_readline; /* open(...).readline */
61 62 63 64
    PyObject *decoding_buffer;
    const char* enc;        /* Encoding for the current str. */
    const char* str;
    const char* input; /* Tokenizer's newline translated copy of the string. */
65 66

    int type_comments;      /* Whether to look for type comments */
67 68 69 70 71 72 73

    /* async/await related fields (still needed depending on feature_version) */
    int async_hacks;     /* =1 if async/await aren't always keywords */
    int async_def;        /* =1 if tokens are inside an 'async def' body. */
    int async_def_indent; /* Indentation level of the outermost 'async def'. */
    int async_def_nl;     /* =1 if the outermost 'async def' had at least one
                             NEWLINE token after it. */
Guido van Rossum's avatar
Guido van Rossum committed
74 75
};

76 77
extern struct tok_state *PyTokenizer_FromString(const char *, int);
extern struct tok_state *PyTokenizer_FromUTF8(const char *, int);
78 79
extern struct tok_state *PyTokenizer_FromFile(FILE *, const char*,
                                              const char *, const char *);
80 81
extern void PyTokenizer_Free(struct tok_state *);
extern int PyTokenizer_Get(struct tok_state *, char **, char **);
82

83 84
#define tok_dump _Py_tok_dump

85 86 87 88
#ifdef __cplusplus
}
#endif
#endif /* !Py_TOKENIZER_H */