Home | History | Annotate | Download | only in Include
      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