• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 #ifndef Py_COMPILE_H
2 #define Py_COMPILE_H
3 
4 #ifndef Py_LIMITED_API
5 #include "code.h"
6 
7 #ifdef __cplusplus
8 extern "C" {
9 #endif
10 
11 /* Public interface */
12 struct _node; /* Declare the existence of this type */
13 PyAPI_FUNC(PyCodeObject *) PyNode_Compile(struct _node *, const char *);
14 /* XXX (ncoghlan): Unprefixed type name in a public API! */
15 
16 #define PyCF_MASK (CO_FUTURE_DIVISION | CO_FUTURE_ABSOLUTE_IMPORT | \
17                    CO_FUTURE_WITH_STATEMENT | CO_FUTURE_PRINT_FUNCTION | \
18                    CO_FUTURE_UNICODE_LITERALS | CO_FUTURE_BARRY_AS_BDFL | \
19                    CO_FUTURE_GENERATOR_STOP | CO_FUTURE_ANNOTATIONS)
20 #define PyCF_MASK_OBSOLETE (CO_NESTED)
21 #define PyCF_SOURCE_IS_UTF8  0x0100
22 #define PyCF_DONT_IMPLY_DEDENT 0x0200
23 #define PyCF_ONLY_AST 0x0400
24 #define PyCF_IGNORE_COOKIE 0x0800
25 
26 #ifndef Py_LIMITED_API
27 typedef struct {
28     int cf_flags;  /* bitmask of CO_xxx flags relevant to future */
29 } PyCompilerFlags;
30 #endif
31 
32 /* Future feature support */
33 
34 typedef struct {
35     int ff_features;      /* flags set by future statements */
36     int ff_lineno;        /* line number of last future statement */
37 } PyFutureFeatures;
38 
39 #define FUTURE_NESTED_SCOPES "nested_scopes"
40 #define FUTURE_GENERATORS "generators"
41 #define FUTURE_DIVISION "division"
42 #define FUTURE_ABSOLUTE_IMPORT "absolute_import"
43 #define FUTURE_WITH_STATEMENT "with_statement"
44 #define FUTURE_PRINT_FUNCTION "print_function"
45 #define FUTURE_UNICODE_LITERALS "unicode_literals"
46 #define FUTURE_BARRY_AS_BDFL "barry_as_FLUFL"
47 #define FUTURE_GENERATOR_STOP "generator_stop"
48 #define FUTURE_ANNOTATIONS "annotations"
49 
50 struct _mod; /* Declare the existence of this type */
51 #define PyAST_Compile(mod, s, f, ar) PyAST_CompileEx(mod, s, f, -1, ar)
52 PyAPI_FUNC(PyCodeObject *) PyAST_CompileEx(
53     struct _mod *mod,
54     const char *filename,       /* decoded from the filesystem encoding */
55     PyCompilerFlags *flags,
56     int optimize,
57     PyArena *arena);
58 PyAPI_FUNC(PyCodeObject *) PyAST_CompileObject(
59     struct _mod *mod,
60     PyObject *filename,
61     PyCompilerFlags *flags,
62     int optimize,
63     PyArena *arena);
64 PyAPI_FUNC(PyFutureFeatures *) PyFuture_FromAST(
65     struct _mod * mod,
66     const char *filename        /* decoded from the filesystem encoding */
67     );
68 PyAPI_FUNC(PyFutureFeatures *) PyFuture_FromASTObject(
69     struct _mod * mod,
70     PyObject *filename
71     );
72 
73 /* _Py_Mangle is defined in compile.c */
74 PyAPI_FUNC(PyObject*) _Py_Mangle(PyObject *p, PyObject *name);
75 
76 #define PY_INVALID_STACK_EFFECT INT_MAX
77 PyAPI_FUNC(int) PyCompile_OpcodeStackEffect(int opcode, int oparg);
78 
79 PyAPI_FUNC(int) _PyAST_Optimize(struct _mod *, PyArena *arena, int optimize);
80 
81 #ifdef __cplusplus
82 }
83 #endif
84 
85 #endif /* !Py_LIMITED_API */
86 
87 /* These definitions must match corresponding definitions in graminit.h.
88    There's code in compile.c that checks that they are the same. */
89 #define Py_single_input 256
90 #define Py_file_input 257
91 #define Py_eval_input 258
92 
93 #endif /* !Py_COMPILE_H */
94