Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 23:21:29 +00:00
Code Issues Projects Releases Packages Wiki Activity
cpython/Include/pylifecycle.h

75 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 21:39:37 +10: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-23 21:46:51 -07: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 21:39:37 +10: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 15:11:03 -06: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-30 03:18:29 +00:00
PyAPI_FUNC(int) Py_FinalizeEx(void);
bpo-35259: Limit `Py_FinalizeEx()` to `Py_LIMITED_API >= 0x03060000`. (GH-10620)
2018-12-20 15:11:03 -06: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 21:39:37 +10: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-23 21:46:51 -07: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 21:39:37 +10: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 16:41:25 +02: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 21:39:37 +10:00
/* Bootstrap __main__ (defined in Modules/main.c) */
PyAPI_FUNC(int) Py_Main(int argc, wchar_t **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-27 00:45:45 +02: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-17 20:41:48 -08: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 23:59:25 +02: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-17 20:41:48 -08: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 23:59:25 +02: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-17 20:41:48 -08: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 21:39:37 +10:00
PyAPI_FUNC(wchar_t *) Py_GetProgramFullPath(void);
bpo-34725: Adds _Py_SetProgramFullPath so embedders may override sys.executable (GH-9860)
2018-11-17 20:41:48 -08: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 21:39:37 +10: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 23:59:25 +02: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 21:39:37 +10: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 13:39:15 +01: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 21:39:37 +10: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 11: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-27 00:12:05 +01:00
# define Py_CPYTHON_PYLIFECYCLE_H
bpo-45434: Remove useless space in includes (GH-28963) Micro-optimize spaces!
2021-10-15 01:50:04 +02:00
# include "cpython/pylifecycle.h"
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-27 00:12:05 +01:00
# 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 11:46:03 +02: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 21:39:37 +10:00
#ifdef __cplusplus
}
#endif
#endif /* !Py_PYLIFECYCLE_H */
Reference in a new issue Copy permalink