Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 1 | #ifndef Py_COMPILE_H |
| 2 | #define Py_COMPILE_H |
Thomas Wouters | ca82a8b | 2006-02-28 23:09:08 +0000 | [diff] [blame] | 3 | |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 4 | #ifndef Py_LIMITED_API |
Thomas Wouters | ca82a8b | 2006-02-28 23:09:08 +0000 | [diff] [blame] | 5 | |
Fred Drake | ea9cb5a | 2000-07-09 00:20:36 +0000 | [diff] [blame] | 6 | #ifdef __cplusplus |
| 7 | extern "C" { |
| 8 | #endif |
| 9 | |
Guido van Rossum | 3f5da24 | 1990-12-20 15:06:42 +0000 | [diff] [blame] | 10 | /* Public interface */ |
Guido van Rossum | e543a94 | 1991-04-03 19:00:55 +0000 | [diff] [blame] | 11 | struct _node; /* Declare the existence of this type */ |
Martin v. Löwis | 95292d6 | 2002-12-11 14:04:59 +0000 | [diff] [blame] | 12 | PyAPI_FUNC(PyCodeObject *) PyNode_Compile(struct _node *, const char *); |
Eric Snow | 6b4be19 | 2017-05-22 21:36:03 -0700 | [diff] [blame] | 13 | /* XXX (ncoghlan): Unprefixed type name in a public API! */ |
| 14 | |
| 15 | #define PyCF_MASK (CO_FUTURE_DIVISION | CO_FUTURE_ABSOLUTE_IMPORT | \ |
| 16 | CO_FUTURE_WITH_STATEMENT | CO_FUTURE_PRINT_FUNCTION | \ |
| 17 | CO_FUTURE_UNICODE_LITERALS | CO_FUTURE_BARRY_AS_BDFL | \ |
Guido van Rossum | 95e4d58 | 2018-01-26 08:20:18 -0800 | [diff] [blame] | 18 | CO_FUTURE_GENERATOR_STOP | CO_FUTURE_ANNOTATIONS) |
Eric Snow | 6b4be19 | 2017-05-22 21:36:03 -0700 | [diff] [blame] | 19 | #define PyCF_MASK_OBSOLETE (CO_NESTED) |
Batuhan Taşkaya | 4454057 | 2020-04-22 19:09:03 +0300 | [diff] [blame] | 20 | |
| 21 | /* bpo-39562: CO_FUTURE_ and PyCF_ constants must be kept unique. |
| 22 | PyCF_ constants can use bits from 0x0100 to 0x10000. |
| 23 | CO_FUTURE_ constants use bits starting at 0x20000. */ |
Eric Snow | 6b4be19 | 2017-05-22 21:36:03 -0700 | [diff] [blame] | 24 | #define PyCF_SOURCE_IS_UTF8 0x0100 |
| 25 | #define PyCF_DONT_IMPLY_DEDENT 0x0200 |
| 26 | #define PyCF_ONLY_AST 0x0400 |
| 27 | #define PyCF_IGNORE_COOKIE 0x0800 |
Guido van Rossum | dcfcd14 | 2019-01-31 03:40:27 -0800 | [diff] [blame] | 28 | #define PyCF_TYPE_COMMENTS 0x1000 |
Matthias Bussonnier | 565b4f1 | 2019-05-21 13:12:03 -0700 | [diff] [blame] | 29 | #define PyCF_ALLOW_TOP_LEVEL_AWAIT 0x2000 |
Batuhan Taşkaya | 4454057 | 2020-04-22 19:09:03 +0300 | [diff] [blame] | 30 | #define PyCF_COMPILE_MASK (PyCF_ONLY_AST | PyCF_ALLOW_TOP_LEVEL_AWAIT | \ |
| 31 | PyCF_TYPE_COMMENTS | PyCF_DONT_IMPLY_DEDENT) |
Eric Snow | 6b4be19 | 2017-05-22 21:36:03 -0700 | [diff] [blame] | 32 | |
| 33 | #ifndef Py_LIMITED_API |
| 34 | typedef struct { |
| 35 | int cf_flags; /* bitmask of CO_xxx flags relevant to future */ |
Guido van Rossum | 495da29 | 2019-03-07 12:38:08 -0800 | [diff] [blame] | 36 | int cf_feature_version; /* minor Python version (PyCF_ONLY_AST) */ |
Eric Snow | 6b4be19 | 2017-05-22 21:36:03 -0700 | [diff] [blame] | 37 | } PyCompilerFlags; |
Victor Stinner | 37d66d7 | 2019-06-13 02:16:41 +0200 | [diff] [blame] | 38 | |
| 39 | #define _PyCompilerFlags_INIT \ |
| 40 | (PyCompilerFlags){.cf_flags = 0, .cf_feature_version = PY_MINOR_VERSION} |
Eric Snow | 6b4be19 | 2017-05-22 21:36:03 -0700 | [diff] [blame] | 41 | #endif |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 42 | |
Jeremy Hylton | 4db62b1 | 2001-02-27 19:07:02 +0000 | [diff] [blame] | 43 | /* Future feature support */ |
| 44 | |
| 45 | typedef struct { |
Jeremy Hylton | 3e0055f | 2005-10-20 19:59:25 +0000 | [diff] [blame] | 46 | int ff_features; /* flags set by future statements */ |
| 47 | int ff_lineno; /* line number of last future statement */ |
Jeremy Hylton | 4db62b1 | 2001-02-27 19:07:02 +0000 | [diff] [blame] | 48 | } PyFutureFeatures; |
| 49 | |
Jeremy Hylton | 4db62b1 | 2001-02-27 19:07:02 +0000 | [diff] [blame] | 50 | #define FUTURE_NESTED_SCOPES "nested_scopes" |
Guido van Rossum | b09f7ed | 2001-07-15 21:08:29 +0000 | [diff] [blame] | 51 | #define FUTURE_GENERATORS "generators" |
Guido van Rossum | 4668b00 | 2001-08-08 05:00:18 +0000 | [diff] [blame] | 52 | #define FUTURE_DIVISION "division" |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 53 | #define FUTURE_ABSOLUTE_IMPORT "absolute_import" |
Thomas Wouters | 34aa7ba | 2006-02-28 19:02:24 +0000 | [diff] [blame] | 54 | #define FUTURE_WITH_STATEMENT "with_statement" |
Eric Smith | 8782408 | 2008-03-20 23:02:08 +0000 | [diff] [blame] | 55 | #define FUTURE_PRINT_FUNCTION "print_function" |
Christian Heimes | 4d6ec85 | 2008-03-26 22:34:47 +0000 | [diff] [blame] | 56 | #define FUTURE_UNICODE_LITERALS "unicode_literals" |
Brett Cannon | e3944a5 | 2009-04-01 05:08:41 +0000 | [diff] [blame] | 57 | #define FUTURE_BARRY_AS_BDFL "barry_as_FLUFL" |
Yury Selivanov | 8170e8c | 2015-05-09 11:44:30 -0400 | [diff] [blame] | 58 | #define FUTURE_GENERATOR_STOP "generator_stop" |
Guido van Rossum | 95e4d58 | 2018-01-26 08:20:18 -0800 | [diff] [blame] | 59 | #define FUTURE_ANNOTATIONS "annotations" |
Guido van Rossum | 4668b00 | 2001-08-08 05:00:18 +0000 | [diff] [blame] | 60 | |
Jeremy Hylton | 3e0055f | 2005-10-20 19:59:25 +0000 | [diff] [blame] | 61 | struct _mod; /* Declare the existence of this type */ |
Georg Brandl | 8334fd9 | 2010-12-04 10:26:46 +0000 | [diff] [blame] | 62 | #define PyAST_Compile(mod, s, f, ar) PyAST_CompileEx(mod, s, f, -1, ar) |
Victor Stinner | 00676d1 | 2010-12-27 01:49:31 +0000 | [diff] [blame] | 63 | PyAPI_FUNC(PyCodeObject *) PyAST_CompileEx( |
Victor Stinner | 0d71116 | 2010-12-27 02:39:20 +0000 | [diff] [blame] | 64 | struct _mod *mod, |
Victor Stinner | 00676d1 | 2010-12-27 01:49:31 +0000 | [diff] [blame] | 65 | const char *filename, /* decoded from the filesystem encoding */ |
| 66 | PyCompilerFlags *flags, |
| 67 | int optimize, |
| 68 | PyArena *arena); |
Victor Stinner | 14e461d | 2013-08-26 22:28:21 +0200 | [diff] [blame] | 69 | PyAPI_FUNC(PyCodeObject *) PyAST_CompileObject( |
| 70 | struct _mod *mod, |
| 71 | PyObject *filename, |
| 72 | PyCompilerFlags *flags, |
| 73 | int optimize, |
| 74 | PyArena *arena); |
| 75 | PyAPI_FUNC(PyFutureFeatures *) PyFuture_FromAST( |
| 76 | struct _mod * mod, |
| 77 | const char *filename /* decoded from the filesystem encoding */ |
| 78 | ); |
| 79 | PyAPI_FUNC(PyFutureFeatures *) PyFuture_FromASTObject( |
| 80 | struct _mod * mod, |
| 81 | PyObject *filename |
| 82 | ); |
Jeremy Hylton | 3e0055f | 2005-10-20 19:59:25 +0000 | [diff] [blame] | 83 | |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 84 | /* _Py_Mangle is defined in compile.c */ |
| 85 | PyAPI_FUNC(PyObject*) _Py_Mangle(PyObject *p, PyObject *name); |
Jeremy Hylton | 3e0055f | 2005-10-20 19:59:25 +0000 | [diff] [blame] | 86 | |
Larry Hastings | 3a90797 | 2013-11-23 14:49:22 -0800 | [diff] [blame] | 87 | #define PY_INVALID_STACK_EFFECT INT_MAX |
| 88 | PyAPI_FUNC(int) PyCompile_OpcodeStackEffect(int opcode, int oparg); |
Serhiy Storchaka | 7bdf282 | 2018-09-18 09:54:26 +0300 | [diff] [blame] | 89 | PyAPI_FUNC(int) PyCompile_OpcodeStackEffectWithJump(int opcode, int oparg, int jump); |
Larry Hastings | 3a90797 | 2013-11-23 14:49:22 -0800 | [diff] [blame] | 90 | |
Pablo Galindo | d112c60 | 2020-03-18 23:02:09 +0000 | [diff] [blame] | 91 | typedef struct { |
| 92 | int optimize; |
| 93 | int ff_features; |
| 94 | } _PyASTOptimizeState; |
| 95 | |
| 96 | PyAPI_FUNC(int) _PyAST_Optimize(struct _mod *, PyArena *arena, _PyASTOptimizeState *state); |
INADA Naoki | 7ea143a | 2017-12-14 16:47:20 +0900 | [diff] [blame] | 97 | |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 98 | #ifdef __cplusplus |
| 99 | } |
| 100 | #endif |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 101 | |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 102 | #endif /* !Py_LIMITED_API */ |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 103 | |
Guido van Rossum | dcfcd14 | 2019-01-31 03:40:27 -0800 | [diff] [blame] | 104 | /* These definitions must match corresponding definitions in graminit.h. */ |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 105 | #define Py_single_input 256 |
| 106 | #define Py_file_input 257 |
| 107 | #define Py_eval_input 258 |
Guido van Rossum | dcfcd14 | 2019-01-31 03:40:27 -0800 | [diff] [blame] | 108 | #define Py_func_type_input 345 |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 109 | |
Pablo Galindo | c5fc156 | 2020-04-22 23:29:27 +0100 | [diff] [blame] | 110 | /* This doesn't need to match anything */ |
| 111 | #define Py_fstring_input 800 |
| 112 | |
Victor Stinner | 2bdc7f5 | 2011-09-29 01:04:08 +0200 | [diff] [blame] | 113 | #endif /* !Py_COMPILE_H */ |