pythonrun.h 6.57 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
#define PyCF_MASK (CO_FUTURE_DIVISION | CO_FUTURE_ABSOLUTE_IMPORT | \
11 12
                   CO_FUTURE_WITH_STATEMENT | CO_FUTURE_PRINT_FUNCTION | \
                   CO_FUTURE_UNICODE_LITERALS)
13
#define PyCF_MASK_OBSOLETE (CO_NESTED)
14
#define PyCF_SOURCE_IS_UTF8  0x0100
15
#define PyCF_DONT_IMPLY_DEDENT 0x0200
16
#define PyCF_ONLY_AST 0x0400
17

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

22 23 24 25 26 27 28
PyAPI_FUNC(void) Py_SetProgramName(char *);
PyAPI_FUNC(char *) Py_GetProgramName(void);

PyAPI_FUNC(void) Py_SetPythonHome(char *);
PyAPI_FUNC(char *) Py_GetPythonHome(void);

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

35 36
PyAPI_FUNC(int) PyRun_AnyFileFlags(FILE *, const char *, PyCompilerFlags *);
PyAPI_FUNC(int) PyRun_AnyFileExFlags(FILE *, const char *, int, PyCompilerFlags *);
37 38 39 40 41
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
42
PyAPI_FUNC(struct _mod *) PyParser_ASTFromString(const char *, const char *, 
43 44
						 int, PyCompilerFlags *flags,
                                                 PyArena *);
Jeremy Hylton's avatar
Jeremy Hylton committed
45 46
PyAPI_FUNC(struct _mod *) PyParser_ASTFromFile(FILE *, const char *, int, 
					       char *, char *,
47 48
                                               PyCompilerFlags *, int *,
                                               PyArena *);
Jeremy Hylton's avatar
Jeremy Hylton committed
49 50 51 52 53 54
#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);
55
PyAPI_FUNC(struct _node *) PyParser_SimpleParseFileFlags(FILE *, const char *,
56
							int, int);
Guido van Rossum's avatar
Guido van Rossum committed
57

Jeremy Hylton's avatar
Jeremy Hylton committed
58 59 60 61 62 63 64 65
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)
66
PyAPI_FUNC(PyObject *) Py_CompileStringFlags(const char *, const char *, int,
Jeremy Hylton's avatar
Jeremy Hylton committed
67
					     PyCompilerFlags *);
68
PyAPI_FUNC(struct symtable *) Py_SymtableString(const char *, const char *, int);
69

70 71 72
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
73

74
PyAPI_FUNC(int) Py_AtExit(void (*func)(void));
75

76
PyAPI_FUNC(void) Py_Exit(int);
77

78
PyAPI_FUNC(int) Py_FdIsInteractive(FILE *, const char *);
79

80 81 82
/* Bootstrap */
PyAPI_FUNC(int) Py_Main(int argc, char **argv);

Jeremy Hylton's avatar
Jeremy Hylton committed
83 84 85 86 87 88 89
/* 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)
90
#define PyRun_SimpleString(s) PyRun_SimpleStringFlags(s, NULL)
Jeremy Hylton's avatar
Jeremy Hylton committed
91 92 93 94 95 96 97 98 99 100 101
#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)

102
/* In getpath.c */
103 104 105 106
PyAPI_FUNC(char *) Py_GetProgramFullPath(void);
PyAPI_FUNC(char *) Py_GetPrefix(void);
PyAPI_FUNC(char *) Py_GetExecPrefix(void);
PyAPI_FUNC(char *) Py_GetPath(void);
107 108

/* In their own files */
109 110 111 112 113
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);
114 115 116
PyAPI_FUNC(const char *) _Py_svnversion(void);
PyAPI_FUNC(const char *) Py_SubversionRevision(void);
PyAPI_FUNC(const char *) Py_SubversionShortBranch(void);
117

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

130
/* Various internal finalizers */
131 132 133 134 135
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);
136
PyAPI_FUNC(void) PyDict_Fini(void);
137
PyAPI_FUNC(void) PyTuple_Fini(void);
138
PyAPI_FUNC(void) PyList_Fini(void);
139
PyAPI_FUNC(void) PySet_Fini(void);
140
PyAPI_FUNC(void) PyString_Fini(void);
141 142 143
PyAPI_FUNC(void) PyInt_Fini(void);
PyAPI_FUNC(void) PyFloat_Fini(void);
PyAPI_FUNC(void) PyOS_FiniInterrupts(void);
144
PyAPI_FUNC(void) PyByteArray_Fini(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 */