python3.13/cpython/pythonrun.h

0001 #ifndef Py_CPYTHON_PYTHONRUN_H
0002 #  error "this header file must not be included directly"
0003 #endif
0004
0005 PyAPI_FUNC(int) PyRun_SimpleStringFlags(const char *, PyCompilerFlags *);
0006 PyAPI_FUNC(int) PyRun_AnyFileExFlags(
0007     FILE *fp,
0008     const char *filename,       /* decoded from the filesystem encoding */
0009     int closeit,
0010     PyCompilerFlags *flags);
0011 PyAPI_FUNC(int) PyRun_SimpleFileExFlags(
0012     FILE *fp,
0013     const char *filename,       /* decoded from the filesystem encoding */
0014     int closeit,
0015     PyCompilerFlags *flags);
0016 PyAPI_FUNC(int) PyRun_InteractiveOneFlags(
0017     FILE *fp,
0018     const char *filename,       /* decoded from the filesystem encoding */
0019     PyCompilerFlags *flags);
0020 PyAPI_FUNC(int) PyRun_InteractiveOneObject(
0021     FILE *fp,
0022     PyObject *filename,
0023     PyCompilerFlags *flags);
0024 PyAPI_FUNC(int) PyRun_InteractiveLoopFlags(
0025     FILE *fp,
0026     const char *filename,       /* decoded from the filesystem encoding */
0027     PyCompilerFlags *flags);
0028
0029
0030 PyAPI_FUNC(PyObject *) PyRun_StringFlags(const char *, int, PyObject *,
0031                                          PyObject *, PyCompilerFlags *);
0032
0033 PyAPI_FUNC(PyObject *) PyRun_FileExFlags(
0034     FILE *fp,
0035     const char *filename,       /* decoded from the filesystem encoding */
0036     int start,
0037     PyObject *globals,
0038     PyObject *locals,
0039     int closeit,
0040     PyCompilerFlags *flags);
0041
0042
0043 PyAPI_FUNC(PyObject *) Py_CompileStringExFlags(
0044     const char *str,
0045     const char *filename,       /* decoded from the filesystem encoding */
0046     int start,
0047     PyCompilerFlags *flags,
0048     int optimize);
0049 PyAPI_FUNC(PyObject *) Py_CompileStringObject(
0050     const char *str,
0051     PyObject *filename, int start,
0052     PyCompilerFlags *flags,
0053     int optimize);
0054
0055 #define Py_CompileString(str, p, s) Py_CompileStringExFlags((str), (p), (s), NULL, -1)
0056 #define Py_CompileStringFlags(str, p, s, f) Py_CompileStringExFlags((str), (p), (s), (f), -1)
0057
0058 /* A function flavor is also exported by libpython. It is required when
0059     libpython is accessed directly rather than using header files which defines
0060     macros below. On Windows, for example, PyAPI_FUNC() uses dllexport to
0061     export functions in pythonXX.dll. */
0062 PyAPI_FUNC(PyObject *) PyRun_String(const char *str, int s, PyObject *g, PyObject *l);
0063 PyAPI_FUNC(int) PyRun_AnyFile(FILE *fp, const char *name);
0064 PyAPI_FUNC(int) PyRun_AnyFileEx(FILE *fp, const char *name, int closeit);
0065 PyAPI_FUNC(int) PyRun_AnyFileFlags(FILE *, const char *, PyCompilerFlags *);
0066 PyAPI_FUNC(int) PyRun_SimpleString(const char *s);
0067 PyAPI_FUNC(int) PyRun_SimpleFile(FILE *f, const char *p);
0068 PyAPI_FUNC(int) PyRun_SimpleFileEx(FILE *f, const char *p, int c);
0069 PyAPI_FUNC(int) PyRun_InteractiveOne(FILE *f, const char *p);
0070 PyAPI_FUNC(int) PyRun_InteractiveLoop(FILE *f, const char *p);
0071 PyAPI_FUNC(PyObject *) PyRun_File(FILE *fp, const char *p, int s, PyObject *g, PyObject *l);
0072 PyAPI_FUNC(PyObject *) PyRun_FileEx(FILE *fp, const char *p, int s, PyObject *g, PyObject *l, int c);
0073 PyAPI_FUNC(PyObject *) PyRun_FileFlags(FILE *fp, const char *p, int s, PyObject *g, PyObject *l, PyCompilerFlags *flags);
0074
0075 /* Use macros for a bunch of old variants */
0076 #define PyRun_String(str, s, g, l) PyRun_StringFlags((str), (s), (g), (l), NULL)
0077 #define PyRun_AnyFile(fp, name) PyRun_AnyFileExFlags((fp), (name), 0, NULL)
0078 #define PyRun_AnyFileEx(fp, name, closeit) \
0079     PyRun_AnyFileExFlags((fp), (name), (closeit), NULL)
0080 #define PyRun_AnyFileFlags(fp, name, flags) \
0081     PyRun_AnyFileExFlags((fp), (name), 0, (flags))
0082 #define PyRun_SimpleString(s) PyRun_SimpleStringFlags((s), NULL)
0083 #define PyRun_SimpleFile(f, p) PyRun_SimpleFileExFlags((f), (p), 0, NULL)
0084 #define PyRun_SimpleFileEx(f, p, c) PyRun_SimpleFileExFlags((f), (p), (c), NULL)
0085 #define PyRun_InteractiveOne(f, p) PyRun_InteractiveOneFlags((f), (p), NULL)
0086 #define PyRun_InteractiveLoop(f, p) PyRun_InteractiveLoopFlags((f), (p), NULL)
0087 #define PyRun_File(fp, p, s, g, l) \
0088     PyRun_FileExFlags((fp), (p), (s), (g), (l), 0, NULL)
0089 #define PyRun_FileEx(fp, p, s, g, l, c) \
0090     PyRun_FileExFlags((fp), (p), (s), (g), (l), (c), NULL)
0091 #define PyRun_FileFlags(fp, p, s, g, l, flags) \
0092     PyRun_FileExFlags((fp), (p), (s), (g), (l), 0, (flags))
0093
0094 /* Stuff with no proper home (yet) */
0095 PyAPI_FUNC(char *) PyOS_Readline(FILE *, FILE *, const char *);
0096 PyAPI_DATA(char) *(*PyOS_ReadlineFunctionPointer)(FILE *, FILE *, const char *);