blob: eb523b82e182d8c4018661ed8ea7c9e2e587efb8 [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 Stinner331a6a52019-05-27 16:39:22 +020017PyAPI_FUNC(PyStatus) Py_PreInitialize(
18 const PyPreConfig *src_config);
19PyAPI_FUNC(PyStatus) Py_PreInitializeFromBytesArgs(
20 const PyPreConfig *src_config,
Victor Stinnerb5947842019-05-18 00:38:16 +020021 Py_ssize_t argc,
Victor Stinner5ac27a52019-03-27 13:40:14 +010022 char **argv);
Victor Stinner331a6a52019-05-27 16:39:22 +020023PyAPI_FUNC(PyStatus) Py_PreInitializeFromArgs(
24 const PyPreConfig *src_config,
Victor Stinnerb5947842019-05-18 00:38:16 +020025 Py_ssize_t argc,
Victor Stinner5ac27a52019-03-27 13:40:14 +010026 wchar_t **argv);
Victor Stinnerf29084d2019-03-20 02:20:13 +010027
Victor Stinnerdd12aa02018-11-27 00:12:05 +010028PyAPI_FUNC(int) _Py_IsCoreInitialized(void);
29
30
Victor Stinnerdd12aa02018-11-27 00:12:05 +010031/* Initialization and finalization */
32
Victor Stinner331a6a52019-05-27 16:39:22 +020033PyAPI_FUNC(PyStatus) Py_InitializeFromConfig(
34 const PyConfig *config);
Victor Stinner331a6a52019-05-27 16:39:22 +020035PyAPI_FUNC(PyStatus) _Py_InitializeMain(void);
Victor Stinner5ac27a52019-03-27 13:40:14 +010036
Victor Stinner331a6a52019-05-27 16:39:22 +020037PyAPI_FUNC(int) Py_RunMain(void);
Victor Stinner2f549082019-03-29 15:13:46 +010038
39
Victor Stinner331a6a52019-05-27 16:39:22 +020040PyAPI_FUNC(void) _Py_NO_RETURN Py_ExitStatusException(PyStatus err);
Victor Stinnerdd12aa02018-11-27 00:12:05 +010041
42/* Py_PyAtExit is for the atexit module, Py_AtExit is for low-level
43 * exit functions.
44 */
45PyAPI_FUNC(void) _Py_PyAtExit(void (*func)(PyObject *), PyObject *);
46
47/* Restore signals that the interpreter has called SIG_IGN on to SIG_DFL. */
48PyAPI_FUNC(void) _Py_RestoreSignals(void);
49
50PyAPI_FUNC(int) Py_FdIsInteractive(FILE *, const char *);
51
52PyAPI_FUNC(void) _Py_SetProgramFullPath(const wchar_t *);
53
54PyAPI_FUNC(const char *) _Py_gitidentifier(void);
55PyAPI_FUNC(const char *) _Py_gitversion(void);
56
Victor Stinnerdd12aa02018-11-27 00:12:05 +010057PyAPI_FUNC(int) _Py_IsFinalizing(void);
58
59/* Random */
60PyAPI_FUNC(int) _PyOS_URandom(void *buffer, Py_ssize_t size);
61PyAPI_FUNC(int) _PyOS_URandomNonblock(void *buffer, Py_ssize_t size);
62
63/* Legacy locale support */
Victor Stinner0f721472019-05-20 17:16:38 +020064PyAPI_FUNC(int) _Py_CoerceLegacyLocale(int warn);
65PyAPI_FUNC(int) _Py_LegacyLocaleDetected(int warn);
Victor Stinnerdd12aa02018-11-27 00:12:05 +010066PyAPI_FUNC(char *) _Py_SetLocaleFromEnv(int category);
67
Victor Stinner252346a2020-05-01 11:33:44 +020068PyAPI_FUNC(PyThreadState *) _Py_NewInterpreter(int isolated_subinterpreter);
69
Victor Stinnerdd12aa02018-11-27 00:12:05 +010070#ifdef __cplusplus
71}
72#endif