mirror of
https://github.com/python/cpython.git
synced 2024-11-25 02:44:06 +08:00
305 lines
9.9 KiB
C
305 lines
9.9 KiB
C
|
|
/* Interfaces to parse and execute pieces of python code */
|
|
|
|
#ifndef Py_PYTHONRUN_H
|
|
#define Py_PYTHONRUN_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define PyCF_MASK (CO_FUTURE_DIVISION | CO_FUTURE_ABSOLUTE_IMPORT | \
|
|
CO_FUTURE_WITH_STATEMENT | CO_FUTURE_PRINT_FUNCTION | \
|
|
CO_FUTURE_UNICODE_LITERALS | CO_FUTURE_BARRY_AS_BDFL)
|
|
#define PyCF_MASK_OBSOLETE (CO_NESTED)
|
|
#define PyCF_SOURCE_IS_UTF8 0x0100
|
|
#define PyCF_DONT_IMPLY_DEDENT 0x0200
|
|
#define PyCF_ONLY_AST 0x0400
|
|
#define PyCF_IGNORE_COOKIE 0x0800
|
|
|
|
#ifndef Py_LIMITED_API
|
|
typedef struct {
|
|
int cf_flags; /* bitmask of CO_xxx flags relevant to future */
|
|
} PyCompilerFlags;
|
|
#endif
|
|
|
|
PyAPI_FUNC(void) Py_SetProgramName(wchar_t *);
|
|
PyAPI_FUNC(wchar_t *) Py_GetProgramName(void);
|
|
|
|
PyAPI_FUNC(void) Py_SetPythonHome(wchar_t *);
|
|
PyAPI_FUNC(wchar_t *) Py_GetPythonHome(void);
|
|
|
|
#ifndef Py_LIMITED_API
|
|
/* Only used by applications that embed the interpreter and need to
|
|
* override the standard encoding determination mechanism
|
|
*/
|
|
PyAPI_FUNC(int) Py_SetStandardStreamEncoding(const char *encoding,
|
|
const char *errors);
|
|
#endif
|
|
|
|
PyAPI_FUNC(void) Py_Initialize(void);
|
|
PyAPI_FUNC(void) Py_InitializeEx(int);
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(void) _Py_InitializeEx_Private(int, int);
|
|
#endif
|
|
PyAPI_FUNC(void) Py_Finalize(void);
|
|
PyAPI_FUNC(int) Py_IsInitialized(void);
|
|
PyAPI_FUNC(PyThreadState *) Py_NewInterpreter(void);
|
|
PyAPI_FUNC(void) Py_EndInterpreter(PyThreadState *);
|
|
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(int) PyRun_SimpleStringFlags(const char *, PyCompilerFlags *);
|
|
PyAPI_FUNC(int) PyRun_AnyFileFlags(FILE *, const char *, PyCompilerFlags *);
|
|
PyAPI_FUNC(int) PyRun_AnyFileExFlags(
|
|
FILE *fp,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
int closeit,
|
|
PyCompilerFlags *flags);
|
|
PyAPI_FUNC(int) PyRun_SimpleFileExFlags(
|
|
FILE *fp,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
int closeit,
|
|
PyCompilerFlags *flags);
|
|
PyAPI_FUNC(int) PyRun_InteractiveOneFlags(
|
|
FILE *fp,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
PyCompilerFlags *flags);
|
|
PyAPI_FUNC(int) PyRun_InteractiveOneObject(
|
|
FILE *fp,
|
|
PyObject *filename,
|
|
PyCompilerFlags *flags);
|
|
PyAPI_FUNC(int) PyRun_InteractiveLoopFlags(
|
|
FILE *fp,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
PyCompilerFlags *flags);
|
|
|
|
PyAPI_FUNC(struct _mod *) PyParser_ASTFromString(
|
|
const char *s,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
int start,
|
|
PyCompilerFlags *flags,
|
|
PyArena *arena);
|
|
PyAPI_FUNC(struct _mod *) PyParser_ASTFromStringObject(
|
|
const char *s,
|
|
PyObject *filename,
|
|
int start,
|
|
PyCompilerFlags *flags,
|
|
PyArena *arena);
|
|
PyAPI_FUNC(struct _mod *) PyParser_ASTFromFile(
|
|
FILE *fp,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
const char* enc,
|
|
int start,
|
|
char *ps1,
|
|
char *ps2,
|
|
PyCompilerFlags *flags,
|
|
int *errcode,
|
|
PyArena *arena);
|
|
PyAPI_FUNC(struct _mod *) PyParser_ASTFromFileObject(
|
|
FILE *fp,
|
|
PyObject *filename,
|
|
const char* enc,
|
|
int start,
|
|
char *ps1,
|
|
char *ps2,
|
|
PyCompilerFlags *flags,
|
|
int *errcode,
|
|
PyArena *arena);
|
|
#endif
|
|
|
|
#ifndef PyParser_SimpleParseString
|
|
#define PyParser_SimpleParseString(S, B) \
|
|
PyParser_SimpleParseStringFlags(S, B, 0)
|
|
#define PyParser_SimpleParseFile(FP, S, B) \
|
|
PyParser_SimpleParseFileFlags(FP, S, B, 0)
|
|
#endif
|
|
PyAPI_FUNC(struct _node *) PyParser_SimpleParseStringFlags(const char *, int,
|
|
int);
|
|
PyAPI_FUNC(struct _node *) PyParser_SimpleParseStringFlagsFilename(const char *,
|
|
const char *,
|
|
int, int);
|
|
PyAPI_FUNC(struct _node *) PyParser_SimpleParseFileFlags(FILE *, const char *,
|
|
int, int);
|
|
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(PyObject *) PyRun_StringFlags(const char *, int, PyObject *,
|
|
PyObject *, PyCompilerFlags *);
|
|
|
|
PyAPI_FUNC(PyObject *) PyRun_FileExFlags(
|
|
FILE *fp,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
int start,
|
|
PyObject *globals,
|
|
PyObject *locals,
|
|
int closeit,
|
|
PyCompilerFlags *flags);
|
|
#endif
|
|
|
|
#ifdef Py_LIMITED_API
|
|
PyAPI_FUNC(PyObject *) Py_CompileString(const char *, const char *, int);
|
|
#else
|
|
#define Py_CompileString(str, p, s) Py_CompileStringExFlags(str, p, s, NULL, -1)
|
|
#define Py_CompileStringFlags(str, p, s, f) Py_CompileStringExFlags(str, p, s, f, -1)
|
|
PyAPI_FUNC(PyObject *) Py_CompileStringExFlags(
|
|
const char *str,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
int start,
|
|
PyCompilerFlags *flags,
|
|
int optimize);
|
|
PyAPI_FUNC(PyObject *) Py_CompileStringObject(
|
|
const char *str,
|
|
PyObject *filename, int start,
|
|
PyCompilerFlags *flags,
|
|
int optimize);
|
|
#endif
|
|
PyAPI_FUNC(struct symtable *) Py_SymtableString(
|
|
const char *str,
|
|
const char *filename, /* decoded from the filesystem encoding */
|
|
int start);
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(struct symtable *) Py_SymtableStringObject(
|
|
const char *str,
|
|
PyObject *filename,
|
|
int start);
|
|
#endif
|
|
|
|
PyAPI_FUNC(void) PyErr_Print(void);
|
|
PyAPI_FUNC(void) PyErr_PrintEx(int);
|
|
PyAPI_FUNC(void) PyErr_Display(PyObject *, PyObject *, PyObject *);
|
|
|
|
/* Py_PyAtExit is for the atexit module, Py_AtExit is for low-level
|
|
* exit functions.
|
|
*/
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(void) _Py_PyAtExit(void (*func)(void));
|
|
#endif
|
|
PyAPI_FUNC(int) Py_AtExit(void (*func)(void));
|
|
|
|
PyAPI_FUNC(void) Py_Exit(int);
|
|
|
|
/* Restore signals that the interpreter has called SIG_IGN on to SIG_DFL. */
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(void) _Py_RestoreSignals(void);
|
|
|
|
PyAPI_FUNC(int) Py_FdIsInteractive(FILE *, const char *);
|
|
#endif
|
|
|
|
/* Bootstrap */
|
|
PyAPI_FUNC(int) Py_Main(int argc, wchar_t **argv);
|
|
|
|
#ifndef Py_LIMITED_API
|
|
/* 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)
|
|
#define PyRun_SimpleString(s) PyRun_SimpleStringFlags(s, NULL)
|
|
#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)
|
|
#endif
|
|
|
|
/* In getpath.c */
|
|
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);
|
|
PyAPI_FUNC(void) Py_SetPath(const wchar_t *);
|
|
#ifdef MS_WINDOWS
|
|
int _Py_CheckPython3();
|
|
#endif
|
|
|
|
/* In their own files */
|
|
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);
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(const char *) _Py_hgidentifier(void);
|
|
PyAPI_FUNC(const char *) _Py_hgversion(void);
|
|
#endif
|
|
|
|
/* Internal -- various one-time initializations */
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(PyObject *) _PyBuiltin_Init(void);
|
|
PyAPI_FUNC(PyObject *) _PySys_Init(void);
|
|
PyAPI_FUNC(void) _PyImport_Init(void);
|
|
PyAPI_FUNC(void) _PyExc_Init(PyObject * bltinmod);
|
|
PyAPI_FUNC(void) _PyImportHooks_Init(void);
|
|
PyAPI_FUNC(int) _PyFrame_Init(void);
|
|
PyAPI_FUNC(int) _PyFloat_Init(void);
|
|
PyAPI_FUNC(int) PyByteArray_Init(void);
|
|
PyAPI_FUNC(void) _PyRandom_Init(void);
|
|
#endif
|
|
|
|
/* Various internal finalizers */
|
|
#ifndef Py_LIMITED_API
|
|
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);
|
|
PyAPI_FUNC(void) PyDict_Fini(void);
|
|
PyAPI_FUNC(void) PyTuple_Fini(void);
|
|
PyAPI_FUNC(void) PyList_Fini(void);
|
|
PyAPI_FUNC(void) PySet_Fini(void);
|
|
PyAPI_FUNC(void) PyBytes_Fini(void);
|
|
PyAPI_FUNC(void) PyByteArray_Fini(void);
|
|
PyAPI_FUNC(void) PyFloat_Fini(void);
|
|
PyAPI_FUNC(void) PyOS_FiniInterrupts(void);
|
|
PyAPI_FUNC(void) _PyGC_DumpShutdownStats(void);
|
|
PyAPI_FUNC(void) _PyGC_Fini(void);
|
|
PyAPI_FUNC(void) PySlice_Fini(void);
|
|
PyAPI_FUNC(void) _PyType_Fini(void);
|
|
PyAPI_FUNC(void) _PyRandom_Fini(void);
|
|
|
|
PyAPI_DATA(PyThreadState *) _Py_Finalizing;
|
|
#endif
|
|
|
|
/* Stuff with no proper home (yet) */
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(char *) PyOS_Readline(FILE *, FILE *, const char *);
|
|
#endif
|
|
PyAPI_DATA(int) (*PyOS_InputHook)(void);
|
|
PyAPI_DATA(char) *(*PyOS_ReadlineFunctionPointer)(FILE *, FILE *, const char *);
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_DATA(PyThreadState*) _PyOS_ReadlineTState;
|
|
#endif
|
|
|
|
/* 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
|
|
|
|
#if defined(WIN32) && !defined(MS_WIN64) && defined(_MSC_VER) && _MSC_VER >= 1300
|
|
/* Enable stack checking under Microsoft C */
|
|
#define USE_STACKCHECK
|
|
#endif
|
|
|
|
#ifdef USE_STACKCHECK
|
|
/* Check that we aren't overflowing our stack */
|
|
PyAPI_FUNC(int) PyOS_CheckStack(void);
|
|
#endif
|
|
|
|
/* Signals */
|
|
typedef void (*PyOS_sighandler_t)(int);
|
|
PyAPI_FUNC(PyOS_sighandler_t) PyOS_getsig(int);
|
|
PyAPI_FUNC(PyOS_sighandler_t) PyOS_setsig(int, PyOS_sighandler_t);
|
|
|
|
/* Random */
|
|
PyAPI_FUNC(int) _PyOS_URandom (void *buffer, Py_ssize_t size);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_PYTHONRUN_H */
|