Where Online Learning is simpler!
The C and C++ Include Header Files
cat -n /usr/include/python3.14/cpython/initconfig.h
1 #ifndef Py_PYCORECONFIG_H 2 #define Py_PYCORECONFIG_H 3 #ifndef Py_LIMITED_API 4 #ifdef __cplusplus 5 extern "C" { 6 #endif 7 8 /* --- PyStatus ----------------------------------------------- */ 9 10 typedef struct { 11 enum { 12 _PyStatus_TYPE_OK=0, 13 _PyStatus_TYPE_ERROR=1, 14 _PyStatus_TYPE_EXIT=2 15 } _type; 16 const char *func; 17 const char *err_msg; 18 int exitcode; 19 } PyStatus; 20 21 PyAPI_FUNC(PyStatus) PyStatus_Ok(void); 22 PyAPI_FUNC(PyStatus) PyStatus_Error(const char *err_msg); 23 PyAPI_FUNC(PyStatus) PyStatus_NoMemory(void); 24 PyAPI_FUNC(PyStatus) PyStatus_Exit(int exitcode); 25 PyAPI_FUNC(int) PyStatus_IsError(PyStatus err); 26 PyAPI_FUNC(int) PyStatus_IsExit(PyStatus err); 27 PyAPI_FUNC(int) PyStatus_Exception(PyStatus err); 28 29 /* --- PyWideStringList ------------------------------------------------ */ 30 31 typedef struct { 32 /* If length is greater than zero, items must be non-NULL 33 and all items strings must be non-NULL */ 34 Py_ssize_t length; 35 wchar_t **items; 36 } PyWideStringList; 37 38 PyAPI_FUNC(PyStatus) PyWideStringList_Append(PyWideStringList *list, 39 const wchar_t *item); 40 PyAPI_FUNC(PyStatus) PyWideStringList_Insert(PyWideStringList *list, 41 Py_ssize_t index, 42 const wchar_t *item); 43 44 45 /* --- PyPreConfig ----------------------------------------------- */ 46 47 typedef struct PyPreConfig { 48 int _config_init; /* _PyConfigInitEnum value */ 49 50 /* Parse Py_PreInitializeFromBytesArgs() arguments? 51 See PyConfig.parse_argv */ 52 int parse_argv; 53 54 /* If greater than 0, enable isolated mode: sys.path contains 55 neither the script's directory nor the user's site-packages directory. 56 57 Set to 1 by the -I command line option. If set to -1 (default), inherit 58 Py_IsolatedFlag value. */ 59 int isolated; 60 61 /* If greater than 0: use environment variables. 62 Set to 0 by -E command line option. If set to -1 (default), it is 63 set to !Py_IgnoreEnvironmentFlag. */ 64 int use_environment; 65 66 /* Set the LC_CTYPE locale to the user preferred locale? If equals to 0, 67 set coerce_c_locale and coerce_c_locale_warn to 0. */ 68 int configure_locale; 69 70 /* Coerce the LC_CTYPE locale if it's equal to "C"? (PEP 538) 71 72 Set to 0 by PYTHONCOERCECLOCALE=0. Set to 1 by PYTHONCOERCECLOCALE=1. 73 Set to 2 if the user preferred LC_CTYPE locale is "C". 74 75 If it is equal to 1, LC_CTYPE locale is read to decide if it should be 76 coerced or not (ex: PYTHONCOERCECLOCALE=1). Internally, it is set to 2 77 if the LC_CTYPE locale must be coerced. 78 79 Disable by default (set to 0). Set it to -1 to let Python decide if it 80 should be enabled or not. */ 81 int coerce_c_locale; 82 83 /* Emit a warning if the LC_CTYPE locale is coerced? 84 85 Set to 1 by PYTHONCOERCECLOCALE=warn. 86 87 Disable by default (set to 0). Set it to -1 to let Python decide if it 88 should be enabled or not. */ 89 int coerce_c_locale_warn; 90 91 #ifdef MS_WINDOWS 92 /* If greater than 1, use the "mbcs" encoding instead of the UTF-8 93 encoding for the filesystem encoding. 94 95 Set to 1 if the PYTHONLEGACYWINDOWSFSENCODING environment variable is 96 set to a non-empty string. If set to -1 (default), inherit 97 Py_LegacyWindowsFSEncodingFlag value. 98 99 See PEP 529 for more details. */ 100 int legacy_windows_fs_encoding; 101 #endif 102 103 /* Enable UTF-8 mode? (PEP 540) 104 105 Disabled by default (equals to 0). 106 107 Set to 1 by "-X utf8" and "-X utf8=1" command line options. 108 Set to 1 by PYTHONUTF8=1 environment variable. 109 110 Set to 0 by "-X utf8=0" and PYTHONUTF8=0. 111 112 If equals to -1, it is set to 1 if the LC_CTYPE locale is "C" or 113 "POSIX", otherwise it is set to 0. Inherit Py_UTF8Mode value value. */ 114 int utf8_mode; 115 116 /* If non-zero, enable the Python Development Mode. 117 118 Set to 1 by the -X dev command line option. Set by the PYTHONDEVMODE 119 environment variable. */ 120 int dev_mode; 121 122 /* Memory allocator: PYTHONMALLOC env var. 123 See PyMemAllocatorName for valid values. */ 124 int allocator; 125 } PyPreConfig; 126 127 PyAPI_FUNC(void) PyPreConfig_InitPythonConfig(PyPreConfig *config); 128 PyAPI_FUNC(void) PyPreConfig_InitIsolatedConfig(PyPreConfig *config); 129 130 131 /* --- PyConfig ---------------------------------------------- */ 132 133 /* This structure is best documented in the Doc/c-api/init_config.rst file. */ 134 typedef struct PyConfig { 135 int _config_init; /* _PyConfigInitEnum value */ 136 137 int isolated; 138 int use_environment; 139 int dev_mode; 140 int install_signal_handlers; 141 int use_hash_seed; 142 unsigned long hash_seed; 143 int faulthandler; 144 int tracemalloc; 145 int perf_profiling; 146 int remote_debug; 147 int import_time; 148 int code_debug_ranges; 149 int show_ref_count; 150 int dump_refs; 151 wchar_t *dump_refs_file; 152 int malloc_stats; 153 wchar_t *filesystem_encoding; 154 wchar_t *filesystem_errors; 155 wchar_t *pycache_prefix; 156 int parse_argv; 157 PyWideStringList orig_argv; 158 PyWideStringList argv; 159 PyWideStringList xoptions; 160 PyWideStringList warnoptions; 161 int site_import; 162 int bytes_warning; 163 int warn_default_encoding; 164 int inspect; 165 int interactive; 166 int optimization_level; 167 int parser_debug; 168 int write_bytecode; 169 int verbose; 170 int quiet; 171 int user_site_directory; 172 int configure_c_stdio; 173 int buffered_stdio; 174 wchar_t *stdio_encoding; 175 wchar_t *stdio_errors; 176 #ifdef MS_WINDOWS 177 int legacy_windows_stdio; 178 #endif 179 wchar_t *check_hash_pycs_mode; 180 int use_frozen_modules; 181 int safe_path; 182 int int_max_str_digits; 183 int thread_inherit_context; 184 int context_aware_warnings; 185 #ifdef __APPLE__ 186 int use_system_logger; 187 #endif 188 189 int cpu_count; 190 #ifdef Py_GIL_DISABLED 191 int enable_gil; 192 int tlbc_enabled; 193 #endif 194 195 /* --- Path configuration inputs ------------ */ 196 int pathconfig_warnings; 197 wchar_t *program_name; 198 wchar_t *pythonpath_env; 199 wchar_t *home; 200 wchar_t *platlibdir; 201 202 /* --- Path configuration outputs ----------- */ 203 int module_search_paths_set; 204 PyWideStringList module_search_paths; 205 wchar_t *stdlib_dir; 206 wchar_t *executable; 207 wchar_t *base_executable; 208 wchar_t *prefix; 209 wchar_t *base_prefix; 210 wchar_t *exec_prefix; 211 wchar_t *base_exec_prefix; 212 213 /* --- Parameter only used by Py_Main() ---------- */ 214 int skip_source_first_line; 215 wchar_t *run_command; 216 wchar_t *run_module; 217 wchar_t *run_filename; 218 219 /* --- Set by Py_Main() -------------------------- */ 220 wchar_t *sys_path_0; 221 222 /* --- Private fields ---------------------------- */ 223 224 // Install importlib? If equals to 0, importlib is not initialized at all. 225 // Needed by freeze_importlib. 226 int _install_importlib; 227 228 // If equal to 0, stop Python initialization before the "main" phase. 229 int _init_main; 230 231 // If non-zero, we believe we're running from a source tree. 232 int _is_python_build; 233 234 #ifdef Py_STATS 235 // If non-zero, turns on statistics gathering. 236 int _pystats; 237 #endif 238 239 #ifdef Py_DEBUG 240 // If not empty, import a non-__main__ module before site.py is executed. 241 // PYTHON_PRESITE=package.module or -X presite=package.module 242 wchar_t *run_presite; 243 #endif 244 } PyConfig; 245 246 PyAPI_FUNC(void) PyConfig_InitPythonConfig(PyConfig *config); 247 PyAPI_FUNC(void) PyConfig_InitIsolatedConfig(PyConfig *config); 248 PyAPI_FUNC(void) PyConfig_Clear(PyConfig *); 249 PyAPI_FUNC(PyStatus) PyConfig_SetString( 250 PyConfig *config, 251 wchar_t **config_str, 252 const wchar_t *str); 253 PyAPI_FUNC(PyStatus) PyConfig_SetBytesString( 254 PyConfig *config, 255 wchar_t **config_str, 256 const char *str); 257 PyAPI_FUNC(PyStatus) PyConfig_Read(PyConfig *config); 258 PyAPI_FUNC(PyStatus) PyConfig_SetBytesArgv( 259 PyConfig *config, 260 Py_ssize_t argc, 261 char * const *argv); 262 PyAPI_FUNC(PyStatus) PyConfig_SetArgv(PyConfig *config, 263 Py_ssize_t argc, 264 wchar_t * const *argv); 265 PyAPI_FUNC(PyStatus) PyConfig_SetWideStringList(PyConfig *config, 266 PyWideStringList *list, 267 Py_ssize_t length, wchar_t **items); 268 269 270 /* --- PyConfig_Get() ----------------------------------------- */ 271 272 PyAPI_FUNC(PyObject*) PyConfig_Get(const char *name); 273 PyAPI_FUNC(int) PyConfig_GetInt(const char *name, int *value); 274 PyAPI_FUNC(PyObject*) PyConfig_Names(void); 275 PyAPI_FUNC(int) PyConfig_Set(const char *name, PyObject *value); 276 277 278 /* --- Helper functions --------------------------------------- */ 279 280 /* Get the original command line arguments, before Python modified them. 281 282 See also PyConfig.orig_argv. */ 283 PyAPI_FUNC(void) Py_GetArgcArgv(int *argc, wchar_t ***argv); 284 285 286 // --- PyInitConfig --------------------------------------------------------- 287 288 typedef struct PyInitConfig PyInitConfig; 289 290 PyAPI_FUNC(PyInitConfig*) PyInitConfig_Create(void); 291 PyAPI_FUNC(void) PyInitConfig_Free(PyInitConfig *config); 292 293 PyAPI_FUNC(int) PyInitConfig_GetError(PyInitConfig* config, 294 const char **err_msg); 295 PyAPI_FUNC(int) PyInitConfig_GetExitCode(PyInitConfig* config, 296 int *exitcode); 297 298 PyAPI_FUNC(int) PyInitConfig_HasOption(PyInitConfig *config, 299 const char *name); 300 PyAPI_FUNC(int) PyInitConfig_GetInt(PyInitConfig *config, 301 const char *name, 302 int64_t *value); 303 PyAPI_FUNC(int) PyInitConfig_GetStr(PyInitConfig *config, 304 const char *name, 305 char **value); 306 PyAPI_FUNC(int) PyInitConfig_GetStrList(PyInitConfig *config, 307 const char *name, 308 size_t *length, 309 char ***items); 310 PyAPI_FUNC(void) PyInitConfig_FreeStrList(size_t length, char **items); 311 312 PyAPI_FUNC(int) PyInitConfig_SetInt(PyInitConfig *config, 313 const char *name, 314 int64_t value); 315 PyAPI_FUNC(int) PyInitConfig_SetStr(PyInitConfig *config, 316 const char *name, 317 const char *value); 318 PyAPI_FUNC(int) PyInitConfig_SetStrList(PyInitConfig *config, 319 const char *name, 320 size_t length, 321 char * const *items); 322 323 PyAPI_FUNC(int) PyInitConfig_AddModule(PyInitConfig *config, 324 const char *name, 325 PyObject* (*initfunc)(void)); 326 327 PyAPI_FUNC(int) Py_InitializeFromInitConfig(PyInitConfig *config); 328 329 330 #ifdef __cplusplus 331 } 332 #endif 333 #endif /* !Py_LIMITED_API */ 334 #endif /* !Py_PYCORECONFIG_H */
