mirror of
https://github.com/python/cpython.git
synced 2026-02-23 23:50:54 +00:00
f7e5b56c37
* Don't use "Python runtime" anymore to parse command line options or to get environment variables: pymain_init() is now a strict separation. * Use an error message rather than "crashing" directly with Py_FatalError(). Limit the number of calls to Py_FatalError(). It prepares the code to handle errors more nicely later. * Warnings options (-W, PYTHONWARNINGS) and "XOptions" (-X) are now only added to the sys module once Python core is properly initialized. * _PyMain is now the well identified owner of some important strings like: warnings options, XOptions, and the "program name". The program name string is now properly freed at exit. pymain_free() is now responsible to free the "command" string. * Rename most methods in Modules/main.c to use a "pymain_" prefix to avoid conflits and ease debug. * Replace _Py_CommandLineDetails_INIT with memset(0) * Reorder a lot of code to fix the initialization ordering. For example, initializing standard streams now comes before parsing PYTHONWARNINGS. * Py_Main() now handles errors when adding warnings options and XOptions. * Add _PyMem_GetDefaultRawAllocator() private function. * Cleanup _PyMem_Initialize(): remove useless global constants: move them into _PyMem_Initialize(). * Call _PyRuntime_Initialize() as soon as possible: _PyRuntime_Initialize() now returns an error message on failure. * Add _PyInitError structure and following macros: * _Py_INIT_OK() * _Py_INIT_ERR(msg) * _Py_INIT_USER_ERR(msg): "user" error, don't abort() in that case * _Py_INIT_FAILED(err)
172 lines
5.6 KiB
C
172 lines
5.6 KiB
C
|
|
/* Interfaces to configure, query, create & destroy the Python runtime */
|
|
|
|
#ifndef Py_PYLIFECYCLE_H
|
|
#define Py_PYLIFECYCLE_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#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);
|
|
|
|
typedef struct {
|
|
const char *prefix;
|
|
const char *msg;
|
|
int user_err;
|
|
} _PyInitError;
|
|
|
|
/* Almost all errors causing Python initialization to fail */
|
|
#ifdef _MSC_VER
|
|
/* Visual Studio 2015 doesn't implement C99 __func__ in C */
|
|
# define _Py_INIT_GET_FUNC() __FUNCTION__
|
|
#else
|
|
# define _Py_INIT_GET_FUNC() __func__
|
|
#endif
|
|
|
|
#define _Py_INIT_OK() \
|
|
(_PyInitError){.prefix = NULL, .msg = NULL, .user_err = 0}
|
|
#define _Py_INIT_ERR(MSG) \
|
|
(_PyInitError){.prefix = _Py_INIT_GET_FUNC(), .msg = (MSG), .user_err = 0}
|
|
/* Error that can be fixed by the user like invalid input parameter.
|
|
Don't abort() the process on such error. */
|
|
#define _Py_INIT_USER_ERR(MSG) \
|
|
(_PyInitError){.prefix = _Py_INIT_GET_FUNC(), .msg = (MSG), .user_err = 1}
|
|
#define _Py_INIT_FAILED(err) \
|
|
(err.msg != NULL)
|
|
|
|
/* PEP 432 Multi-phase initialization API (Private while provisional!) */
|
|
PyAPI_FUNC(_PyInitError) _Py_InitializeCore(const _PyCoreConfig *);
|
|
PyAPI_FUNC(int) _Py_IsCoreInitialized(void);
|
|
PyAPI_FUNC(_PyInitError) _Py_ReadMainInterpreterConfig(_PyMainInterpreterConfig *);
|
|
PyAPI_FUNC(_PyInitError) _Py_InitializeMainInterpreter(const _PyMainInterpreterConfig *);
|
|
#endif
|
|
|
|
/* Initialization and finalization */
|
|
PyAPI_FUNC(void) Py_Initialize(void);
|
|
PyAPI_FUNC(void) Py_InitializeEx(int);
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(_PyInitError) _Py_InitializeEx_Private(int, int);
|
|
PyAPI_FUNC(void) _Py_FatalInitError(_PyInitError err) _Py_NO_RETURN;
|
|
#endif
|
|
PyAPI_FUNC(void) Py_Finalize(void);
|
|
PyAPI_FUNC(int) Py_FinalizeEx(void);
|
|
PyAPI_FUNC(int) Py_IsInitialized(void);
|
|
|
|
/* Subinterpreter support */
|
|
PyAPI_FUNC(PyThreadState *) Py_NewInterpreter(void);
|
|
PyAPI_FUNC(void) Py_EndInterpreter(PyThreadState *);
|
|
|
|
|
|
/* 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) _Py_NO_RETURN;
|
|
|
|
/* 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 __main__ (defined in Modules/main.c) */
|
|
PyAPI_FUNC(int) Py_Main(int argc, wchar_t **argv);
|
|
|
|
/* 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_gitidentifier(void);
|
|
PyAPI_FUNC(const char *) _Py_gitversion(void);
|
|
#endif
|
|
|
|
/* Internal -- various one-time initializations */
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(PyObject *) _PyBuiltin_Init(void);
|
|
PyAPI_FUNC(_PyInitError) _PySys_BeginInit(PyObject **sysmod);
|
|
PyAPI_FUNC(int) _PySys_EndInit(PyObject *sysdict);
|
|
PyAPI_FUNC(_PyInitError) _PyImport_Init(void);
|
|
PyAPI_FUNC(void) _PyExc_Init(PyObject * bltinmod);
|
|
PyAPI_FUNC(_PyInitError) _PyImportHooks_Init(void);
|
|
PyAPI_FUNC(int) _PyFrame_Init(void);
|
|
PyAPI_FUNC(int) _PyFloat_Init(void);
|
|
PyAPI_FUNC(int) PyByteArray_Init(void);
|
|
PyAPI_FUNC(_PyInitError) _Py_HashRandomization_Init(_PyCoreConfig *core_config);
|
|
#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) _Py_HashRandomization_Fini(void);
|
|
PyAPI_FUNC(void) PyAsyncGen_Fini(void);
|
|
|
|
PyAPI_FUNC(int) _Py_IsFinalizing(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);
|
|
|
|
#ifndef Py_LIMITED_API
|
|
/* Random */
|
|
PyAPI_FUNC(int) _PyOS_URandom(void *buffer, Py_ssize_t size);
|
|
PyAPI_FUNC(int) _PyOS_URandomNonblock(void *buffer, Py_ssize_t size);
|
|
#endif /* !Py_LIMITED_API */
|
|
|
|
/* Legacy locale support */
|
|
#ifndef Py_LIMITED_API
|
|
PyAPI_FUNC(void) _Py_CoerceLegacyLocale(void);
|
|
PyAPI_FUNC(int) _Py_LegacyLocaleDetected(void);
|
|
PyAPI_FUNC(char *) _Py_SetLocaleFromEnv(int category);
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_PYLIFECYCLE_H */
|