`interp-lifecycle.md`

590 строк · 69.8 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3/c-api/interp-lifecycle.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Инициализация и финализация интерпретатора89Подробнее о том, как настроить интерпретатор до инициализации, см. в [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).1011## До инициализации Python1213В приложении, встраивающем Python, функция [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize) должна вызываться до использования любых других функций Python/C API; за исключением нескольких функций и [глобальных переменных конфигурации](https://python-all.ru/3/c-api/interp-lifecycle.html#global-conf-vars).1415Следующие функции можно безопасно вызывать до инициализации Python:1617- Функции, инициализирующие интерпретатор:1819  - [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize)20  - [`Py_InitializeEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_InitializeEx)21  - [`Py_InitializeFromConfig()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_InitializeFromConfig)22  - [`Py_BytesMain()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_BytesMain)23  - [`Py_Main()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Main)24  - функции предварительной инициализации среды выполнения, описанные в [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config)25- Функции конфигурации:2627  - [`PyImport_AppendInittab()`](https://python-all.ru/3/c-api/import.html#c.PyImport_AppendInittab)28  - [`PyImport_ExtendInittab()`](https://python-all.ru/3/c-api/import.html#c.PyImport_ExtendInittab)29  - `PyInitFrozenExtensions()`30  - [`PyMem_SetAllocator()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_SetAllocator)31  - [`PyMem_SetupDebugHooks()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_SetupDebugHooks)32  - [`PyObject_SetArenaAllocator()`](https://python-all.ru/3/c-api/memory.html#c.PyObject_SetArenaAllocator)33  - [`Py_SetProgramName()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_SetProgramName)34  - [`Py_SetPythonHome()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_SetPythonHome)35  - функции конфигурации, описанные в [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config)36- Информационные функции:3738  - [`Py_IsInitialized()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_IsInitialized)39  - [`PyMem_GetAllocator()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_GetAllocator)40  - [`PyObject_GetArenaAllocator()`](https://python-all.ru/3/c-api/memory.html#c.PyObject_GetArenaAllocator)41  - [`Py_GetBuildInfo()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_GetBuildInfo)42  - [`Py_GetCompiler()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_GetCompiler)43  - [`Py_GetCopyright()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_GetCopyright)44  - [`Py_GetPlatform()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_GetPlatform)45  - [`Py_GetVersion()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_GetVersion)46  - [`Py_IsInitialized()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_IsInitialized)47- Утилиты:4849  - [`Py_DecodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_DecodeLocale)50  - функции сообщения о состоянии и утилиты, описанные в [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config)51- Распределители памяти:5253  - [`PyMem_RawMalloc()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_RawMalloc)54  - [`PyMem_RawRealloc()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_RawRealloc)55  - [`PyMem_RawCalloc()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_RawCalloc)56  - [`PyMem_RawFree()`](https://python-all.ru/3/c-api/memory.html#c.PyMem_RawFree)57- Синхронизация:5859  - [`PyMutex_Lock()`](https://python-all.ru/3/c-api/synchronization.html#c.PyMutex_Lock)60  - [`PyMutex_Unlock()`](https://python-all.ru/3/c-api/synchronization.html#c.PyMutex_Unlock)6162> **Примечание**63>64> Несмотря на внешнее сходство с некоторыми из перечисленных выше функций, следующие функции **не следует вызывать** до инициализации интерпретатора: [`Py_EncodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_EncodeLocale), [`PyEval_InitThreads()`](https://python-all.ru/3/c-api/threads.html#c.PyEval_InitThreads) и [`Py_RunMain()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_RunMain).6566## Глобальные переменные конфигурации6768В Python есть переменные глобальной конфигурации, управляющие различными возможностями и настройками. По умолчанию эти флаги задаются [параметрами командной строки](https://python-all.ru/3/using/cmdline.html#using-on-interface-options).6970Когда флаг устанавливается через параметр, значение флага равно количеству раз, которое этот параметр был указан. Например, `-b` устанавливает [`Py_BytesWarningFlag`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_BytesWarningFlag) в 1, а `-bb` устанавливает `Py_BytesWarningFlag` в 2.7172#### `int Py_BytesWarningFlag`7374Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.bytes_warning`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.bytes_warning). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).7576Выдавать предупреждение при сравнении [`bytes`](https://python-all.ru/3/library/stdtypes.html#bytes) или [`bytearray`](https://python-all.ru/3/library/stdtypes.html#bytearray) с [`str`](https://python-all.ru/3/library/stdtypes.html#str) или `bytes` с [`int`](https://python-all.ru/3/library/functions.html#int). Если значение больше или равно `2`, выдавать ошибку.7778Устанавливается опцией [`-b`](https://python-all.ru/3/using/cmdline.html#cmdoption-b).7980Устарело с версии 3.12, будет удалено в версии 3.15.8182#### `int Py_DebugFlag`8384Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.parser_debug`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.parser_debug). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).8586Включает отладочный вывод парсера (только для экспертов, зависит от опций компиляции).8788Устанавливается опцией [`-d`](https://python-all.ru/3/using/cmdline.html#cmdoption-d) и переменной окружения [`PYTHONDEBUG`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONDEBUG).8990Устарело с версии 3.12, будет удалено в версии 3.15.9192#### `int Py_DontWriteBytecodeFlag`9394Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.write_bytecode`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.write_bytecode). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).9596Если установлено ненулевое значение, Python не будет пытаться записывать файлы `.pyc` при импорте исходных модулей.9798Устанавливается опцией [`-B`](https://python-all.ru/3/using/cmdline.html#cmdoption-B) и переменной окружения [`PYTHONDONTWRITEBYTECODE`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONDONTWRITEBYTECODE).99100Устарело с версии 3.12, будет удалено в версии 3.15.101102#### `int Py_FrozenFlag`103104Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.pathconfig_warnings`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.pathconfig_warnings); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).105106Внутренний флаг, используемый программами `_freeze_module` и `frozenmain`.107108Устарело с версии 3.12, будет удалено в версии 3.15.109110#### `int Py_HashRandomizationFlag`111112Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.hash_seed`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.hash_seed) и [`PyConfig.use_hash_seed`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.use_hash_seed); см. [конфигурацию инициализации Python](https://python-all.ru/3/c-api/init_config.html#init-config).113114Устанавливается в `1`, если переменная окружения [`PYTHONHASHSEED`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONHASHSEED) установлена в непустую строку.115116Если флаг ненулевой, читает переменную окружения [`PYTHONHASHSEED`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONHASHSEED) для инициализации секретного начального значения хеша.117118Устарело с версии 3.12, будет удалено в версии 3.15.119120#### `int Py_IgnoreEnvironmentFlag`121122Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.use_environment`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.use_environment); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).123124Игнорировать все переменные окружения `PYTHON*`, например [`PYTHONPATH`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONPATH) и [`PYTHONHOME`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONHOME), которые могли быть установлены.125126Устанавливается параметрами [`-E`](https://python-all.ru/3/using/cmdline.html#cmdoption-E) и [`-I`](https://python-all.ru/3/using/cmdline.html#cmdoption-I).127128Устарело с версии 3.12, будет удалено в версии 3.15.129130#### `int Py_InspectFlag`131132Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.inspect`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.inspect); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).133134Если скрипт передан первым аргументом или используется параметр [`-c`](https://python-all.ru/3/using/cmdline.html#cmdoption-c), после выполнения скрипта или команды перейти в интерактивный режим, даже если [`sys.stdin`](https://python-all.ru/3/library/sys.html#sys.stdin) не является терминалом.135136Устанавливается опцией [`-i`](https://python-all.ru/3/using/cmdline.html#cmdoption-i) и переменной окружения [`PYTHONINSPECT`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONINSPECT).137138Устарело с версии 3.12, будет удалено в версии 3.15.139140#### `int Py_InteractiveFlag`141142Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.interactive`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.interactive); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).143144Устанавливается опцией [`-i`](https://python-all.ru/3/using/cmdline.html#cmdoption-i).145146Устарело с версии 3.12, будет удалено в версии 3.15.147148#### `int Py_IsolatedFlag`149150Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.isolated`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.isolated); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).151152Запуск Python в изолированном режиме. В изолированном режиме [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path) не содержит ни каталог скрипта, ни каталог site-packages пользователя.153154Устанавливается опцией [`-I`](https://python-all.ru/3/using/cmdline.html#cmdoption-I).155156Добавлено в версии 3.4.157158Устарело с версии 3.12, будет удалено в версии 3.15.159160#### `int Py_LegacyWindowsFSEncodingFlag`161162Этот API сохранён для обратной совместимости: следует использовать настройку [`PyPreConfig.legacy_windows_fs_encoding`](https://python-all.ru/3/c-api/init_config.html#c.PyPreConfig.legacy_windows_fs_encoding); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).163164Если флаг ненулевой, используется кодировка `mbcs` с обработчиком ошибок `replace` вместо кодировки UTF-8 с обработчиком ошибок `surrogatepass` для [кодировки файловой системы и обработчика ошибок](https://python-all.ru/3/glossary.html#term-filesystem-encoding-and-error-handler).165166Устанавливается в `1`, если переменная окружения [`PYTHONLEGACYWINDOWSFSENCODING`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONLEGACYWINDOWSFSENCODING) установлена в непустую строку.167168См. [**PEP 529**](https://python-all.ru/3/c-api/interp-lifecycle.html) для подробностей.169170[Доступность](https://python-all.ru/3/library/intro.html#availability): Windows.171172Устарело с версии 3.12, будет удалено в версии 3.15.173174#### `int Py_LegacyWindowsStdioFlag`175176Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.legacy_windows_stdio`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.legacy_windows_stdio); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).177178Если флаг ненулевой, используется [`io.FileIO`](https://python-all.ru/3/library/io.html#io.FileIO) вместо `io._WindowsConsoleIO` для [`sys`](https://python-all.ru/3/library/sys.html#module-sys) стандартных потоков.179180Устанавливается в `1`, если переменная окружения [`PYTHONLEGACYWINDOWSSTDIO`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONLEGACYWINDOWSSTDIO) установлена в непустую строку.181182См. [**PEP 528**](https://python-all.ru/3/c-api/interp-lifecycle.html) для подробностей.183184[Доступность](https://python-all.ru/3/library/intro.html#availability): Windows.185186Устарело с версии 3.12, будет удалено в версии 3.15.187188#### `int Py_NoSiteFlag`189190Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.site_import`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.site_import); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).191192Отключает импорт модуля [`site`](https://python-all.ru/3/library/site.html#module-site) и связанные с ним site-зависимые манипуляции с [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path). Также отключает эти манипуляции, если `site` явно импортирован позже (для их выполнения следует вызвать [`site.main()`](https://python-all.ru/3/library/site.html#site.main)).193194Устанавливается опцией [`-S`](https://python-all.ru/3/using/cmdline.html#cmdoption-S).195196Устарело с версии 3.12, будет удалено в версии 3.15.197198#### `int Py_NoUserSiteDirectory`199200Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.user_site_directory`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.user_site_directory); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).201202Не добавляет [`user site-packages directory`](https://python-all.ru/3/library/site.html#site.USER_SITE) в [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path).203204Устанавливается параметрами [`-s`](https://python-all.ru/3/using/cmdline.html#cmdoption-s) и [`-I`](https://python-all.ru/3/using/cmdline.html#cmdoption-I), а также переменной окружения [`PYTHONNOUSERSITE`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONNOUSERSITE).205206Устарело с версии 3.12, будет удалено в версии 3.15.207208#### `int Py_OptimizeFlag`209210Этот API сохранён для обратной совместимости: следует использовать настройку [`PyConfig.optimization_level`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.optimization_level); см. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).211212Устанавливается опцией [`-O`](https://python-all.ru/3/using/cmdline.html#cmdoption-O) и переменной окружения [`PYTHONOPTIMIZE`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONOPTIMIZE).213214Устарело с версии 3.12, будет удалено в версии 3.15.215216#### `int Py_QuietFlag`217218Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.quiet`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.quiet). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).219220Не выводить сообщения об авторских правах и версии, даже в интерактивном режиме.221222Устанавливается опцией [`-q`](https://python-all.ru/3/using/cmdline.html#cmdoption-q).223224Добавлено в версии 3.2.225226Устарело с версии 3.12, будет удалено в версии 3.15.227228#### `int Py_UnbufferedStdioFlag`229230Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.buffered_stdio`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.buffered_stdio). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).231232Принудительно отключает буферизацию потоков stdout и stderr.233234Устанавливается опцией [`-u`](https://python-all.ru/3/using/cmdline.html#cmdoption-u) и переменной окружения [`PYTHONUNBUFFERED`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONUNBUFFERED).235236Устарело с версии 3.12, будет удалено в версии 3.15.237238#### `int Py_VerboseFlag`239240Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.verbose`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.verbose). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).241242Выводит сообщение каждый раз при инициализации модуля, указывая, откуда он загружается (имя файла или встроенный модуль). Если значение больше или равно `2`, выводит сообщение для каждого файла, который проверяется при поиске модуля. Также предоставляет информацию об очистке модулей при завершении работы.243244Устанавливается опцией [`-v`](https://python-all.ru/3/using/cmdline.html#cmdoption-v) и переменной окружения [`PYTHONVERBOSE`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONVERBOSE).245246Устарело с версии 3.12, будет удалено в версии 3.15.247248## Инициализация и завершение работы интерпретатора249250#### `void Py_Initialize()`251252*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*253254Инициализирует интерпретатор Python. В приложении, встраивающем Python, эту функцию следует вызывать до использования любых других функций Python/C API; исключения перечислены в разделе [Before Python Initialization](https://python-all.ru/3/c-api/interp-lifecycle.html#pre-init-safe).255256Эта функция инициализирует таблицу загруженных модулей (`sys.modules`) и создаёт фундаментальные модули [`builtins`](https://python-all.ru/3/library/builtins.html#module-builtins), [`__main__`](https://python-all.ru/3/library/__main__.html#module-__main__) и [`sys`](https://python-all.ru/3/library/sys.html#module-sys). Также она инициализирует путь поиска модулей (`sys.path`). Она не устанавливает `sys.argv`; для этого следует использовать API [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config). При повторном вызове (без предварительного вызова [`Py_FinalizeEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_FinalizeEx)) функция ничего не делает. Возвращаемого значения нет; если инициализация завершается ошибкой, это фатальная ошибка.257258Используйте [`Py_InitializeFromConfig()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_InitializeFromConfig) для настройки [конфигурации инициализации Python](https://python-all.ru/3/c-api/init_config.html#init-config).259260> **Примечание**261>262> В Windows изменяет режим консоли с `O_TEXT` на `O_BINARY`, что также влияет на использование консоли не из Python через среду выполнения C.263264#### `void Py_InitializeEx(int initsigs)`265266*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*267268Эта функция работает как [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), если *initsigs* равно `1`. Если *initsigs* равно `0`, она пропускает начальную регистрацию обработчиков сигналов, что может быть полезно, когда CPython встраивается в более крупное приложение.269270Используйте [`Py_InitializeFromConfig()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_InitializeFromConfig) для настройки [конфигурации инициализации Python](https://python-all.ru/3/c-api/init_config.html#init-config).271272#### `PyStatus Py_InitializeFromConfig(const PyConfig *config)`273274Инициализирует Python из конфигурации *config*, как описано в [Initialization with PyConfig](https://python-all.ru/3/c-api/init_config.html#init-from-config).275276Подробнее о предварительной инициализации интерпретатора, заполнении структуры конфигурации времени выполнения и проверке возвращаемой структуры состояния см. в разделе [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).277278#### `int Py_IsInitialized()`279280*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*281282Возвращает true (ненулевое значение), если интерпретатор Python был инициализирован, и false (ноль), если нет. После вызова [`Py_FinalizeEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_FinalizeEx) функция возвращает false до тех пор, пока не будет снова вызвана [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).283284#### `int Py_IsFinalizing()`285286*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable), начиная с версии 3.13.*287288Возвращает истину (не ноль), если главный интерпретатор Python [завершает работу](https://python-all.ru/3/glossary.html#term-interpreter-shutdown). В противном случае возвращает ложь (ноль).289290Добавлено в версии 3.13.291292#### `int Py_FinalizeEx()`293294*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable) начиная с версии 3.6.*295296Отменяет все инициализации, выполненные [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize) и последующее использование функций Python/C API, и уничтожает все под-интерпретаторы (см. [`Py_NewInterpreter()`](https://python-all.ru/3/c-api/subinterpreters.html#c.Py_NewInterpreter) ниже), которые были созданы и ещё не уничтожены после последнего вызова `Py_Initialize()`. При повторном вызове (без предварительного вызова `Py_Initialize()`) эта операция ничего не делает.297298Поскольку эта функция является обратной по отношению к [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), её следует вызывать в том же потоке с тем же активным интерпретатором. Это означает главный поток и главный интерпретатор. Никогда не следует вызывать её во время работы [`Py_RunMain()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_RunMain).299300Обычно возвращаемое значение – `0`. Если во время завершения (сброса буферизованных данных) произошли ошибки, возвращается `-1`.301302Обратите внимание: Python делает всё возможное, чтобы освободить всю память, выделенную интерпретатором Python. Поэтому любое расширение на C должно корректно очищать все ранее выделенные объекты PyObject перед их использованием в последующих вызовах [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize). В противном случае это может привести к уязвимостям и некорректному поведению.303304Эта функция предусмотрена по ряду причин. Встраивающее приложение может захотеть перезапустить Python без перезапуска самого приложения. Приложение, загрузившее интерпретатор Python из динамически загружаемой библиотеки (или DLL), может захотеть освободить всю память, выделенную Python, перед выгрузкой DLL. В процессе поиска утечек памяти в приложении разработчик может захотеть освободить всю память, выделенную Python, перед выходом из приложения.305306**Ошибки и предостережения:** Уничтожение модулей и объектов в модулях выполняется в случайном порядке; это может привести к тому, что деструкторы (методы [`__del__()`](https://python-all.ru/3/reference/datamodel.html#object.__del__)) будут завершаться ошибкой, если они зависят от других объектов (даже функций) или модулей. Динамически загружаемые модули расширений, загруженные Python, не выгружаются. Небольшие объёмы памяти, выделенные интерпретатором Python, могут не освобождаться (если вы нашли утечку, пожалуйста, сообщите о ней). Память, связанная циклическими ссылками между объектами, не освобождается. Интернированные строки будут освобождены независимо от их счётчика ссылок. Некоторая память, выделенная модулями расширений, может не освобождаться. Некоторые расширения могут работать неправильно, если их функция инициализации вызывается более одного раза; это может произойти, если приложение вызывает [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize) и [`Py_FinalizeEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_FinalizeEx) более одного раза. `Py_FinalizeEx()` не должна вызываться рекурсивно из самой себя. Поэтому её не должен вызывать любой код, который может быть выполнен в рамках процесса завершения работы интерпретатора, такой как обработчики [`atexit`](https://python-all.ru/3/library/atexit.html#module-atexit), финализаторы объектов или любой код, который может выполняться при сбросе файлов stdout и stderr.307308Возбуждает [событие аудита](https://python-all.ru/3/library/sys.html#auditing) `cpython._PySys_ClearAuditHooks` без аргументов.309310Добавлено в версии 3.6.311312#### `void Py_Finalize()`313314*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*315316Это обратно совместимая версия [`Py_FinalizeEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_FinalizeEx), которая игнорирует возвращаемое значение.317318#### `int Py_BytesMain(int argc, char **argv)`319320*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable) с версии 3.8.*321322Аналогично [`Py_Main()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Main), но *argv* является массивом строк байтов, что позволяет вызывающему приложению делегировать этап декодирования текста среде выполнения CPython.323324Добавлено в версии 3.8.325326#### `int Py_Main(int argc, wchar_t **argv)`327328*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*329330Главная программа стандартного интерпретатора, инкапсулирующая полный цикл инициализации/завершения, а также дополнительное поведение для реализации чтения параметров конфигурации из окружения и командной строки, и затем выполнения `__main__` в соответствии с [командной строкой](https://python-all.ru/3/using/cmdline.html#using-on-cmdline).331332Эта функция доступна для программ, которые хотят поддерживать полный интерфейс командной строки CPython, а не просто встраивать среду выполнения Python в более крупное приложение.333334Параметры *argc* и *argv* аналогичны тем, которые передаются функции `main()` программы на C, за исключением того, что элементы *argv* сначала преобразуются в `wchar_t` с помощью [`Py_DecodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_DecodeLocale). Также важно отметить, что записи списка аргументов могут быть изменены так, чтобы указывать на строки, отличные от переданных (однако содержимое строк, на которые указывает список аргументов, не изменяется).335336Возвращаемое значение – `2`, если список аргументов не представляет собой допустимую командную строку Python, и в противном случае то же, что и [`Py_RunMain()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_RunMain).337338С точки зрения API конфигурации среды выполнения CPython, описанных в разделе [runtime configuration](https://python-all.ru/3/c-api/init_config.html#init-config) (и без учёта обработки ошибок), `Py_Main` примерно эквивалентно:339340```c341PyConfig config;342PyConfig_InitPythonConfig(&config);343PyConfig_SetArgv(&config, argc, argv);344Py_InitializeFromConfig(&config);345PyConfig_Clear(&config);346347Py_RunMain();348```349350В обычном использовании встраивающее приложение будет вызывать эту функцию *вместо* прямого вызова [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), [`Py_InitializeEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_InitializeEx) или [`Py_InitializeFromConfig()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_InitializeFromConfig), и все настройки будут применены так, как описано в других разделах этой документации. Если эта функция вызывается *после* предыдущего вызова API инициализации среды выполнения, то то, какие именно настройки окружения и командной строки будут обновлены, зависит от версии (поскольку зависит от того, какие настройки корректно поддерживают изменение после того, как они были установлены один раз при первой инициализации среды выполнения).351352#### `int Py_RunMain(void)`353354Выполняет главный модуль в полностью сконфигурированной среде выполнения CPython.355356Выполняет команду ([`PyConfig.run_command`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.run_command)), скрипт ([`PyConfig.run_filename`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.run_filename)) или модуль ([`PyConfig.run_module`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.run_module)), указанные в командной строке или в конфигурации. Если ни одно из этих значений не задано, запускает интерактивный промпт Python (REPL) с использованием глобального пространства имён модуля `__main__`.357358Если [`PyConfig.inspect`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.inspect) не задан (по умолчанию), возвращаемое значение будет `0`, если интерпретатор завершается нормально (то есть без возбуждения исключения), кодом выхода необработанного [`SystemExit`](https://python-all.ru/3/library/exceptions.html#SystemExit), или `1` для любого другого необработанного исключения.359360Если [`PyConfig.inspect`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.inspect) задан (например, когда используется опция [`-i`](https://python-all.ru/3/using/cmdline.html#cmdoption-i)), то вместо возврата при завершении интерпретатора выполнение продолжается в интерактивном промпте Python (REPL) с использованием глобального пространства имён модуля `__main__`. Если интерпретатор завершился с исключением, это исключение немедленно возбуждается в сессии REPL. Возвращаемое значение функции затем определяется способом завершения *сессии REPL*: `0`, `1` или статусом [`SystemExit`](https://python-all.ru/3/library/exceptions.html#SystemExit), как указано выше.361362Эта функция всегда завершает работу интерпретатора Python перед возвратом.363364См. [Конфигурация Python](https://python-all.ru/3/c-api/init_config.html#init-python-config) для примера пользовательской сборки Python, которая всегда работает в изолированном режиме с использованием [`Py_RunMain()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_RunMain).365366#### `int PyUnstable_AtExit(PyInterpreterState *interp, void (*func)(void*), void *data)`367368> *Это [нестабильное API](https://python-all.ru/3/c-api/stable.html#unstable-c-api). Оно может меняться без предупреждения в минорных версиях.*369370Регистрирует колбэк [`atexit`](https://python-all.ru/3/library/atexit.html#module-atexit) для целевого интерпретатора *interp*. Это аналогично [`Py_AtExit()`](https://python-all.ru/3/c-api/sys.html#c.Py_AtExit), но принимает явный указатель на интерпретатор и данные для колбэка.371372Должно существовать [присоединённое состояние потока](https://python-all.ru/3/glossary.html#term-attached-thread-state) для *interp*.373374Добавлено в версии 3.13.375376## Предостережения по поводу финализации среды выполнения377378На позднем этапе [завершения работы интерпретатора](https://python-all.ru/3/glossary.html#term-interpreter-shutdown), после попытки дождаться завершения нефоновых потоков (хотя это может быть прервано [`KeyboardInterrupt`](https://python-all.ru/3/library/exceptions.html#KeyboardInterrupt)) и выполнения функций [`atexit`](https://python-all.ru/3/library/atexit.html#module-atexit), среда выполнения помечается как *финализируемая*: [`Py_IsFinalizing()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_IsFinalizing) и [`sys.is_finalizing()`](https://python-all.ru/3/library/sys.html#sys.is_finalizing) возвращают true. На этот момент только *поток финализации*, который инициировал финализацию (обычно главный поток), может захватить [GIL](https://python-all.ru/3/glossary.html#term-GIL).379380Если любой поток, кроме потока финализации, попытается присоединить [состояние потока](https://python-all.ru/3/glossary.html#term-thread-state) во время финализации, явно или неявно, поток переходит в **состояние постоянной блокировки**, в котором он остается до завершения программы. В большинстве случаев это безвредно, но может привести к взаимной блокировке, если на более позднем этапе финализации попытаться захватить блокировку, принадлежащую заблокированному потоку, или иным образом ожидать заблокированный поток.381382Грубо? Да. Это предотвращает случайные сбои и/или неожиданно пропущенные C++ финализации выше по стеку вызовов, когда такие потоки принудительно завершались в CPython 3.13 и ранее. C API состояния потока CPython [thread state](https://python-all.ru/3/glossary.html#term-thread-state) никогда не имели ожиданий по сообщению об ошибках или их обработке в момент присоединения thread state, которые позволили бы корректно выйти из этой ситуации. Изменение этого потребовало бы новых стабильных C API и переписывания большей части C кода в экосистеме CPython для использования их с обработкой ошибок.383384## Общепроцессные параметры385386#### `void Py_SetProgramName(const wchar_t *name)`387388*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*389390Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.program_name`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.program_name). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).391392Эту функцию следует вызвать до первого вызова [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), если она вообще вызывается. Она сообщает интерпретатору значение аргумента `argv[0]` функции `main()` программы (преобразованное в широкие символы). Это используется [`Py_GetPath()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_GetPath) и некоторыми другими функциями ниже для поиска библиотек времени выполнения Python относительно исполняемого файла интерпретатора. Значение по умолчанию – `'python'`. Аргумент должен указывать на строку широких символов, завершающуюся нулём, в статической памяти, содержимое которой не изменится за время выполнения программы. Никакой код в интерпретаторе Python не изменит содержимое этой памяти.393394Используйте [`Py_DecodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_DecodeLocale) для декодирования строки байтов, чтобы получить строку wchar\_t\*.395396Устарело с версии 3.11, будет удалено в версии 3.15.397398#### `wchar_t *Py_GetProgramName()`399400*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*401402Возвращает имя программы, установленное с помощью [`PyConfig.program_name`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.program_name), или значение по умолчанию. Возвращаемая строка указывает на статическую память; вызывающий не должен изменять её значение.403404Эту функцию не следует вызывать до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), иначе она возвращает `NULL`.405406Изменено в версии 3.10: Теперь возвращает `NULL`, если вызвана до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).407408Устарело с версии 3.13, будет удалено в версии 3.15: Вместо этого используйте [`PyConfig_Get("executable")`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig_Get) ([`sys.executable`](https://python-all.ru/3/library/sys.html#sys.executable)).409410#### `wchar_t *Py_GetPrefix()`411412*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*413414Возвращает *префикс* для установленных платформонезависимых файлов. Он определяется по ряду сложных правил из имени программы, установленного с помощью [`PyConfig.program_name`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.program_name), и некоторых переменных окружения; например, если имя программы – `'/usr/local/bin/python'`, префикс – `'/usr/local'`. Возвращаемая строка указывает на статическую память; вызывающий не должен изменять её значение. Это соответствует переменной **prefix** в корневом `Makefile` и аргументу [`--prefix`](https://python-all.ru/3/using/configure.html#cmdoption-prefix) сценария **configure** во время сборки. Значение доступно в коде Python как `sys.base_prefix`. Полезен только в Unix. Смотрите также следующую функцию.415416Эту функцию не следует вызывать до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), иначе она возвращает `NULL`.417418Изменено в версии 3.10: Теперь возвращает `NULL`, если вызвана до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).419420Устарело с версии 3.13, будет удалено в версии 3.15: Вместо этого используйте [`PyConfig_Get("base_prefix")`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig_Get) ([`sys.base_prefix`](https://python-all.ru/3/library/sys.html#sys.base_prefix)). Используйте `PyConfig_Get("prefix")` ([`sys.prefix`](https://python-all.ru/3/library/sys.html#sys.prefix)), если необходимо обрабатывать [виртуальные окружения](https://python-all.ru/3/library/venv.html#venv-def).421422#### `wchar_t *Py_GetExecPrefix()`423424*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*425426Возвращает *exec-prefix* для установленных *зависящих от платформы* файлов. Значение вычисляется по ряду сложных правил на основе имени программы, заданного с помощью [`PyConfig.program_name`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.program_name), и некоторых переменных окружения; например, если имя программы – `'/usr/local/bin/python'`, то exec-prefix будет `'/usr/local'`. Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Это соответствует переменной **exec\_prefix** в `Makefile` и аргументу `--exec-prefix` скрипта **configure** на этапе сборки. Значение доступно в коде Python как `sys.base_exec_prefix`. Это имеет смысл только в Unix.427428Контекст: exec-prefix отличается от префикса (prefix), когда зависящие от платформы файлы (например, исполняемые файлы и динамические библиотеки) устанавливаются в другое дерево каталогов. В типичной установке платформенно-зависимые файлы могут быть установлены в поддерево `/usr/local/plat`, а платформенно-независимые – в `/usr/local`.429430Вообще говоря, платформа – это комбинация семейств аппаратного и программного обеспечения; например, машины Sparc под управлением ОС Solaris 2.x считаются одной платформой, машины Intel под Solaris 2.x – другой, а машины Intel под Linux – третьей. Разные основные версии одной и той же ОС обычно также образуют разные платформы. Операционные системы, отличные от Unix, – это отдельная история; стратегии установки на этих системах настолько различаются, что префикс и exec-prefix не имеют смысла и устанавливаются в пустую строку. Обратите внимание: скомпилированные файлы байт-кода Python не зависят от платформы (но не от версии Python, под которой они были скомпилированы!).431432Системные администраторы знают, как настроить программы **mount** или **automount** для совместного использования `/usr/local` между платформами, при этом `/usr/local/plat` будет отдельной файловой системой для каждой платформы.433434Эту функцию не следует вызывать до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), иначе она возвращает `NULL`.435436Изменено в версии 3.10: Теперь возвращает `NULL`, если вызвана до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).437438Устарело с версии 3.13, будет удалено в версии 3.15: Вместо этого используйте [`PyConfig_Get("base_exec_prefix")`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig_Get) ([`sys.base_exec_prefix`](https://python-all.ru/3/library/sys.html#sys.base_exec_prefix)). Используйте `PyConfig_Get("exec_prefix")` ([`sys.exec_prefix`](https://python-all.ru/3/library/sys.html#sys.exec_prefix)), если требуется поддержка [виртуальных окружений](https://python-all.ru/3/library/venv.html#venv-def).439440#### `wchar_t *Py_GetProgramFullPath()`441442*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*443444Возвращает полное имя программы исполняемого файла Python; оно вычисляется как побочный эффект при получении пути поиска модулей по умолчанию из имени программы (заданного с помощью [`PyConfig.program_name`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.program_name)). Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Значение доступно в коде Python как `sys.executable`.445446Эту функцию не следует вызывать до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), иначе она возвращает `NULL`.447448Изменено в версии 3.10: Теперь возвращает `NULL`, если вызвана до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).449450Устарело с версии 3.13, будет удалено в версии 3.15: Вместо этого используйте [`PyConfig_Get("executable")`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig_Get) ([`sys.executable`](https://python-all.ru/3/library/sys.html#sys.executable)).451452#### `wchar_t *Py_GetPath()`453454*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*455456Возвращает путь поиска модулей по умолчанию; он вычисляется из имени программы (заданного с помощью [`PyConfig.program_name`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.program_name)) и некоторых переменных окружения. Возвращаемая строка состоит из последовательности имён каталогов, разделённых символом-разделителем, зависящим от платформы. Символ-разделитель – `':'` в Unix и macOS, `';'` в Windows. Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Список [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path) инициализируется этим значением при запуске интерпретатора; позже его можно (и обычно так и делается) изменить для настройки пути поиска модулей.457458Эту функцию не следует вызывать до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), иначе она возвращает `NULL`.459460Изменено в версии 3.10: Теперь возвращает `NULL`, если вызвана до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).461462Устарело с версии 3.13, будет удалено в версии 3.15: Вместо этого используйте [`PyConfig_Get("module_search_paths")`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig_Get) ([`sys.path`](https://python-all.ru/3/library/sys.html#sys.path)).463464#### `const char *Py_GetVersion()`465466*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*467468Возвращает версию данного интерпретатора Python. Это строка, которая выглядит примерно так:469470```c471"3.0a5+ (py3k:63103M, May 12 2008, 00:53:55) \n[GCC 4.2.3]"472```473474Первое слово (до первого пробела) – это текущая версия Python; первые символы – это мажорная и минорная версии, разделённые точкой. Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Это значение доступно в коде Python как [`sys.version`](https://python-all.ru/3/library/sys.html#sys.version).475476Смотрите также константу [`Py_Version`](https://python-all.ru/3/c-api/apiabiversion.html#c.Py_Version).477478#### `const char *Py_GetPlatform()`479480*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*481482Возвращает идентификатор платформы для текущей платформы. В Unix он формируется из «официального» имени операционной системы, преобразованного в нижний регистр, за которым следует номер основной ревизии; например, для Solaris 2.x, также известного как SunOS 5.x, значение – `'sunos5'`. В macOS – `'darwin'`. В Windows – `'win'`. Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Значение доступно в коде Python как `sys.platform`.483484#### `const char *Py_GetCopyright()`485486*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*487488Возвращает официальную строку авторских прав для текущей версии Python, например489490`'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'`491492Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Значение доступно в коде Python как `sys.copyright`.493494#### `const char *Py_GetCompiler()`495496*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*497498Возвращает указание компилятора, использованного для сборки текущей версии Python, в квадратных скобках, например:499500```c501"[GCC 2.7.2.2]"502```503504Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Значение доступно коду Python как часть переменной `sys.version`.505506#### `const char *Py_GetBuildInfo()`507508*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*509510Возвращает информацию о порядковом номере и дате и времени сборки текущего экземпляра интерпретатора Python, например511512```c513"#67, Aug  1 1997, 22:34:28"514```515516Возвращаемая строка указывает на статическую память; вызывающий код не должен изменять её значение. Значение доступно коду Python как часть переменной `sys.version`.517518#### `void PySys_SetArgvEx(int argc, wchar_t **argv, int updatepath)`519520*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*521522Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.argv), [`PyConfig.parse_argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.parse_argv) и [`PyConfig.safe_path`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.safe_path). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).523524Устанавливает [`sys.argv`](https://python-all.ru/3/library/sys.html#sys.argv) на основе *argc* и *argv*. Эти параметры похожи на передаваемые функции `main()` программы, с тем отличием, что первый элемент должен указывать на исполняемый файл сценария, а не на исполняемый файл, в котором работает интерпретатор Python. Если запускаемый сценарий отсутствует, первый элемент в *argv* может быть пустой строкой. Если этой функции не удаётся инициализировать `sys.argv`, фатальная ситуация сигнализируется с помощью [`Py_FatalError()`](https://python-all.ru/3/c-api/sys.html#c.Py_FatalError).525526Если *updatepath* равен нулю, на этом работа функции заканчивается. Если *updatepath* не равен нулю, функция также изменяет [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path) по следующему алгоритму:527528- Если в `argv[0]` передано имя существующего сценария, то абсолютный путь к каталогу, в котором находится сценарий, добавляется в начало [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path).529- В противном случае (то есть если *argc* равен `0` или `argv[0]` не указывает на существующее имя файла), пустая строка добавляется в начало [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path), что эквивалентно добавлению текущего рабочего каталога (`"."`).530531Используйте [`Py_DecodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_DecodeLocale) для декодирования строки байтов, чтобы получить строку wchar\_t\*.532533См. также члены [`PyConfig.orig_argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.orig_argv) и [`PyConfig.argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.argv) структуры [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).534535> **Примечание**536>537> Приложениям, встраивающим интерпретатор Python не для выполнения одного сценария, рекомендуется передавать `0` в качестве *updatepath* и при желании обновлять [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path) самостоятельно. См. [**CVE 2008-5983**](https://python-all.ru/3/c-api/interp-lifecycle.html).538>539> В версиях до 3.1.3 того же эффекта можно достичь, вручную удалив первый элемент [`sys.path`](https://python-all.ru/3/library/sys.html#sys.path) после вызова [`PySys_SetArgv()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.PySys_SetArgv), например используя:540>541> ```c542> PyRun_SimpleString("import sys; sys.path.pop(0)\n");543> ```544545Добавлено в версии 3.1.3.546547Устарело с версии 3.11, будет удалено в версии 3.15.548549#### `void PySys_SetArgv(int argc, wchar_t **argv)`550551*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*552553Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.argv) и [`PyConfig.parse_argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.parse_argv). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).554555Эта функция работает как [`PySys_SetArgvEx()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.PySys_SetArgvEx) с *updatepath*, установленным в `1`, если только интерпретатор **python** не был запущен с [`-I`](https://python-all.ru/3/using/cmdline.html#cmdoption-I).556557Используйте [`Py_DecodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_DecodeLocale) для декодирования строки байтов, чтобы получить строку wchar\_t\*.558559См. также члены [`PyConfig.orig_argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.orig_argv) и [`PyConfig.argv`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.argv) структуры [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).560561Изменено в версии 3.4: Значение *updatepath* зависит от [`-I`](https://python-all.ru/3/using/cmdline.html#cmdoption-I).562563Устарело с версии 3.11, будет удалено в версии 3.15.564565#### `void Py_SetPythonHome(const wchar_t *home)`566567*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*568569Этот API сохранён для обратной совместимости: вместо него следует использовать [`PyConfig.home`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.home). См. [Python Initialization Configuration](https://python-all.ru/3/c-api/init_config.html#init-config).570571Устанавливает домашний каталог по умолчанию, то есть расположение стандартных библиотек Python. См. [`PYTHONHOME`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONHOME) для пояснения значения строки аргумента.572573Аргумент должен указывать на строку символов, завершающуюся нулём, в статической памяти, содержимое которой не будет изменяться в течение всего времени выполнения программы. Никакой код в интерпретаторе Python не будет менять содержимое этой памяти.574575Используйте [`Py_DecodeLocale()`](https://python-all.ru/3/c-api/sys.html#c.Py_DecodeLocale) для декодирования строки байтов, чтобы получить строку wchar\_t\*.576577Устарело с версии 3.11, будет удалено в версии 3.15.578579#### `wchar_t *Py_GetPythonHome()`580581*Часть [Stable ABI](https://python-all.ru/3/c-api/stable.html#stable).*582583Возвращает «домашний» каталог по умолчанию, то есть значение, установленное с помощью [`PyConfig.home`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig.home), или значение переменной окружения [`PYTHONHOME`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONHOME), если она задана.584585Эту функцию не следует вызывать до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize), иначе она возвращает `NULL`.586587Изменено в версии 3.10: Теперь возвращает `NULL`, если вызвано до [`Py_Initialize()`](https://python-all.ru/3/c-api/interp-lifecycle.html#c.Py_Initialize).588589Устарело с версии 3.13, будет удалено в версии 3.15: Используйте [`PyConfig_Get("home")`](https://python-all.ru/3/c-api/init_config.html#c.PyConfig_Get) или [`PYTHONHOME`](https://python-all.ru/3/using/cmdline.html#envvar-PYTHONHOME) переменную окружения вместо этого.590