blob: e32e54cba07fdd1c9e41678469722c8c242ca4ca [file] [log] [blame]
Victor Stinnerdd12aa02018-11-27 00:12:05 +01001#ifndef Py_CPYTHON_PYLIFECYCLE_H
2# error "this header file must not be included directly"
3#endif
4
5#ifdef __cplusplus
6extern "C" {
7#endif
8
9/* Only used by applications that embed the interpreter and need to
10 * override the standard encoding determination mechanism
11 */
12PyAPI_FUNC(int) Py_SetStandardStreamEncoding(const char *encoding,
13 const char *errors);
14
15/* PEP 432 Multi-phase initialization API (Private while provisional!) */
16
Victor Stinnerf29084d2019-03-20 02:20:13 +010017PyAPI_FUNC(_PyInitError) _Py_PreInitialize(void);
18PyAPI_FUNC(_PyInitError) _Py_PreInitializeFromPreConfig(
Victor Stinner20004952019-03-26 02:31:11 +010019 const _PyPreConfig *preconfig);
Victor Stinnera6fbc4e2019-03-25 18:37:10 +010020PyAPI_FUNC(_PyInitError) _Py_PreInitializeFromConfig(
21 const _PyCoreConfig *coreconfig);
Victor Stinnerf29084d2019-03-20 02:20:13 +010022
Victor Stinnerdd12aa02018-11-27 00:12:05 +010023PyAPI_FUNC(_PyInitError) _Py_InitializeCore(
24 PyInterpreterState **interp,
25 const _PyCoreConfig *);
26PyAPI_FUNC(int) _Py_IsCoreInitialized(void);
27
28
29PyAPI_FUNC(_PyInitError) _PyMainInterpreterConfig_Read(
30 _PyMainInterpreterConfig *config,
31 const _PyCoreConfig *core_config);
32PyAPI_FUNC(void) _PyMainInterpreterConfig_Clear(_PyMainInterpreterConfig *);
33PyAPI_FUNC(int) _PyMainInterpreterConfig_Copy(
34 _PyMainInterpreterConfig *config,
35 const _PyMainInterpreterConfig *config2);
Victor Stinnerdd12aa02018-11-27 00:12:05 +010036
37PyAPI_FUNC(_PyInitError) _Py_InitializeMainInterpreter(
38 PyInterpreterState *interp,
39 const _PyMainInterpreterConfig *);
40
41/* Initialization and finalization */
42
43PyAPI_FUNC(_PyInitError) _Py_InitializeFromConfig(
44 const _PyCoreConfig *config);
Victor Stinnerdfe88472019-03-01 12:14:41 +010045PyAPI_FUNC(void) _Py_NO_RETURN _Py_ExitInitError(_PyInitError err);
Victor Stinnerdd12aa02018-11-27 00:12:05 +010046
47/* Py_PyAtExit is for the atexit module, Py_AtExit is for low-level
48 * exit functions.
49 */
50PyAPI_FUNC(void) _Py_PyAtExit(void (*func)(PyObject *), PyObject *);
51
52/* Restore signals that the interpreter has called SIG_IGN on to SIG_DFL. */
53PyAPI_FUNC(void) _Py_RestoreSignals(void);
54
55PyAPI_FUNC(int) Py_FdIsInteractive(FILE *, const char *);
56
57PyAPI_FUNC(void) _Py_SetProgramFullPath(const wchar_t *);
58
59PyAPI_FUNC(const char *) _Py_gitidentifier(void);
60PyAPI_FUNC(const char *) _Py_gitversion(void);
61
Victor Stinnerdd12aa02018-11-27 00:12:05 +010062PyAPI_FUNC(int) _Py_IsFinalizing(void);
63
64/* Random */
65PyAPI_FUNC(int) _PyOS_URandom(void *buffer, Py_ssize_t size);
66PyAPI_FUNC(int) _PyOS_URandomNonblock(void *buffer, Py_ssize_t size);
67
68/* Legacy locale support */
69PyAPI_FUNC(void) _Py_CoerceLegacyLocale(int warn);
70PyAPI_FUNC(int) _Py_LegacyLocaleDetected(void);
71PyAPI_FUNC(char *) _Py_SetLocaleFromEnv(int category);
72
73#ifdef __cplusplus
74}
75#endif