Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity
cpython/Include/pylifecycle.h

78 lines
2.1 KiB
C
Raw Normal View History

Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
/* Interfaces to configure, query, create & destroy the Python runtime */
#ifndef Py_PYLIFECYCLE_H
#define Py_PYLIFECYCLE_H
#ifdef __cplusplus
extern "C" {
#endif
bpo-22257: Private C-API for core runtime initialization (PEP 432). (#1772) (patch by Nick Coghlan)
2017-05-24 01:46:51 -03:00
/* Initialization and finalization */
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
PyAPI_FUNC(void) Py_Initialize(void);
PyAPI_FUNC(void) Py_InitializeEx(int);
PyAPI_FUNC(void) Py_Finalize(void);
bpo-35259: Limit `Py_FinalizeEx()` to `Py_LIMITED_API >= 0x03060000`. (GH-10620)
2018-12-20 17:11:03 -04:00
#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03060000
Issue #5319: New Py_FinalizeEx() API to exit with status 120 on failure
2015-11-29 23:18:29 -04:00
PyAPI_FUNC(int) Py_FinalizeEx(void);
bpo-35259: Limit `Py_FinalizeEx()` to `Py_LIMITED_API >= 0x03060000`. (GH-10620)
2018-12-20 17:11:03 -04:00
#endif
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
PyAPI_FUNC(int) Py_IsInitialized(void);
bpo-22257: Private C-API for core runtime initialization (PEP 432). (#1772) (patch by Nick Coghlan)
2017-05-24 01:46:51 -03:00
/* Subinterpreter support */
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
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.
*/
PyAPI_FUNC(int) Py_AtExit(void (*func)(void));
Define _Py_NO_RETURN for Microsoft C compiler (GH-8606)
2018-08-01 11:41:25 -03:00
PyAPI_FUNC(void) _Py_NO_RETURN Py_Exit(int);
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
/* Bootstrap __main__ (defined in Modules/main.c) */
PyAPI_FUNC(int) Py_Main(int argc, wchar_t **argv);
bpo-42591: Export missing Py_FrozenMain() symbol (GH-23730) Export the Py_FrozenMain() function: fix a Python 3.9.0 regression. Python 3.9 uses -fvisibility=hidden and the function was not exported explicitly and so not exported. Add also Py_FrozenMain to the stable ABI on Windows.
2020-12-10 13:39:17 -04:00
PyAPI_FUNC(int) Py_FrozenMain(int argc, char **argv);
bpo-36763: Make Py_BytesMain() public (GH-15532) Declare Py_BytesMain() in Include/pylifecycle.h, rather in Include/internal/pycore_pylifecycle.h.
2019-08-26 19:45:45 -03:00
PyAPI_FUNC(int) Py_BytesMain(int argc, char **argv);
bpo-34725: Adds _Py_SetProgramFullPath so embedders may override sys.executable (GH-9860)
2018-11-18 00:41:48 -04:00
/* In pathconfig.c */
bpo-44113: Deprecate old functions to config Python init (GH-26060) Deprecate the following functions to configure the Python initialization: * PySys_AddWarnOption() * PySys_AddWarnOptionUnicode() * PySys_AddXOption() * PySys_HasWarnOptions() * Py_SetPath() * Py_SetProgramName() * Py_SetPythonHome() * Py_SetStandardStreamEncoding() * _Py_SetProgramFullPath() Use the new PyConfig API of the Python Initialization Configuration instead (PEP 587).
2021-05-12 18:59:25 -03:00
Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetProgramName(const wchar_t *);
bpo-34725: Adds _Py_SetProgramFullPath so embedders may override sys.executable (GH-9860)
2018-11-18 00:41:48 -04:00
PyAPI_FUNC(wchar_t *) Py_GetProgramName(void);
bpo-44113: Deprecate old functions to config Python init (GH-26060) Deprecate the following functions to configure the Python initialization: * PySys_AddWarnOption() * PySys_AddWarnOptionUnicode() * PySys_AddXOption() * PySys_HasWarnOptions() * Py_SetPath() * Py_SetProgramName() * Py_SetPythonHome() * Py_SetStandardStreamEncoding() * _Py_SetProgramFullPath() Use the new PyConfig API of the Python Initialization Configuration instead (PEP 587).
2021-05-12 18:59:25 -03:00
Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetPythonHome(const wchar_t *);
bpo-34725: Adds _Py_SetProgramFullPath so embedders may override sys.executable (GH-9860)
2018-11-18 00:41:48 -04:00
PyAPI_FUNC(wchar_t *) Py_GetPythonHome(void);
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
PyAPI_FUNC(wchar_t *) Py_GetProgramFullPath(void);
bpo-34725: Adds _Py_SetProgramFullPath so embedders may override sys.executable (GH-9860)
2018-11-18 00:41:48 -04:00
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
PyAPI_FUNC(wchar_t *) Py_GetPrefix(void);
PyAPI_FUNC(wchar_t *) Py_GetExecPrefix(void);
PyAPI_FUNC(wchar_t *) Py_GetPath(void);
bpo-44113: Deprecate old functions to config Python init (GH-26060) Deprecate the following functions to configure the Python initialization: * PySys_AddWarnOption() * PySys_AddWarnOptionUnicode() * PySys_AddXOption() * PySys_HasWarnOptions() * Py_SetPath() * Py_SetProgramName() * Py_SetPythonHome() * Py_SetStandardStreamEncoding() * _Py_SetProgramFullPath() Use the new PyConfig API of the Python Initialization Configuration instead (PEP 587).
2021-05-12 18:59:25 -03:00
Py_DEPRECATED(3.11) PyAPI_FUNC(void) Py_SetPath(const wchar_t *);
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
#ifdef MS_WINDOWS
Revert "bpo-32197: Try to fix a compiler error on OS X introduced in bpo-32030. (#4681)" (#4694) * Revert "bpo-32197: Try to fix a compiler error on OS X introduced in bpo-32030. (#4681)" This reverts commit 13badcbc60cdbfae1dba1683fd2fae9d70717143. Re-apply commits: * "bpo-32030: _PyPathConfig_Init() sets home and program_name (#4673)" commit af5a895073c24637c094772b27526b94a12ec897. * "bpo-32030: Fix config_get_program_name() on macOS (#4669)" commit e23c06e2b03452c9aaf0dae52296c85e572f9bcd. * "bpo-32030: Add Python/pathconfig.c (#4668)" commit 0ea395ae964c9cd0f499e2ef0d0030c971201220. * "bpo-32030: Don't call _PyPathConfig_Fini() in Py_FinalizeEx() (#4667)" commit ebac19dad6263141d5db0a2c923efe049dba99d2. * "bpo-32030: Fix Py_GetPath(): init program_name (#4665)" commit 9ac3d8882712c9675c3d2f9f84af6b5729575cde. * Fix compilation error on macOS
2017-12-04 08:39:15 -04:00
int _Py_CheckPython3(void);
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
#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);
/* 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);
Issue #26900: Excluded underscored names and other private API from limited API.
2016-09-11 05:03:14 -03:00
#ifndef Py_LIMITED_API
bpo-35134: Create Include/cpython/pylifecycle.h (GH-10731) Move pylifecycle.h code surrounded by "#ifndef Py_LIMITED_API" to a new Include/cpython/pylifecycle.h header file.
2018-11-26 19:12:05 -04:00
# define Py_CPYTHON_PYLIFECYCLE_H
# include "cpython/pylifecycle.h"
# undef Py_CPYTHON_PYLIFECYCLE_H
bpo-31877: Add _Py_LegacyLocaleDetected and _PyCoerceLegacyLocale to pylifecycle.h (GH-4134) Only declaring these as interns inside the CLI's main C module caused build problems on some platforms (notably Cygwin), so this switches them to a regular underscore prefixed "private" C API declaration.
2017-10-27 06:46:03 -03:00
#endif
Issue #22869: Split pythonrun into two modules - interpreter startup and shutdown code moved to a new pylifecycle.c module - Py_OptimizeFlag moved into the new module with the other global flags
2014-11-20 07:39:37 -04:00
#ifdef __cplusplus
}
#endif
#endif /* !Py_PYLIFECYCLE_H */