blob: be49f0005ac6c1c10645aea26a85c59a33a63568 [file] [log] [blame]
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00001/* Parser-tokenizer link interface */
Victor Stinner5f2df882018-11-12 00:56:19 +01002
Martin v. Löwis4d0d4712010-12-03 20:14:31 +00003#ifndef Py_LIMITED_API
Fred Drake5eb6d4e2000-07-08 23:37:28 +00004#ifndef Py_PARSETOK_H
5#define Py_PARSETOK_H
6#ifdef __cplusplus
7extern "C" {
8#endif
9
Victor Stinner5f2df882018-11-12 00:56:19 +010010#include "grammar.h" /* grammar */
11#include "node.h" /* node */
12
Guido van Rossumb6775db1994-08-01 11:34:53 +000013typedef struct {
Fred Drake5eb6d4e2000-07-08 23:37:28 +000014 int error;
Victor Stinner7f2fee32011-04-05 00:39:01 +020015 PyObject *filename;
Fred Drake5eb6d4e2000-07-08 23:37:28 +000016 int lineno;
17 int offset;
Victor Stinner00676d12010-12-27 01:49:31 +000018 char *text; /* UTF-8-encoded string */
Fred Drake85f36392000-07-11 17:53:00 +000019 int token;
20 int expected;
Guido van Rossumb6775db1994-08-01 11:34:53 +000021} perrdetail;
22
Neil Schemenauerc24ea082002-03-22 23:53:36 +000023#if 0
Serhiy Storchaka598ceae2017-11-28 17:56:10 +020024#define PyPARSE_YIELD_IS_KEYWORD 0x0001
Neil Schemenauerc24ea082002-03-22 23:53:36 +000025#endif
Tim Petersfe2127d2001-07-16 05:37:24 +000026
Serhiy Storchaka598ceae2017-11-28 17:56:10 +020027#define PyPARSE_DONT_IMPLY_DEDENT 0x0002
Guido van Rossum4b499dd32003-02-13 22:07:59 +000028
Guido van Rossum45aecf42006-03-15 04:58:47 +000029#if 0
Serhiy Storchaka598ceae2017-11-28 17:56:10 +020030#define PyPARSE_WITH_IS_KEYWORD 0x0003
Christian Heimes4d6ec852008-03-26 22:34:47 +000031#define PyPARSE_PRINT_IS_FUNCTION 0x0004
32#define PyPARSE_UNICODE_LITERALS 0x0008
Guido van Rossum45aecf42006-03-15 04:58:47 +000033#endif
Thomas Wouters34aa7ba2006-02-28 19:02:24 +000034
Benjamin Petersonf5b52242009-03-02 23:31:26 +000035#define PyPARSE_IGNORE_COOKIE 0x0010
Brett Cannone3944a52009-04-01 05:08:41 +000036#define PyPARSE_BARRY_AS_BDFL 0x0020
Guido van Rossumdcfcd142019-01-31 03:40:27 -080037#define PyPARSE_TYPE_COMMENTS 0x0040
Benjamin Petersonf5b52242009-03-02 23:31:26 +000038
Martin v. Löwis95292d62002-12-11 14:04:59 +000039PyAPI_FUNC(node *) PyParser_ParseString(const char *, grammar *, int,
Fred Drake5eb6d4e2000-07-08 23:37:28 +000040 perrdetail *);
Martin v. Löwis95292d62002-12-11 14:04:59 +000041PyAPI_FUNC(node *) PyParser_ParseFile (FILE *, const char *, grammar *, int,
Serhiy Storchakac6792272013-10-19 21:03:34 +030042 const char *, const char *,
43 perrdetail *);
Guido van Rossuma3309961993-07-28 09:05:47 +000044
Martin v. Löwis95292d62002-12-11 14:04:59 +000045PyAPI_FUNC(node *) PyParser_ParseStringFlags(const char *, grammar *, int,
Tim Petersfe2127d2001-07-16 05:37:24 +000046 perrdetail *, int);
Victor Stinner14e461d2013-08-26 22:28:21 +020047PyAPI_FUNC(node *) PyParser_ParseFileFlags(
48 FILE *fp,
49 const char *filename, /* decoded from the filesystem encoding */
50 const char *enc,
51 grammar *g,
52 int start,
Serhiy Storchakac6792272013-10-19 21:03:34 +030053 const char *ps1,
54 const char *ps2,
Victor Stinner14e461d2013-08-26 22:28:21 +020055 perrdetail *err_ret,
56 int flags);
Victor Stinner00676d12010-12-27 01:49:31 +000057PyAPI_FUNC(node *) PyParser_ParseFileFlagsEx(
58 FILE *fp,
59 const char *filename, /* decoded from the filesystem encoding */
60 const char *enc,
61 grammar *g,
62 int start,
Serhiy Storchakac6792272013-10-19 21:03:34 +030063 const char *ps1,
64 const char *ps2,
Victor Stinner00676d12010-12-27 01:49:31 +000065 perrdetail *err_ret,
66 int *flags);
Victor Stinner14e461d2013-08-26 22:28:21 +020067PyAPI_FUNC(node *) PyParser_ParseFileObject(
68 FILE *fp,
69 PyObject *filename,
70 const char *enc,
71 grammar *g,
72 int start,
Serhiy Storchakac6792272013-10-19 21:03:34 +030073 const char *ps1,
74 const char *ps2,
Victor Stinner14e461d2013-08-26 22:28:21 +020075 perrdetail *err_ret,
76 int *flags);
Tim Petersfe2127d2001-07-16 05:37:24 +000077
Victor Stinner14e461d2013-08-26 22:28:21 +020078PyAPI_FUNC(node *) PyParser_ParseStringFlagsFilename(
79 const char *s,
80 const char *filename, /* decoded from the filesystem encoding */
81 grammar *g,
82 int start,
83 perrdetail *err_ret,
84 int flags);
Victor Stinner00676d12010-12-27 01:49:31 +000085PyAPI_FUNC(node *) PyParser_ParseStringFlagsFilenameEx(
86 const char *s,
87 const char *filename, /* decoded from the filesystem encoding */
88 grammar *g,
89 int start,
90 perrdetail *err_ret,
91 int *flags);
Victor Stinner14e461d2013-08-26 22:28:21 +020092PyAPI_FUNC(node *) PyParser_ParseStringObject(
93 const char *s,
94 PyObject *filename,
95 grammar *g,
96 int start,
97 perrdetail *err_ret,
98 int *flags);
Guido van Rossumd3ab37f2003-04-17 14:55:42 +000099
Victor Stinner7f2fee32011-04-05 00:39:01 +0200100/* Note that the following functions are defined in pythonrun.c,
101 not in parsetok.c */
Guido van Rossumd3ab37f2003-04-17 14:55:42 +0000102PyAPI_FUNC(void) PyParser_SetError(perrdetail *);
Victor Stinner7f2fee32011-04-05 00:39:01 +0200103PyAPI_FUNC(void) PyParser_ClearError(perrdetail *);
Guido van Rossumd3ab37f2003-04-17 14:55:42 +0000104
Guido van Rossuma3309961993-07-28 09:05:47 +0000105#ifdef __cplusplus
106}
107#endif
108#endif /* !Py_PARSETOK_H */
Martin v. Löwis4d0d4712010-12-03 20:14:31 +0000109#endif /* !Py_LIMITED_API */