mirror of
https://github.com/python/cpython.git
synced 2025-08-28 04:35:02 +00:00

Add new functions to get the Python interpreter behavior: * _PyPreConfig_InitPythonConfig() * _PyCoreConfig_InitPythonConfig() Add new functions to get an isolated configuration: * _PyPreConfig_InitIsolatedConfig() * _PyCoreConfig_InitIsolatedConfig() Replace _PyPreConfig_INIT and _PyCoreConfig_INIT with new functions _PyPreConfig_Init() and _PyCoreConfig_Init(). _PyCoreConfig: set configure_c_stdio and parse_argv to 0 by default to behave as Python 3.6 in the default configuration. _PyCoreConfig_Read() no longer sets coerce_c_locale_warn to 1 if it's equal to 0. coerce_c_locale_warn must now be set to -1 (ex: using _PyCoreConfig_InitPythonConfig()) to enable C locale coercion warning. Add unit tests for _PyCoreConfig_InitPythonConfig() and _PyCoreConfig_InitIsolatedConfig(). Changes: * Rename _PyCoreConfig_GetCoreConfig() to _PyPreConfig_GetCoreConfig() * Fix core_read_precmdline(): handle parse_argv=0 * Fix _Py_PreInitializeFromCoreConfig(): pass coreconfig.argv to _Py_PreInitializeFromPyArgv(), except if parse_argv=0
143 lines
4.5 KiB
C
143 lines
4.5 KiB
C
#ifndef Py_INTERNAL_CORECONFIG_H
|
|
#define Py_INTERNAL_CORECONFIG_H
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef Py_BUILD_CORE
|
|
# error "this header requires Py_BUILD_CORE define"
|
|
#endif
|
|
|
|
#include "pycore_pystate.h" /* _PyRuntimeState */
|
|
|
|
|
|
/* --- _PyWstrList ------------------------------------------------ */
|
|
|
|
#ifndef NDEBUG
|
|
PyAPI_FUNC(int) _PyWstrList_CheckConsistency(const _PyWstrList *list);
|
|
#endif
|
|
PyAPI_FUNC(void) _PyWstrList_Clear(_PyWstrList *list);
|
|
PyAPI_FUNC(int) _PyWstrList_Copy(_PyWstrList *list,
|
|
const _PyWstrList *list2);
|
|
PyAPI_FUNC(int) _PyWstrList_Append(_PyWstrList *list,
|
|
const wchar_t *item);
|
|
PyAPI_FUNC(PyObject*) _PyWstrList_AsList(const _PyWstrList *list);
|
|
PyAPI_FUNC(int) _PyWstrList_Extend(_PyWstrList *list,
|
|
const _PyWstrList *list2);
|
|
|
|
|
|
/* --- _PyArgv ---------------------------------------------------- */
|
|
|
|
typedef struct {
|
|
int argc;
|
|
int use_bytes_argv;
|
|
char **bytes_argv;
|
|
wchar_t **wchar_argv;
|
|
} _PyArgv;
|
|
|
|
PyAPI_FUNC(_PyInitError) _PyArgv_AsWstrList(const _PyArgv *args,
|
|
_PyWstrList *list);
|
|
|
|
|
|
/* --- Helper functions ------------------------------------------- */
|
|
|
|
PyAPI_FUNC(int) _Py_str_to_int(
|
|
const char *str,
|
|
int *result);
|
|
PyAPI_FUNC(const wchar_t*) _Py_get_xoption(
|
|
const _PyWstrList *xoptions,
|
|
const wchar_t *name);
|
|
PyAPI_FUNC(const char*) _Py_GetEnv(
|
|
int use_environment,
|
|
const char *name);
|
|
PyAPI_FUNC(void) _Py_get_env_flag(
|
|
int use_environment,
|
|
int *flag,
|
|
const char *name);
|
|
|
|
/* Py_GetArgcArgv() helper */
|
|
PyAPI_FUNC(void) _Py_ClearArgcArgv(void);
|
|
|
|
|
|
/* --- _PyPreCmdline ------------------------------------------------- */
|
|
|
|
typedef struct {
|
|
_PyWstrList argv;
|
|
_PyWstrList xoptions; /* "-X value" option */
|
|
int isolated; /* -I option */
|
|
int use_environment; /* -E option */
|
|
int dev_mode; /* -X dev and PYTHONDEVMODE */
|
|
} _PyPreCmdline;
|
|
|
|
#define _PyPreCmdline_INIT \
|
|
(_PyPreCmdline){ \
|
|
.use_environment = -1, \
|
|
.isolated = -1, \
|
|
.dev_mode = -1}
|
|
/* Note: _PyPreCmdline_INIT sets other fields to 0/NULL */
|
|
|
|
PyAPI_FUNC(void) _PyPreCmdline_Clear(_PyPreCmdline *cmdline);
|
|
PyAPI_FUNC(_PyInitError) _PyPreCmdline_SetArgv(_PyPreCmdline *cmdline,
|
|
const _PyArgv *args);
|
|
PyAPI_FUNC(int) _PyPreCmdline_SetCoreConfig(
|
|
const _PyPreCmdline *cmdline,
|
|
_PyCoreConfig *config);
|
|
PyAPI_FUNC(_PyInitError) _PyPreCmdline_Read(_PyPreCmdline *cmdline,
|
|
const _PyPreConfig *preconfig);
|
|
|
|
|
|
/* --- _PyPreConfig ----------------------------------------------- */
|
|
|
|
PyAPI_FUNC(void) _PyPreConfig_Init(_PyPreConfig *config);
|
|
PyAPI_FUNC(void) _PyPreConfig_InitPythonConfig(_PyPreConfig *config);
|
|
PyAPI_FUNC(void) _PyPreConfig_InitIsolatedConfig(_PyPreConfig *config);
|
|
PyAPI_FUNC(int) _PyPreConfig_Copy(_PyPreConfig *config,
|
|
const _PyPreConfig *config2);
|
|
PyAPI_FUNC(PyObject*) _PyPreConfig_AsDict(const _PyPreConfig *config);
|
|
PyAPI_FUNC(void) _PyPreConfig_GetCoreConfig(_PyPreConfig *config,
|
|
const _PyCoreConfig *core_config);
|
|
PyAPI_FUNC(_PyInitError) _PyPreConfig_Read(_PyPreConfig *config,
|
|
const _PyArgv *args);
|
|
PyAPI_FUNC(_PyInitError) _PyPreConfig_Write(const _PyPreConfig *config);
|
|
|
|
|
|
/* --- _PyCoreConfig ---------------------------------------------- */
|
|
|
|
PyAPI_FUNC(void) _PyCoreConfig_Clear(_PyCoreConfig *);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_InitPythonConfig(_PyCoreConfig *config);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_InitIsolatedConfig(_PyCoreConfig *config);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_Copy(
|
|
_PyCoreConfig *config,
|
|
const _PyCoreConfig *config2);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_SetString(
|
|
wchar_t **config_str,
|
|
const wchar_t *str);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_DecodeLocale(
|
|
wchar_t **config_str,
|
|
const char *str);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_InitPathConfig(_PyCoreConfig *config);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_SetPathConfig(
|
|
const _PyCoreConfig *config);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_Read(_PyCoreConfig *config);
|
|
PyAPI_FUNC(void) _PyCoreConfig_Write(const _PyCoreConfig *config,
|
|
_PyRuntimeState *runtime);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_SetPyArgv(
|
|
_PyCoreConfig *config,
|
|
const _PyArgv *args);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_SetArgv(
|
|
_PyCoreConfig *config,
|
|
int argc,
|
|
char **argv);
|
|
PyAPI_FUNC(_PyInitError) _PyCoreConfig_SetWideArgv(_PyCoreConfig *config,
|
|
int argc,
|
|
wchar_t **argv);
|
|
|
|
|
|
/* --- Function used for testing ---------------------------------- */
|
|
|
|
PyAPI_FUNC(PyObject*) _Py_GetConfigsAsDict(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif /* !Py_INTERNAL_CORECONFIG_H */
|