pythonrun.h 6.48 KB
Newer Older
1

Guido van Rossum's avatar
Guido van Rossum committed
2 3
/* Interfaces to parse and execute pieces of python code */

4 5 6 7 8 9
#ifndef Py_PYTHONRUN_H
#define Py_PYTHONRUN_H
#ifdef __cplusplus
extern "C" {
#endif

10 11
#define PyCF_MASK 0
#define PyCF_MASK_OBSOLETE 0
12
#define PyCF_SOURCE_IS_UTF8  0x0100
13
#define PyCF_DONT_IMPLY_DEDENT 0x0200
14
#define PyCF_ONLY_AST 0x0400
15

16
typedef struct {
17
	int cf_flags;  /* bitmask of CO_xxx flags relevant to future */
18 19
} PyCompilerFlags;

20 21
PyAPI_FUNC(void) Py_SetProgramName(wchar_t *);
PyAPI_FUNC(wchar_t *) Py_GetProgramName(void);
22

23 24
PyAPI_FUNC(void) Py_SetPythonHome(wchar_t *);
PyAPI_FUNC(wchar_t *) Py_GetPythonHome(void);
25 26

PyAPI_FUNC(void) Py_Initialize(void);
27
PyAPI_FUNC(void) Py_InitializeEx(int);
28 29 30 31 32
PyAPI_FUNC(void) Py_Finalize(void);
PyAPI_FUNC(int) Py_IsInitialized(void);
PyAPI_FUNC(PyThreadState *) Py_NewInterpreter(void);
PyAPI_FUNC(void) Py_EndInterpreter(PyThreadState *);

33 34
PyAPI_FUNC(int) PyRun_AnyFileFlags(FILE *, const char *, PyCompilerFlags *);
PyAPI_FUNC(int) PyRun_AnyFileExFlags(FILE *, const char *, int, PyCompilerFlags *);
35 36 37 38 39
PyAPI_FUNC(int) PyRun_SimpleStringFlags(const char *, PyCompilerFlags *);
PyAPI_FUNC(int) PyRun_SimpleFileExFlags(FILE *, const char *, int, PyCompilerFlags *);
PyAPI_FUNC(int) PyRun_InteractiveOneFlags(FILE *, const char *, PyCompilerFlags *);
PyAPI_FUNC(int) PyRun_InteractiveLoopFlags(FILE *, const char *, PyCompilerFlags *);

Jeremy Hylton's avatar
Jeremy Hylton committed
40
PyAPI_FUNC(struct _mod *) PyParser_ASTFromString(const char *, const char *, 
41 42
						 int, PyCompilerFlags *flags,
                                                 PyArena *);
43 44
PyAPI_FUNC(struct _mod *) PyParser_ASTFromFile(FILE *, const char *, 
					       const char*, int, 
Jeremy Hylton's avatar
Jeremy Hylton committed
45
					       char *, char *,
46 47
                                               PyCompilerFlags *, int *,
                                               PyArena *);
Jeremy Hylton's avatar
Jeremy Hylton committed
48 49 50 51 52 53
#define PyParser_SimpleParseString(S, B) \
        PyParser_SimpleParseStringFlags(S, B, 0)
#define PyParser_SimpleParseFile(FP, S, B) \
        PyParser_SimpleParseFileFlags(FP, S, B, 0)
PyAPI_FUNC(struct _node *) PyParser_SimpleParseStringFlags(const char *, int, 
							  int);
54
PyAPI_FUNC(struct _node *) PyParser_SimpleParseFileFlags(FILE *, const char *,
55
							int, int);
Guido van Rossum's avatar
Guido van Rossum committed
56

Jeremy Hylton's avatar
Jeremy Hylton committed
57 58 59 60 61 62 63 64
PyAPI_FUNC(PyObject *) PyRun_StringFlags(const char *, int, PyObject *, 
					 PyObject *, PyCompilerFlags *);

PyAPI_FUNC(PyObject *) PyRun_FileExFlags(FILE *, const char *, int, 
					 PyObject *, PyObject *, int, 
					 PyCompilerFlags *);

#define Py_CompileString(str, p, s) Py_CompileStringFlags(str, p, s, NULL)
65
PyAPI_FUNC(PyObject *) Py_CompileStringFlags(const char *, const char *, int,
Jeremy Hylton's avatar
Jeremy Hylton committed
66
					     PyCompilerFlags *);
67
PyAPI_FUNC(struct symtable *) Py_SymtableString(const char *, const char *, int);
68

69 70 71
PyAPI_FUNC(void) PyErr_Print(void);
PyAPI_FUNC(void) PyErr_PrintEx(int);
PyAPI_FUNC(void) PyErr_Display(PyObject *, PyObject *, PyObject *);
Guido van Rossum's avatar
Guido van Rossum committed
72

73 74 75 76
/* Py_PyAtExit is for the atexit module, Py_AtExit is for low-level
 * exit functions.
 */
PyAPI_FUNC(void) _Py_PyAtExit(void (*func)(void));
77
PyAPI_FUNC(int) Py_AtExit(void (*func)(void));
78

79
PyAPI_FUNC(void) Py_Exit(int);
80

81
PyAPI_FUNC(int) Py_FdIsInteractive(FILE *, const char *);
82

83
/* Bootstrap */
84
PyAPI_FUNC(int) Py_Main(int argc, wchar_t **argv);
85

Jeremy Hylton's avatar
Jeremy Hylton committed
86 87 88 89 90 91 92
/* Use macros for a bunch of old variants */
#define PyRun_String(str, s, g, l) PyRun_StringFlags(str, s, g, l, NULL)
#define PyRun_AnyFile(fp, name) PyRun_AnyFileExFlags(fp, name, 0, NULL)
#define PyRun_AnyFileEx(fp, name, closeit) \
	PyRun_AnyFileExFlags(fp, name, closeit, NULL)
#define PyRun_AnyFileFlags(fp, name, flags) \
	PyRun_AnyFileExFlags(fp, name, 0, flags)
93
#define PyRun_SimpleString(s) PyRun_SimpleStringFlags(s, NULL)
Jeremy Hylton's avatar
Jeremy Hylton committed
94 95 96 97 98 99 100 101 102 103 104
#define PyRun_SimpleFile(f, p) PyRun_SimpleFileExFlags(f, p, 0, NULL)
#define PyRun_SimpleFileEx(f, p, c) PyRun_SimpleFileExFlags(f, p, c, NULL)
#define PyRun_InteractiveOne(f, p) PyRun_InteractiveOneFlags(f, p, NULL)
#define PyRun_InteractiveLoop(f, p) PyRun_InteractiveLoopFlags(f, p, NULL)
#define PyRun_File(fp, p, s, g, l) \
        PyRun_FileExFlags(fp, p, s, g, l, 0, NULL)
#define PyRun_FileEx(fp, p, s, g, l, c) \
        PyRun_FileExFlags(fp, p, s, g, l, c, NULL)
#define PyRun_FileFlags(fp, p, s, g, l, flags) \
        PyRun_FileExFlags(fp, p, s, g, l, 0, flags)

105
/* In getpath.c */
106 107 108 109
PyAPI_FUNC(wchar_t *) Py_GetProgramFullPath(void);
PyAPI_FUNC(wchar_t *) Py_GetPrefix(void);
PyAPI_FUNC(wchar_t *) Py_GetExecPrefix(void);
PyAPI_FUNC(wchar_t *) Py_GetPath(void);
110 111

/* In their own files */
112 113 114 115 116
PyAPI_FUNC(const char *) Py_GetVersion(void);
PyAPI_FUNC(const char *) Py_GetPlatform(void);
PyAPI_FUNC(const char *) Py_GetCopyright(void);
PyAPI_FUNC(const char *) Py_GetCompiler(void);
PyAPI_FUNC(const char *) Py_GetBuildInfo(void);
117 118 119
PyAPI_FUNC(const char *) _Py_svnversion(void);
PyAPI_FUNC(const char *) Py_SubversionRevision(void);
PyAPI_FUNC(const char *) Py_SubversionShortBranch(void);
120

121
/* Internal -- various one-time initializations */
122 123 124
PyAPI_FUNC(PyObject *) _PyBuiltin_Init(void);
PyAPI_FUNC(PyObject *) _PySys_Init(void);
PyAPI_FUNC(void) _PyImport_Init(void);
125
PyAPI_FUNC(void) _PyExc_Init(void);
Just van Rossum's avatar
Just van Rossum committed
126
PyAPI_FUNC(void) _PyImportHooks_Init(void);
127
PyAPI_FUNC(int) _PyFrame_Init(void);
Michael W. Hudson's avatar
Michael W. Hudson committed
128
PyAPI_FUNC(void) _PyFloat_Init(void);
129
PyAPI_FUNC(int) PyByteArray_Init(void);
130

131
/* Various internal finalizers */
132 133 134 135 136
PyAPI_FUNC(void) _PyExc_Fini(void);
PyAPI_FUNC(void) _PyImport_Fini(void);
PyAPI_FUNC(void) PyMethod_Fini(void);
PyAPI_FUNC(void) PyFrame_Fini(void);
PyAPI_FUNC(void) PyCFunction_Fini(void);
Christian Heimes's avatar
Christian Heimes committed
137
PyAPI_FUNC(void) PyDict_Fini(void);
138
PyAPI_FUNC(void) PyTuple_Fini(void);
139
PyAPI_FUNC(void) PyList_Fini(void);
140
PyAPI_FUNC(void) PySet_Fini(void);
141
PyAPI_FUNC(void) PyBytes_Fini(void);
142
PyAPI_FUNC(void) PyByteArray_Fini(void);
143 144
PyAPI_FUNC(void) PyFloat_Fini(void);
PyAPI_FUNC(void) PyOS_FiniInterrupts(void);
145

146
/* Stuff with no proper home (yet) */
147
PyAPI_FUNC(char *) PyOS_Readline(FILE *, FILE *, char *);
148
PyAPI_DATA(int) (*PyOS_InputHook)(void);
149
PyAPI_DATA(char) *(*PyOS_ReadlineFunctionPointer)(FILE *, FILE *, char *);
150
PyAPI_DATA(PyThreadState*) _PyOS_ReadlineTState;
151 152 153 154 155 156

/* Stack size, in "pointers" (so we get extra safety margins
   on 64-bit platforms).  On a 32-bit platform, this translates
   to a 8k margin. */
#define PYOS_STACK_MARGIN 2048

157
#if defined(WIN32) && !defined(MS_WIN64) && defined(_MSC_VER) && _MSC_VER >= 1300
158 159 160 161
/* Enable stack checking under Microsoft C */
#define USE_STACKCHECK
#endif

162
#ifdef USE_STACKCHECK
163
/* Check that we aren't overflowing our stack */
164
PyAPI_FUNC(int) PyOS_CheckStack(void);
165
#endif
166

167 168
/* Signals */
typedef void (*PyOS_sighandler_t)(int);
169 170
PyAPI_FUNC(PyOS_sighandler_t) PyOS_getsig(int);
PyAPI_FUNC(PyOS_sighandler_t) PyOS_setsig(int, PyOS_sighandler_t);
171 172


173 174 175 176
#ifdef __cplusplus
}
#endif
#endif /* !Py_PYTHONRUN_H */