sys.md

1> **Источник:** https://python-all.ru/3.10/library/sys.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`sys`](https://python-all.ru/3.10/library/sys.html#module-sys) – системно-зависимые параметры и функции89---1011Этот модуль предоставляет доступ к некоторым переменным, используемым или поддерживаемым интерпретатором, и к функциям, которые активно взаимодействуют с интерпретатором. Он всегда доступен.1213#### `sys.abiflags`1415В системах POSIX, где Python был собран с помощью стандартного скрипта `configure`, этот атрибут содержит флаги ABI, как указано в [**PEP 3149**](https://python-all.ru/3.10/library/sys.html).1617Изменено в версии 3.8: Флаги по умолчанию стали пустой строкой (флаг `m` для pymalloc был удалён).1819Новое в версии 3.2.2021#### `sys.addaudithook(hook)`2223Добавляет вызываемый объект *hook* в список активных аудиторных хуков для текущего (под)интерпретатора.2425Когда аудиторное событие инициируется через функцию [`sys.audit()`](https://python-all.ru/3.10/library/sys.html#sys.audit), каждый хук вызывается в порядке добавления с именем события и кортежем аргументов. Нативные хуки, добавленные с помощью [`PySys_AddAuditHook()`](https://python-all.ru/3.10/c-api/sys.html#c.PySys_AddAuditHook), вызываются первыми, затем хуки, добавленные в текущем (под)интерпретаторе. Затем хуки могут зарегистрировать событие, вызвать исключение для прерывания операции или полностью завершить процесс.2627Обратите внимание, что аудиторные хуки предназначены в первую очередь для сбора информации о внутренних или иным образом ненаблюдаемых действиях, будь то в Python или в библиотеках, написанных на Python. Они не подходят для реализации «песочницы». В частности, вредоносный код может легко отключить или обойти хуки, добавленные с помощью этой функции. Как минимум, любые чувствительные с точки зрения безопасности хуки должны быть добавлены с помощью C API [`PySys_AddAuditHook()`](https://python-all.ru/3.10/c-api/sys.html#c.PySys_AddAuditHook) до инициализации среды выполнения, а любые модули, допускающие произвольное изменение памяти (такие как [`ctypes`](https://python-all.ru/3.10/library/ctypes.html#module-ctypes)), должны быть полностью удалены или находиться под тщательным наблюдением.2829Вызов [`sys.addaudithook()`](https://python-all.ru/3.10/library/sys.html#sys.addaudithook) сам по себе инициирует аудиторное событие с именем `sys.addaudithook` без аргументов. Если какой-либо существующий хук вызывает исключение, производное от [`RuntimeError`](https://python-all.ru/3.10/library/exceptions.html#RuntimeError), новый хук не будет добавлен, а исключение будет подавлено. В результате вызывающие не могут предполагать, что их хук был добавлен, если только они не контролируют все существующие хуки.3031См. [таблицу аудиторных событий](https://python-all.ru/3.10/library/audit_events.html#audit-events) для всех событий, инициируемых CPython, и [**PEP 578**](https://python-all.ru/3.10/library/sys.html) для обсуждения исходного дизайна.3233Новое в версии 3.8.3435Изменено в версии 3.8.1: Исключения, производные от [`Exception`](https://python-all.ru/3.10/library/exceptions.html#Exception), но не от [`RuntimeError`](https://python-all.ru/3.10/library/exceptions.html#RuntimeError), больше не подавляются.3637**Особенность реализации CPython:** Когда трассировка включена (см. [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace)), хуки Python трассируются только в том случае, если вызываемый объект имеет атрибут `__cantrace__`, установленный в истинное значение. В противном случае функции трассировки пропускают хук.3839#### `sys.argv`4041Список аргументов командной строки, переданных скрипту Python. `argv[0]` – это имя скрипта (зависит от операционной системы, является ли это полным именем пути или нет). Если команда была выполнена с использованием опции командной строки [`-c`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-c) интерпретатора, `argv[0]` устанавливается в строку `'-c'`. Если имя скрипта не было передано интерпретатору Python, `argv[0]` – пустая строка.4243Для циклического чтения стандартного ввода или списка файлов, переданных в командной строке, обратитесь к модулю [`fileinput`](https://python-all.ru/3.10/library/fileinput.html#module-fileinput).4445См. также [`sys.orig_argv`](https://python-all.ru/3.10/library/sys.html#sys.orig_argv).4647> **Примечание**48>49> В Unix аргументы командной строки передаются в виде байтов от ОС. Python декодирует их с помощью кодировки файловой системы и обработчика ошибок «surrogateescape». Когда нужны исходные байты, их можно получить с помощью `[os.fsencode(arg) for arg in sys.argv]`.5051#### `sys.audit(event, *args)`5253Инициирует аудиторное событие и запускает все активные аудиторные хуки. *event* – строка, идентифицирующая событие, а *args* может содержать необязательные аргументы с дополнительной информацией о событии. Количество и типы аргументов для данного события считаются публичным и стабильным API и не должны изменяться между выпусками.5455Например, одно из аудиторных событий называется `os.chdir`. Это событие имеет один аргумент *path*, который будет содержать запрошенный новый рабочий каталог.5657[`sys.audit()`](https://python-all.ru/3.10/library/sys.html#sys.audit) вызовет существующие аудиторные хуки, передав имя события и аргументы, и вызовет первое исключение, возникшее в любом хуке. В общем случае, если возникает исключение, его не следует обрабатывать, и процесс должен быть завершен как можно быстрее. Это позволяет реализациям хуков решать, как реагировать на конкретные события: они могут просто зарегистрировать событие или прервать операцию, вызвав исключение.5859Хуки добавляются с помощью функций [`sys.addaudithook()`](https://python-all.ru/3.10/library/sys.html#sys.addaudithook) или [`PySys_AddAuditHook()`](https://python-all.ru/3.10/c-api/sys.html#c.PySys_AddAuditHook).6061Нативным эквивалентом этой функции является [`PySys_Audit()`](https://python-all.ru/3.10/c-api/sys.html#c.PySys_Audit). По возможности предпочтительнее использовать нативную функцию.6263См. [таблицу аудиторных событий](https://python-all.ru/3.10/library/audit_events.html#audit-events) для всех событий, инициируемых CPython.6465Новое в версии 3.8.6667#### `sys.base_exec_prefix`6869Устанавливается во время запуска Python, до выполнения `site.py`, в то же значение, что и [`exec_prefix`](https://python-all.ru/3.10/library/sys.html#sys.exec_prefix). Если работа не ведётся в [виртуальном окружении](https://python-all.ru/3.10/library/venv.html#venv-def), значения останутся прежними; если `site.py` обнаруживает, что используется виртуальное окружение, значения [`prefix`](https://python-all.ru/3.10/library/sys.html#sys.prefix) и [`exec_prefix`](https://python-all.ru/3.10/library/sys.html#sys.exec_prefix) будут изменены так, чтобы указывать на виртуальное окружение, тогда как [`base_prefix`](https://python-all.ru/3.10/library/sys.html#sys.base_prefix) и [`base_exec_prefix`](https://python-all.ru/3.10/library/sys.html#sys.base_exec_prefix) останутся указывающими на базовую установку Python (ту, из которой было создано виртуальное окружение).7071Новое в версии 3.3.7273#### `sys.base_prefix`7475Устанавливается во время запуска Python, до выполнения `site.py`, в то же значение, что и [`prefix`](https://python-all.ru/3.10/library/sys.html#sys.prefix). Если работа не ведётся в [виртуальном окружении](https://python-all.ru/3.10/library/venv.html#venv-def), значения останутся прежними; если `site.py` обнаруживает, что используется виртуальное окружение, значения [`prefix`](https://python-all.ru/3.10/library/sys.html#sys.prefix) и [`exec_prefix`](https://python-all.ru/3.10/library/sys.html#sys.exec_prefix) будут изменены так, чтобы указывать на виртуальное окружение, тогда как [`base_prefix`](https://python-all.ru/3.10/library/sys.html#sys.base_prefix) и [`base_exec_prefix`](https://python-all.ru/3.10/library/sys.html#sys.base_exec_prefix) останутся указывающими на базовую установку Python (ту, из которой было создано виртуальное окружение).7677Новое в версии 3.3.7879#### `sys.byteorder`8081Индикатор естественного порядка байт. Имеет значение `'big'` на платформах с big-endian (от старшего байта к младшему) и `'little'` на платформах с little-endian (от младшего байта к старшему).8283#### `sys.builtin_module_names`8485Кортеж строк, содержащий имена всех модулей, встроенных в данный интерпретатор Python. (Эту информацию нельзя получить иным способом – `modules.keys()` перечисляет только импортированные модули.)8687См. также список [`sys.stdlib_module_names`](https://python-all.ru/3.10/library/sys.html#sys.stdlib_module_names).8889#### `sys.call_tracing(func, args)`9091Вызывает `func(*args)` при включённой трассировке. Состояние трассировки сохраняется и восстанавливается после. Предназначено для вызова из отладчика из точки останова, чтобы рекурсивно отладить другой код.9293#### `sys.copyright`9495Строка, содержащая сведения об авторских правах на интерпретатор Python.9697#### `sys._clear_type_cache()`9899Очищает внутренний кеш типов. Кеш типов используется для ускорения поиска атрибутов и методов. Эту функцию следует использовать *только* для удаления лишних ссылок при отладке утечек ссылок.100101Эту функцию следует использовать только для внутренних и специальных целей.102103#### `sys._current_frames()`104105Возвращает словарь, отображающий идентификатор каждого потока на верхний кадр стека, активный в этом потоке на момент вызова функции. Обратите внимание, что функции модуля [`traceback`](https://python-all.ru/3.10/library/traceback.html#module-traceback) могут построить стек вызовов по такому кадру.106107Это особенно полезно для отладки взаимоблокировок: эта функция не требует содействия заблокированных потоков, и стеки вызовов таких потоков заморожены, пока они остаются заблокированными. Кадр, возвращённый для незаблокированного потока, может не соответствовать текущей активности этого потока, когда вызывающий код изучает кадр.108109Эту функцию следует использовать только для внутренних и специальных целей.110111Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys._current_frames` без аргументов.112113#### `sys._current_exceptions()`114115Возвращает словарь, отображающий идентификатор каждого потока на верхнее исключение, активное в этом потоке на момент вызова функции. Если поток в данный момент не обрабатывает исключение, он не включается в результирующий словарь.116117Это наиболее полезно для статистического профилирования.118119Эту функцию следует использовать только для внутренних и специальных целей.120121Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys._current_exceptions` без аргументов.122123#### `sys.breakpointhook()`124125Эта функция-ловушка вызывается встроенной функцией [`breakpoint()`](https://python-all.ru/3.10/library/functions.html#breakpoint). По умолчанию она запускает отладчик [`pdb`](https://python-all.ru/3.10/library/pdb.html#module-pdb), но может быть установлена на любую другую функцию, чтобы можно было выбрать используемый отладчик.126127Сигнатура этой функции зависит от того, что она вызывает. Например, привязка по умолчанию (например, `pdb.set_trace()`) не ожидает аргументов, но эту функцию можно привязать к функции, которая ожидает дополнительные аргументы (позиционные и/или именованные). Встроенная функция `breakpoint()` передаёт свои `*args` и `**kws` напрямую. Всё, что возвращает `breakpointhooks()`, возвращается из `breakpoint()`.128129Реализация по умолчанию сначала проверяет переменную окружения [`PYTHONBREAKPOINT`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONBREAKPOINT). Если она установлена в `"0"`, функция немедленно возвращается; то есть это пустая операция. Если переменная окружения не установлена или установлена в пустую строку, вызывается `pdb.set_trace()`. В противном случае эта переменная должна содержать имя функции для запуска, используя точечную нотацию импорта Python, например `package.subpackage.module.function`. В этом случае импортируется `package.subpackage.module`, и полученный модуль должен содержать вызываемый объект с именем `function()`. Он запускается с передачей `*args` и `**kws`, и всё, что возвращает `function()`, `sys.breakpointhook()` возвращает во встроенную функцию [`breakpoint()`](https://python-all.ru/3.10/library/functions.html#breakpoint).130131Обратите внимание: если при импорте вызываемого объекта, указанного в [`PYTHONBREAKPOINT`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONBREAKPOINT), что-то идёт не так, сообщается [`RuntimeWarning`](https://python-all.ru/3.10/library/exceptions.html#RuntimeWarning) и точка останова игнорируется.132133Также обратите внимание, что если `sys.breakpointhook()` переопределяется программно, [`PYTHONBREAKPOINT`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONBREAKPOINT) *не* учитывается.134135Добавлено в версии 3.7.136137#### `sys._debugmallocstats()`138139Выводит в stderr низкоуровневую информацию о состоянии распределителя памяти CPython.140141Если Python [собран в отладочном режиме](https://python-all.ru/3.10/using/configure.html#debug-build) ([`configure --with-pydebug option`](https://python-all.ru/3.10/using/configure.html#cmdoption-with-pydebug)), он также выполняет некоторые ресурсоёмкие проверки внутренней согласованности.142143Новое в версии 3.3.144145**Особенность реализации CPython:** Эта функция специфична для CPython. Точный формат вывода здесь не определён и может измениться.146147#### `sys.dllhandle`148149Целое число, задающее дескриптор DLL Python.150151[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Windows.152153#### `sys.displayhook(value)`154155Если *value* не равно `None`, эта функция выводит `repr(value)` в `sys.stdout` и сохраняет *value* в `builtins._`. Если `repr(value)` не кодируется в `sys.stdout.encoding` с обработчиком ошибок `sys.stdout.errors` (который, вероятно, `'strict'`), он кодируется в `sys.stdout.encoding` с обработчиком ошибок `'backslashreplace'`.156157`sys.displayhook` вызывается для результата вычисления [выражения](https://python-all.ru/3.10/glossary.html#term-expression), введённого в интерактивном сеансе Python. Отображение этих значений можно настроить, присвоив другую функцию с одним аргументом `sys.displayhook`.158159Псевдокод:160161```python162def displayhook(value):163    if value is None:164        return165    # Установите '_' в None, чтобы избежать рекурсии166    builtins._ = None167    text = repr(value)168    try:169        sys.stdout.write(text)170    except UnicodeEncodeError:171        bytes = text.encode(sys.stdout.encoding, 'backslashreplace')172        if hasattr(sys.stdout, 'buffer'):173            sys.stdout.buffer.write(bytes)174        else:175            text = bytes.decode(sys.stdout.encoding, 'strict')176            sys.stdout.write(text)177    sys.stdout.write("\n")178    builtins._ = value179```180181Изменено в версии 3.2: Используется обработчик ошибок `'backslashreplace'` для [`UnicodeEncodeError`](https://python-all.ru/3.10/library/exceptions.html#UnicodeEncodeError).182183#### `sys.dont_write_bytecode`184185If this is true, Python won’t try to write `.pyc` files on the import of source modules. This value is initially set to `True` or `False` depending on the [`-B`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-B) command line option and the [`PYTHONDONTWRITEBYTECODE`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONDONTWRITEBYTECODE) environment variable, but you can set it yourself to control bytecode file generation.186187#### `sys.pycache_prefix`188189Если это установлено (не `None`), Python будет записывать файлы `.pyc` кэша байт-кода (и читать их) в параллельном дереве каталогов с корнем в этом каталоге, а не в каталогах `__pycache__` в дереве исходного кода. Любые каталоги `__pycache__` в дереве исходного кода будут игнорироваться, а новые файлы `.pyc` будут записываться внутри префикса pycache. Поэтому, если вы используете [`compileall`](https://python-all.ru/3.10/library/compileall.html#module-compileall) в качестве этапа предварительной сборки, убедитесь, что запускаете его с тем же префиксом pycache (если он есть), который будете использовать во время выполнения.190191Относительный путь интерпретируется относительно текущего рабочего каталога.192193This value is initially set based on the value of the [`-X`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) `pycache_prefix=PATH` command-line option or the [`PYTHONPYCACHEPREFIX`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONPYCACHEPREFIX) environment variable (command-line takes precedence). If neither are set, it is `None`.194195Новое в версии 3.8.196197#### `sys.excepthook(type, value, traceback)`198199Эта функция выводит заданную трассировку и исключение в `sys.stderr`.200201Когда возникает необработанное исключение, интерпретатор вызывает `sys.excepthook` с тремя аргументами: класс исключения, экземпляр исключения и объект traceback. В интерактивном сеансе это происходит непосредственно перед возвратом управления в приглашение; в программе Python – перед завершением программы. Обработку таких исключений верхнего уровня можно настроить, присвоив другую функцию с тремя аргументами `sys.excepthook`.202203Генерирует событие аудита `sys.excepthook` с аргументами `hook`, `type`, `value`, `traceback`, когда возникает неперехваченное исключение. Если обработчик не установлен, `hook` может быть `None`. Если какой-либо обработчик генерирует исключение, производное от [`RuntimeError`](https://python-all.ru/3.10/library/exceptions.html#RuntimeError), вызов обработчика будет подавлен. В противном случае исключение обработчика аудита будет зарегистрировано как необрабатываемое и будет вызван `sys.excepthook`.204205> **См. также**206>207> Функция [`sys.unraisablehook()`](https://python-all.ru/3.10/library/sys.html#sys.unraisablehook) обрабатывает необрабатываемые исключения, а функция [`threading.excepthook()`](https://python-all.ru/3.10/library/threading.html#threading.excepthook) обрабатывает исключения, возникающие в [`threading.Thread.run()`](https://python-all.ru/3.10/library/threading.html#threading.Thread.run).208209#### `sys.__breakpointhook__`210211#### `sys.__displayhook__`212213#### `sys.__excepthook__`214215#### `sys.__unraisablehook__`216217Эти объекты содержат исходные значения `breakpointhook`, `displayhook`, `excepthook` и `unraisablehook` на момент запуска программы. Они сохраняются, чтобы `breakpointhook`, `displayhook` и `excepthook`, `unraisablehook` можно было восстановить, если они вдруг будут заменены повреждёнными или альтернативными объектами.218219Новое в версии 3.7: \_\_breakpointhook\_\_220221Новое в версии 3.8: \_\_unraisablehook\_\_222223#### `sys.exc_info()`224225Эта функция возвращает кортеж из трёх значений, содержащих информацию об обрабатываемом в данный момент исключении. Возвращаемая информация относится как к текущему потоку, так и к текущему фрейму стека. Если текущий фрейм стека не обрабатывает исключение, информация берётся из вызывающего фрейма стека или его вызывающего, и так далее, пока не будет найден фрейм, обрабатывающий исключение. Здесь «обработка исключения» означает «выполнение блока except». Для любого фрейма стека доступна только информация об исключении, обрабатываемом в данный момент.226227Если нигде в стеке не обрабатывается исключение, возвращается кортеж, содержащий три значения `None`. В противном случае возвращаются значения `(type, value, traceback)`. Их смысл: *type* получает тип обрабатываемого исключения (подкласс [`BaseException`](https://python-all.ru/3.10/library/exceptions.html#BaseException)); *value* получает экземпляр исключения (экземпляр типа исключения); *traceback* получает [объект traceback](https://python-all.ru/3.10/reference/datamodel.html#traceback-objects), который инкапсулирует стек вызовов на момент исходного возникновения исключения.228229#### `sys.exec_prefix`230231Строка, содержащая префикс директории, зависящий от сайта, в который устанавливаются платформозависимые файлы Python; по умолчанию это также `'/usr/local'`. Этот префикс можно задать во время сборки с помощью аргумента `--exec-prefix` скрипта **configure**. В частности, все файлы конфигурации (например, заголовочный файл `pyconfig.h`) устанавливаются в каталог `exec_prefix/lib/pythonX.Y/config`, а модули разделяемых библиотек – в `exec_prefix/lib/pythonX.Y/lib-dynload`, где *X.Y* – номер версии Python, например `3.2`.232233> **Примечание**234>235> Если [виртуальное окружение](https://python-all.ru/3.10/library/venv.html#venv-def) активно, это значение будет изменено в `site.py` так, чтобы указывать на виртуальное окружение. Значение для установки Python останется доступным через [`base_exec_prefix`](https://python-all.ru/3.10/library/sys.html#sys.base_exec_prefix).236237#### `sys.executable`238239Строка, содержащая абсолютный путь к исполняемому файлу интерпретатора Python на системах, где это имеет смысл. Если Python не может получить реальный путь к своему исполняемому файлу, [`sys.executable`](https://python-all.ru/3.10/library/sys.html#sys.executable) будет пустой строкой или `None`.240241#### `sys.exit([arg])`242243Вызывает исключение [`SystemExit`](https://python-all.ru/3.10/library/exceptions.html#SystemExit), сигнализируя о намерении завершить интерпретатор.244245Необязательный аргумент *arg* может быть целым числом, задающим статус выхода (по умолчанию ноль), или объектом другого типа. Если это целое число, ноль считается «успешным завершением», а любое ненулевое значение – «аварийным завершением» в оболочках и подобных системах. Большинство систем требуют, чтобы это значение находилось в диапазоне 0–127, иначе поведение не определено. В некоторых системах существует соглашение о присвоении определённых значений конкретным кодам выхода, но обычно такие соглашения слабо проработаны; программы Unix обычно используют 2 для ошибок синтаксиса командной строки и 1 для всех остальных ошибок. Если передан объект другого типа, `None` эквивалентен передаче нуля, а любой другой объект выводится в [`stderr`](https://python-all.ru/3.10/library/sys.html#sys.stderr) и приводит к коду выхода 1. В частности, `sys.exit("some error message")` – это быстрый способ завершить программу при возникновении ошибки.246247Поскольку [`exit()`](https://python-all.ru/3.10/library/constants.html#exit) в конечном счёте «всего лишь» вызывает исключение, он завершает процесс, только если вызван из главного потока и исключение не перехвачено. Действия по очистке, указанные в предложениях finally операторов [`try`](https://python-all.ru/3.10/reference/compound_stmts.html#try), выполняются, и попытку выхода можно перехватить на внешнем уровне.248249Изменено в версии 3.6: Если возникает ошибка при очистке после того, как интерпретатор Python перехватил [`SystemExit`](https://python-all.ru/3.10/library/exceptions.html#SystemExit) (например, ошибка сброса буферизованных данных в стандартных потоках), код завершения изменяется на 120.250251#### `sys.flags`252253[Именованный кортеж](https://python-all.ru/3.10/glossary.html#term-named-tuple) *flags* показывает состояние флагов командной строки. Атрибуты доступны только для чтения.254255| атрибут | флаг |256| --- | --- |257| `debug` | [`-d`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-d) |258| [`inspect`](https://python-all.ru/3.10/library/inspect.html#module-inspect) | [`-i`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-i) |259| `interactive` | [`-i`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-i) |260| `isolated` | [`-I`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-I) |261| `optimize` | [`-O`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-O) или [`-OO`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-OO) |262| [`dont_write_bytecode`](https://python-all.ru/3.10/library/sys.html#sys.dont_write_bytecode) | [`-B`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-B) |263| `no_user_site` | [`-s`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-s) |264| `no_site` | [`-S`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-S) |265| `ignore_environment` | [`-E`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-E) |266| `verbose` | [`-v`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-1) |267| `bytes_warning` | [`-b`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-b) |268| `quiet` | [`-q`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-q) |269| `hash_randomization` | [`-R`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-R) |270| `dev_mode` | [`-X dev`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) ([Режим разработки Python](https://python-all.ru/3.10/library/devmode.html#devmode)) |271| `utf8_mode` | [`-X utf8`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) |272| `int_max_str_digits` | [`-X int_max_str_digits`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) ([ограничение длины преобразования целого числа в строку](https://python-all.ru/3.10/library/stdtypes.html#int-max-str-digits)) |273274Изменено в версии 3.2: Добавлен атрибут `quiet` для нового флага [`-q`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-q).275276Новое в версии 3.2.3: Атрибут `hash_randomization`.277278Изменено в версии 3.3: Удалён устаревший атрибут `division_warning`.279280Изменено в версии 3.4: Добавлен атрибут `isolated` для флага [`-I`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-I) `isolated`.281282Изменено в версии 3.7: Добавлен атрибут `dev_mode` для нового [режима разработки Python](https://python-all.ru/3.10/library/devmode.html#devmode), а также атрибут `utf8_mode` для нового флага [`-X`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) `utf8`.283284Изменено в версии 3.10.7: Добавлен атрибут `int_max_str_digits`.285286#### `sys.float_info`287288[Именованный кортеж](https://python-all.ru/3.10/glossary.html#term-named-tuple), содержащий информацию о типе float. В нём представлены низкоуровневые сведения о точности и внутреннем представлении. Значения соответствуют различным константам с плавающей точкой, определённым в стандартном заголовочном файле `float.h` для языка программирования C; подробности см. в разделе 5.2.4.2.2 стандарта ISO/IEC C 1999 [\[C99\]](https://python-all.ru/3.10/library/sys.html#c99), «Характеристики типов с плавающей точкой».289290| атрибут | float.h макрос | объяснение |291| --- | --- | --- |292| `epsilon` | `DBL_EPSILON` | разница между 1.0 и наименьшим значением, большим 1.0, которое представимо как float См. также [`math.ulp()`](https://python-all.ru/3.10/library/math.html#math.ulp). |293| `dig` | `DBL_DIG` | maximum number of decimal digits that can be faithfully represented in a float; see below |294| `mant_dig` | `DBL_MANT_DIG` | float precision: the number of base-`radix` digits in the significand of a float |295| `max` | `DBL_MAX` | maximum representable positive finite float |296| `max_exp` | `DBL_MAX_EXP` | максимальное целое *e*, такое что `radix**(e-1)` находится в диапазоне представимых конечных значений float |297| `max_10_exp` | `DBL_MAX_10_EXP` | максимальное целое число *e* такое, что `10**e` находится в диапазоне представимых конечных чисел с плавающей запятой |298| `min` | `DBL_MIN` | minimum representable positive *normalized* float минимальное целое [e](https://python-all.ru/3.10/library/math.html#math.ulp), такое что *denormalized* является нормализованным значением float |299| `min_exp` | `DBL_MIN_EXP` | минимальное целое *e*, такое что `radix**(e-1)` является нормализованным значением float |300| `min_10_exp` | `DBL_MIN_10_EXP` | minimum integer *e* such that `10**e` is a normalized float |301| `radix` | `FLT_RADIX` | radix of exponent representation |302| `rounds` | `FLT_ROUNDS` | integer representing the rounding mode for floating-point arithmetic. This reflects the value of the system `FLT_ROUNDS` macro at interpreter startup time: `-1` indeterminable, `0` toward zero, `1` to nearest, `2` toward positive infinity, `3` toward negative infinity Все остальные значения для `FLT_ROUNDS` описывают поведение округления, определяемое реализацией. |303304Атрибут `sys.float_info.dig` требует дополнительного пояснения. Если `s` – любая строка, представляющая десятичное число не более чем с `sys.float_info.dig` значащими цифрами, то преобразование `s` в float и обратно даст строку, представляющую то же десятичное значение:305306```python307>>> import sys308>>> sys.float_info.dig30915310>>> s = '3.14159265358979'    # десятичная строка с 15 значащими цифрами311>>> format(float(s), '.15g')  # Преобразование во float и обратно -> то же значение312'3.14159265358979'313```314315Но для строк с более чем `sys.float_info.dig` значащими цифрами это верно не всегда:316317```python318>>> s = '9876543211234567'    # 16 значащих цифр – слишком много!319>>> format(float(s), '.16g')  # преобразование изменяет значение320'9876543211234568'321```322323#### `sys.float_repr_style`324325Строка, указывающая, как ведёт себя функция [`repr()`](https://python-all.ru/3.10/library/functions.html#repr) для чисел с плавающей запятой. Если строка имеет значение `'short'`, то для конечного float `x`, `repr(x)` стремится создать короткую строку с тем свойством, что `float(repr(x)) == x`. Это обычное поведение в Python 3.1 и новее. В противном случае `float_repr_style` имеет значение `'legacy'`, и `repr(x)` ведёт себя так же, как в версиях Python до 3.1.326327Новое в версии 3.1.328329#### `sys.getallocatedblocks()`330331Возвращает количество блоков памяти, выделенных в данный момент интерпретатором, независимо от их размера. Эта функция в основном полезна для отслеживания и отладки утечек памяти. Из-за внутренних кешей интерпретатора результат может меняться от вызова к вызову; возможно, потребуется вызвать [`_clear_type_cache()`](https://python-all.ru/3.10/library/sys.html#sys._clear_type_cache) и [`gc.collect()`](https://python-all.ru/3.10/library/gc.html#gc.collect), чтобы получить более предсказуемые результаты.332333Если сборка или реализация Python не может обоснованно вычислить эту информацию, [`getallocatedblocks()`](https://python-all.ru/3.10/library/sys.html#sys.getallocatedblocks) разрешено возвращать 0.334335Новое в версии 3.4.336337#### `sys.getandroidapilevel()`338339Возвращает версию API Android на момент сборки в виде целого числа.340341[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Android.342343Добавлено в версии 3.7.344345#### `sys.getdefaultencoding()`346347Возвращает имя текущей кодировки строк по умолчанию, используемой реализацией Unicode.348349#### `sys.getdlopenflags()`350351Возвращает текущее значение флагов, используемых для вызовов `dlopen()`. Символические имена значений флагов можно найти в модуле [`os`](https://python-all.ru/3.10/library/os.html#module-os) (константы `RTLD_xxx`, например [`os.RTLD_LAZY`](https://python-all.ru/3.10/library/os.html#os.RTLD_LAZY)).352353[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Unix.354355#### `sys.getfilesystemencoding()`356357Возвращает [кодировку файловой системы](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler): кодировку, используемую вместе с [обработчиком ошибок файловой системы](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler) для преобразования между именами файлов в Unicode и байтовыми именами файлов. Обработчик ошибок файловой системы возвращается из [`getfilesystemencodeerrors()`](https://python-all.ru/3.10/library/sys.html#sys.getfilesystemencodeerrors).358359Для лучшей совместимости во всех случаях следует использовать str для имён файлов, хотя представление имён файлов в виде байтов также поддерживается. Функции, принимающие или возвращающие имена файлов, должны поддерживать str или bytes и внутренне преобразовывать в предпочтительное представление системы.360361[`os.fsencode()`](https://python-all.ru/3.10/library/os.html#os.fsencode) и [`os.fsdecode()`](https://python-all.ru/3.10/library/os.html#os.fsdecode) следует использовать, чтобы гарантировать применение правильной кодировки и режима обработки ошибок.362363[Кодировка файловой системы и обработчик ошибок](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler) настраиваются при запуске Python функцией `PyConfig_Read()`: см. члены [`filesystem_encoding`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig.filesystem_encoding) и [`filesystem_errors`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig.filesystem_errors) объекта [`PyConfig`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig).364365Изменено в версии 3.2: результат [`getfilesystemencoding()`](https://python-all.ru/3.10/library/sys.html#sys.getfilesystemencoding) больше не может быть `None`.366367Изменено в версии 3.6: Windows больше не гарантирует возврат `'mbcs'`. Подробнее см. [**PEP 529**](https://python-all.ru/3.10/library/sys.html) и [`_enablelegacywindowsfsencoding()`](https://python-all.ru/3.10/library/sys.html#sys._enablelegacywindowsfsencoding).368369Изменено в версии 3.7: Возвращает `'utf-8'`, если включён [режим UTF-8 Python](https://python-all.ru/3.10/library/os.html#utf8-mode).370371#### `sys.getfilesystemencodeerrors()`372373Возвращает [обработчик ошибок файловой системы](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler): обработчик ошибок, используемый вместе с [кодировкой файловой системы](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler) для преобразования между именами файлов в Unicode и байтовыми именами файлов. Кодировка файловой системы возвращается из [`getfilesystemencoding()`](https://python-all.ru/3.10/library/sys.html#sys.getfilesystemencoding).374375[`os.fsencode()`](https://python-all.ru/3.10/library/os.html#os.fsencode) и [`os.fsdecode()`](https://python-all.ru/3.10/library/os.html#os.fsdecode) следует использовать, чтобы гарантировать применение правильной кодировки и режима обработки ошибок.376377[Кодировка файловой системы и обработчик ошибок](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler) настраиваются при запуске Python функцией `PyConfig_Read()`: см. члены [`filesystem_encoding`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig.filesystem_encoding) и [`filesystem_errors`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig.filesystem_errors) объекта [`PyConfig`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig).378379Новое в версии 3.6.380381#### `sys.get_int_max_str_digits()`382383Возвращает текущее значение [ограничения длины преобразования целого числа в строку](https://python-all.ru/3.10/library/stdtypes.html#int-max-str-digits). См. также [`set_int_max_str_digits()`](https://python-all.ru/3.10/library/sys.html#sys.set_int_max_str_digits).384385Новое в версии 3.10.7.386387#### `sys.getrefcount(object)`388389Возвращает счётчик ссылок на *объект*. Возвращаемое значение обычно на единицу больше, чем можно ожидать, поскольку включает (временную) ссылку как аргумент [`getrefcount()`](https://python-all.ru/3.10/library/sys.html#sys.getrefcount).390391Обратите внимание, что возвращаемое значение может не отражать действительное количество ссылок на объект. Поэтому не полагайтесь на его точность, за исключением случаев, когда оно равно 0 или 1.392393#### `sys.getrecursionlimit()`394395Возвращает текущее значение предела рекурсии – максимальную глубину стека интерпретатора Python. Этот предел предотвращает переполнение стека C и падение Python из-за бесконечной рекурсии. Его можно задать с помощью [`setrecursionlimit()`](https://python-all.ru/3.10/library/sys.html#sys.setrecursionlimit).396397#### `sys.getsizeof(object[, default])`398399Возвращает размер объекта в байтах. Объект может быть любого типа. Все встроенные объекты возвращают корректные результаты, но для сторонних расширений это не обязательно – результат зависит от реализации.400401Учитывается только память, непосредственно занимаемая объектом, а не память объектов, на которые он ссылается.402403Если задан параметр *default*, он будет возвращён в случае, если объект не предоставляет способа получить размер. В противном случае возбуждается [`TypeError`](https://python-all.ru/3.10/library/exceptions.html#TypeError).404405[`getsizeof()`](https://python-all.ru/3.10/library/sys.html#sys.getsizeof) вызывает метод `__sizeof__` объекта и добавляет дополнительную нагрузку сборщика мусора, если объект управляется сборщиком мусора.406407См. [рецепт рекурсивного sizeof](https://python-all.ru/3.10/library/sys.html) для примера использования [`getsizeof()`](https://python-all.ru/3.10/library/sys.html#sys.getsizeof) рекурсивно для определения размера контейнеров и всего их содержимого.408409#### `sys.getswitchinterval()`410411Возвращает «интервал переключения потоков» интерпретатора; см. [`setswitchinterval()`](https://python-all.ru/3.10/library/sys.html#sys.setswitchinterval).412413Новое в версии 3.2.414415#### `sys._getframe([depth])`416417Возвращает объект кадра из стека вызовов. Если задан необязательный целочисленный параметр *depth*, возвращается кадр, находящийся на указанное количество вызовов ниже вершины стека. Если это глубже, чем стек вызовов, возбуждается [`ValueError`](https://python-all.ru/3.10/library/exceptions.html#ValueError). Значение по умолчанию для *depth* равно нулю – возвращается кадр на вершине стека вызовов.418419Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys._getframe` без аргументов.420421**Особенности реализации CPython:** Эта функция предназначена только для внутренних и специализированных целей. Она не гарантированно существует во всех реализациях Python.422423#### `sys.getprofile()`424425Возвращает профилирующую функцию, установленную с помощью [`setprofile()`](https://python-all.ru/3.10/library/sys.html#sys.setprofile).426427#### `sys.gettrace()`428429Возвращает трассировочную функцию, установленную с помощью [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace).430431**Особенность реализации CPython:** Функция [`gettrace()`](https://python-all.ru/3.10/library/sys.html#sys.gettrace) предназначена только для реализации отладчиков, профилировщиков, инструментов покрытия кода и тому подобного. Её поведение является частью платформы реализации, а не частью определения языка, и поэтому может быть недоступно во всех реализациях Python.432433#### `sys.getwindowsversion()`434435Возвращает именованный кортеж с информацией о текущей версии Windows. Именованные элементы: *major*, *minor*, *build*, *platform*, *service\_pack*, *service\_pack\_minor*, *service\_pack\_major*, *suite\_mask*, *product\_type* и *platform\_version*. *service\_pack* – строка, *platform\_version* – кортеж из трёх элементов, все остальные значения – целые числа. К компонентам также можно обращаться по имени, так что `sys.getwindowsversion()[0]` эквивалентно `sys.getwindowsversion().major`. Для совместимости с предыдущими версиями по индексу доступны только первые 5 элементов.436437*платформа* будет `2 (VER_PLATFORM_WIN32_NT)`.438439*product\_type* может быть одним из следующих значений:440441| Константа | Значение |442| --- | --- |443| `1 (VER_NT_WORKSTATION)` | Система является рабочей станцией. |444| `2 (VER_NT_DOMAIN_CONTROLLER)` | Система является контроллером домена. |445| `3 (VER_NT_SERVER)` | Система является сервером, но не контроллером домена. |446447Эта функция является обёрткой над функцией Win32 `GetVersionEx()`; см. документацию Microsoft по `OSVERSIONINFOEX()` для получения дополнительных сведений об этих полях.448449*platform\_version* возвращает основной номер версии, дополнительный номер версии и номер сборки текущей операционной системы, а не версию, которая эмулируется для процесса. Она предназначена для использования в журналировании, а не для определения возможностей.450451> **Примечание**452>453> *platform\_version* получает версию из kernel32.dll, которая может иметь версию, отличную от версии ОС. Для получения точной версии ОС используйте модуль [`platform`](https://python-all.ru/3.10/library/platform.html#module-platform).454455[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Windows.456457Изменено в версии 3.2: Изменён на именованный кортеж и добавлены *service\_pack\_minor*, *service\_pack\_major*, *suite\_mask* и *product\_type*.458459Изменено в версии 3.6: Добавлен *platform\_version*460461#### `sys.get_asyncgen_hooks()`462463Возвращает объект *asyncgen\_hooks*, который похож на [`namedtuple`](https://python-all.ru/3.10/library/collections.html#collections.namedtuple) вида `(firstiter, finalizer)`, где *firstiter* и *finalizer* должны быть либо `None`, либо функциями, принимающими [итератор асинхронного генератора](https://python-all.ru/3.10/glossary.html#term-asynchronous-generator-iterator) в качестве аргумента, и используются для планирования финализации асинхронного генератора в цикле событий.464465Новое в версии 3.6: Подробнее см. [**PEP 525**](https://python-all.ru/3.10/library/sys.html).466467> **Примечание**468>469> Эта функция была добавлена на временной основе (см. [**PEP 411**](https://python-all.ru/3.10/library/sys.html) для подробностей).470471#### `sys.get_coroutine_origin_tracking_depth()`472473Возвращает текущую глубину отслеживания источника корутины, установленную с помощью [`set_coroutine_origin_tracking_depth()`](https://python-all.ru/3.10/library/sys.html#sys.set_coroutine_origin_tracking_depth).474475Добавлено в версии 3.7.476477> **Примечание**478>479> Эта функция была добавлена на временной основе (см. [**PEP 411**](https://python-all.ru/3.10/library/sys.html) для подробностей). Используйте её только для целей отладки.480481#### `sys.hash_info`482483[Именованный кортеж](https://python-all.ru/3.10/glossary.html#term-named-tuple), задающий параметры реализации числового хеша. Подробнее о хешировании числовых типов см. [Хеширование числовых типов](https://python-all.ru/3.10/library/stdtypes.html#numeric-hash).484485| атрибут | объяснение |486| --- | --- |487| `width` | разрядность в битах, используемая для хеш-значений |488| `modulus` | простой модуль P, используемый для числовой схемы хеширования |489| `inf` | хэш-значение, возвращаемое для положительной бесконечности |490| `nan` | (этот атрибут больше не используется) |491| `imag` | множитель для мнимой части комплексного числа |492| `algorithm` | имя алгоритма хэширования для str, bytes и memoryview |493| `hash_bits` | внутренний размер вывода алгоритма хэширования |494| `seed_bits` | размер ключа начальной инициализации (seed) алгоритма хэширования |495496Новое в версии 3.2.497498Изменено в версии 3.4: добавлены *algorithm*, *hash\_bits* и *seed\_bits*499500#### `sys.hexversion`501502Номер версии, закодированный в виде одного целого числа. Гарантируется, что он увеличивается с каждой версией, включая надлежащую поддержку непроизводственных выпусков. Например, чтобы проверить, что интерпретатор Python имеет версию не ниже 1.5.2, используйте:503504```python505if sys.hexversion >= 0x010502F0:506    # используйте некоторую продвинутую функцию507    ...508else:509    # используйте альтернативную реализацию или предупредите пользователя510    ...511```512513Это называется `hexversion`, поскольку оно действительно имеет смысл только при просмотре как результат передачи его встроенной функции [`hex()`](https://python-all.ru/3.10/library/functions.html#hex). [Именованный кортеж](https://python-all.ru/3.10/glossary.html#term-named-tuple) [`sys.version_info`](https://python-all.ru/3.10/library/sys.html#sys.version_info) может использоваться для более удобочитаемого кодирования той же информации.514515Более подробная информация о `hexversion` доступна на [API and ABI Versioning](https://python-all.ru/3.10/c-api/apiabiversion.html#apiabiversion).516517#### `sys.implementation`518519Объект, содержащий информацию о реализации текущего интерпретатора Python. Следующие атрибуты должны существовать во всех реализациях Python.520521*name* – идентификатор реализации, например `'cpython'`. Фактическая строка определяется реализацией Python, но гарантированно состоит из строчных букв.522523*version* – это именованный кортеж в том же формате, что и [`sys.version_info`](https://python-all.ru/3.10/library/sys.html#sys.version_info). Он представляет версию *реализации* Python. Это отличается от конкретной версии *языка* Python, которой соответствует текущий интерпретатор, которая представлена `sys.version_info`. Например, для PyPy 1.8 `sys.implementation.version` может быть `sys.version_info(1, 8, 0, 'final', 0)`, тогда как `sys.version_info` будет `sys.version_info(2, 7, 2, 'final', 0)`. Для CPython они совпадают, так как это эталонная реализация.524525*hexversion* – это версия реализации в шестнадцатеричном формате, например [`sys.hexversion`](https://python-all.ru/3.10/library/sys.html#sys.hexversion).526527*cache\_tag* – это тег, используемый механизмом импорта в именах файлов кэшированных модулей. По соглашению, он представляет собой комбинацию имени и версии реализации, например `'cpython-33'`. Однако реализация Python может использовать другое значение, если это уместно. Если `cache_tag` установлено в `None`, это означает, что кэширование модулей должно быть отключено.528529[`sys.implementation`](https://python-all.ru/3.10/library/sys.html#sys.implementation) может содержать дополнительные атрибуты, специфичные для реализации Python. Эти нестандартные атрибуты должны начинаться с подчеркивания и не описываются здесь. Независимо от содержимого, [`sys.implementation`](https://python-all.ru/3.10/library/sys.html#sys.implementation) не будет изменяться во время работы интерпретатора, а также между версиями реализации. (Однако он может измениться между версиями языка Python.) Смотри [**PEP 421**](https://python-all.ru/3.10/library/sys.html) для получения дополнительной информации.530531Новое в версии 3.3.532533> **Примечание**534>535> Добавление новых обязательных атрибутов должно проходить через обычный процесс PEP. Смотри [**PEP 421**](https://python-all.ru/3.10/library/sys.html) для получения дополнительной информации.536537#### `sys.int_info`538539[Именованный кортеж](https://python-all.ru/3.10/glossary.html#term-named-tuple), содержащий информацию о внутреннем представлении целых чисел в Python. Атрибуты доступны только для чтения.540541| Атрибут | Пояснение |542| --- | --- |543| `bits_per_digit` | количество бит в каждом разряде. Целые числа Python хранятся внутри в системе с основанием `2**int_info.bits_per_digit` |544| `sizeof_digit` | размер в байтах типа C, используемого для представления разряда |545| `default_max_str_digits` | значение по умолчанию для [`sys.get_int_max_str_digits()`](https://python-all.ru/3.10/library/sys.html#sys.get_int_max_str_digits), если не задано явно |546| `str_digits_check_threshold` | минимальное ненулевое значение для [`sys.set_int_max_str_digits()`](https://python-all.ru/3.10/library/sys.html#sys.set_int_max_str_digits), [`PYTHONINTMAXSTRDIGITS`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONINTMAXSTRDIGITS) или [`-X int_max_str_digits`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) |547548Новое в версии 3.1.549550Изменено в версии 3.10.7: Добавлены `default_max_str_digits` и `str_digits_check_threshold`551552#### `sys.__interactivehook__`553554Когда этот атрибут существует, его значение автоматически вызывается (без аргументов) при запуске интерпретатора в [интерактивном режиме](https://python-all.ru/3.10/tutorial/interpreter.html#tut-interactive). Это происходит после чтения файла [`PYTHONSTARTUP`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONSTARTUP), чтобы можно было установить этот перехватчик там. Модуль [`site`](https://python-all.ru/3.10/library/site.html#module-site) [устанавливает это](https://python-all.ru/3.10/library/site.html#rlcompleter-config).555556Вызывает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `cpython.run_interactivehook` с объектом перехватчика в качестве аргумента при вызове перехватчика при запуске.557558Новое в версии 3.4.559560#### `sys.intern(string)`561562Помещает *строку* в таблицу «интернированных» строк и возвращает интернированную строку – *строку* (ту же самую или копию). Интернирование строк полезно для небольшого повышения производительности поиска в словаре: если ключи в словаре интернированы и искомый ключ интернирован, сравнение ключей (после хеширования) может выполняться сравнением указателей, а не строк. Обычно имена, используемые в программах Python, автоматически интернируются, и словари, используемые для хранения атрибутов модулей, классов или экземпляров, имеют интернированные ключи.563564Интернированные строки не бессмертны; необходимо сохранять ссылку на возвращаемое значение [`intern()`](https://python-all.ru/3.10/library/sys.html#sys.intern), чтобы воспользоваться этим.565566#### `sys.is_finalizing()`567568Возвращает [`True`](https://python-all.ru/3.10/library/constants.html#True), если интерпретатор Python [завершает работу](https://python-all.ru/3.10/glossary.html#term-interpreter-shutdown), иначе [`False`](https://python-all.ru/3.10/library/constants.html#False).569570Новое в версии 3.5.571572#### `sys.last_type`573574#### `sys.last_value`575576#### `sys.last_traceback`577578Эти три переменные определены не всегда; они устанавливаются, когда исключение не обработано и интерпретатор выводит сообщение об ошибке и трассировку стека. Их предназначение – позволить интерактивному пользователю импортировать модуль отладчика и заняться посмертной отладкой без необходимости повторно выполнять команду, вызвавшую ошибку. (Типичное использование – `import pdb; pdb.pm()` для входа в посмертный отладчик; см. модуль [`pdb`](https://python-all.ru/3.10/library/pdb.html#module-pdb) для получения дополнительной информации.)579580Смысл этих переменных такой же, как у возвращаемых значений [`exc_info()`](https://python-all.ru/3.10/library/sys.html#sys.exc_info) выше.581582#### `sys.maxsize`583584Целое число, задающее максимальное значение, которое может принимать переменная типа [`Py_ssize_t`](https://python-all.ru/3.10/c-api/intro.html#c.Py_ssize_t). Обычно это `2**31 - 1` на 32-битной платформе и `2**63 - 1` на 64-битной платформе.585586#### `sys.maxunicode`587588Целое число, задающее значение самого большого кодового пункта Unicode, то есть `1114111` (`0x10FFFF` в шестнадцатеричной записи).589590Изменено в версии 3.3: До [**PEP 393**](https://python-all.ru/3.10/library/sys.html), `sys.maxunicode` был либо `0xFFFF`, либо `0x10FFFF`, в зависимости от параметра конфигурации, определявшего, хранятся ли символы Unicode как UCS-2 или UCS-4.591592#### `sys.meta_path`593594Список объектов [искателей по метапути](https://python-all.ru/3.10/glossary.html#term-meta-path-finder), у которых вызываются методы [`find_spec()`](https://python-all.ru/3.10/library/importlib.html#importlib.abc.MetaPathFinder.find_spec), чтобы проверить, может ли один из объектов найти модуль для импорта. По умолчанию он содержит записи, реализующие стандартную семантику импорта Python. Метод [`find_spec()`](https://python-all.ru/3.10/library/importlib.html#importlib.abc.MetaPathFinder.find_spec) вызывается как минимум с абсолютным именем импортируемого модуля. Если импортируемый модуль находится внутри пакета, то в качестве второго аргумента передаётся атрибут [`__path__`](https://python-all.ru/3.10/reference/import.html#path__) родительского пакета. Метод возвращает [спецификацию модуля](https://python-all.ru/3.10/glossary.html#term-module-spec) или `None`, если модуль не найден.595596> **См. также**597>598> **[`importlib.abc.MetaPathFinder`](https://python-all.ru/3.10/library/importlib.html#importlib.abc.MetaPathFinder)**599>600> Абстрактный базовый класс, определяющий интерфейс объектов-искателей на [`meta_path`](https://python-all.ru/3.10/library/sys.html#sys.meta_path).601>602> **[`importlib.machinery.ModuleSpec`](https://python-all.ru/3.10/library/importlib.html#importlib.machinery.ModuleSpec)**603>604> Конкретный класс, экземпляры которого должен возвращать [`find_spec()`](https://python-all.ru/3.10/library/importlib.html#importlib.abc.MetaPathFinder.find_spec).605606Изменено в версии 3.4: [Спецификации модулей](https://python-all.ru/3.10/glossary.html#term-module-spec) были введены в Python 3.4, [**PEP 451**](https://python-all.ru/3.10/library/sys.html). В более ранних версиях Python искался метод с именем [`find_module()`](https://python-all.ru/3.10/library/importlib.html#importlib.abc.MetaPathFinder.find_module). Он по-прежнему вызывается как запасной вариант, если запись [`meta_path`](https://python-all.ru/3.10/library/sys.html#sys.meta_path) не имеет метода [`find_spec()`](https://python-all.ru/3.10/library/importlib.html#importlib.abc.MetaPathFinder.find_spec).607608#### `sys.modules`609610Это словарь, отображающий имена модулей на уже загруженные модули. Его можно изменять, чтобы принудительно перезагружать модули и выполнять другие трюки. Однако замена словаря не обязательно сработает как ожидается, а удаление важных элементов из словаря может привести к сбою Python. Если нужно перебрать этот глобальный словарь, всегда используйте `sys.modules.copy()` или `tuple(sys.modules)`, чтобы избежать исключений, так как его размер может меняться во время итерации из-за побочных эффектов кода или активности в других потоках.611612#### `sys.orig_argv`613614Список исходных аргументов командной строки, переданных исполняемому файлу Python.615616См. также [`sys.argv`](https://python-all.ru/3.10/library/sys.html#sys.argv).617618Новое в версии 3.10.619620#### `sys.path`621622Список строк, задающий путь поиска модулей. Инициализируется из переменной окружения [`PYTHONPATH`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONPATH), а также из специфичного для установки значения по умолчанию.623624При инициализации при запуске программы первый элемент этого списка, `path[0]`, содержит каталог со скриптом, который был использован для вызова интерпретатора Python. Если каталог скрипта недоступен (например, если интерпретатор запущен в интерактивном режиме или скрипт читается из стандартного ввода), `path[0]` является пустой строкой, что заставляет Python сначала искать модули в текущем каталоге. Обратите внимание, что каталог скрипта вставляется *до* записей, добавленных в результате [`PYTHONPATH`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONPATH)625626Программа может изменять этот список для своих целей. В [`sys.path`](https://python-all.ru/3.10/library/sys.html#sys.path) следует добавлять только строки и байты; все остальные типы данных игнорируются при импорте627628> **См. также**629>630> Модуль [`site`](https://python-all.ru/3.10/library/site.html#module-site). Здесь описывается, как использовать .pth-файлы для расширения [`sys.path`](https://python-all.ru/3.10/library/sys.html#sys.path)631632#### `sys.path_hooks`633634Список вызываемых объектов, которые принимают аргумент-путь и пытаются создать [искатель](https://python-all.ru/3.10/glossary.html#term-finder) для этого пути. Если искатель может быть создан, вызываемый объект должен вернуть его, иначе – возбудить [`ImportError`](https://python-all.ru/3.10/library/exceptions.html#ImportError).635636Впервые описано в [**PEP 302**](https://python-all.ru/3.10/library/sys.html).637638#### `sys.path_importer_cache`639640Словарь, выступающий в роли кэша для объектов [finder](https://python-all.ru/3.10/glossary.html#term-finder). Ключами являются пути, переданные в [`sys.path_hooks`](https://python-all.ru/3.10/library/sys.html#sys.path_hooks), а значениями – найденные finder'ы. Если путь является корректным файловым системным путём, но на [`sys.path_hooks`](https://python-all.ru/3.10/library/sys.html#sys.path_hooks) не найден ни один finder, то сохраняется `None`.641642Впервые описано в [**PEP 302**](https://python-all.ru/3.10/library/sys.html).643644Изменено в версии 3.3: `None` сохраняется вместо [`imp.NullImporter`](https://python-all.ru/3.10/library/imp.html#imp.NullImporter), когда finder не найден.645646#### `sys.platform`647648Эта строка содержит идентификатор платформы, который можно использовать, например, для добавления платформозависимых компонентов к [`sys.path`](https://python-all.ru/3.10/library/sys.html#sys.path).649650Для систем Unix, кроме Linux и AIX, это имя ОС в нижнем регистре, полученное с помощью `uname -s`, к которому добавляется первая часть версии, возвращаемая `uname -r`, например `'sunos5'` или `'freebsd8'`, *на момент сборки Python*. Если не требуется проверять конкретную версию системы, рекомендуется использовать следующий идиоматический код:651652```python653if sys.platform.startswith('freebsd'):654    # Код, специфичный для FreeBSD, здесь...655elif sys.platform.startswith('linux'):656    # Код, специфичный для Linux...657elif sys.platform.startswith('aix'):658    # Код, специфичный для AIX...659```660661Для остальных систем значения следующие:662663| Система | `platform` значение |664| --- | --- |665| AIX | `'aix'` |666| Linux | `'linux'` |667| Windows | `'win32'` |668| Windows/Cygwin | `'cygwin'` |669| macOS | `'darwin'` |670671Изменено в версии 3.3: В Linux [`sys.platform`](https://python-all.ru/3.10/library/sys.html#sys.platform) больше не содержит основной номер версии. Теперь это всегда `'linux'`, а не `'linux2'` или `'linux3'`. Поскольку более старые версии Python включали номер версии, рекомендуется всегда использовать `startswith` идиоматический код, представленный выше.672673Изменено в версии 3.8: В AIX [`sys.platform`](https://python-all.ru/3.10/library/sys.html#sys.platform) больше не содержит основной номер версии. Теперь это всегда `'aix'`, а не `'aix5'` или `'aix7'`. Поскольку более старые версии Python включали номер версии, рекомендуется всегда использовать `startswith` идиоматический код, представленный выше.674675> **См. также**676>677> [`os.name`](https://python-all.ru/3.10/library/os.html#os.name) имеет более грубую гранулярность. [`os.uname()`](https://python-all.ru/3.10/library/os.html#os.uname) выдаёт зависящую от системы информацию о версии.678>679> Модуль [`platform`](https://python-all.ru/3.10/library/platform.html#module-platform) предоставляет подробные проверки идентификации системы.680681#### `sys.platlibdir`682683Имя каталога библиотеки, специфичного для платформы. Используется для построения пути к стандартной библиотеке и путей к установленным модулям расширений.684685Оно равно `"lib"` на большинстве платформ. На Fedora и SuSE на 64-битных платформах оно равно `"lib64"`, что даёт следующие пути `sys.path` (где `X.Y` – это версия Python `major.minor`):686687- `/usr/lib64/pythonX.Y/`: Стандартная библиотека (например, `os.py` модуля [`os`](https://python-all.ru/3.10/library/os.html#module-os))688- `/usr/lib64/pythonX.Y/lib-dynload/`: Модули C-расширений стандартной библиотеки (например, модуль [`errno`](https://python-all.ru/3.10/library/errno.html#module-errno), точное имя файла зависит от платформы)689- `/usr/lib/pythonX.Y/site-packages/` (всегда используйте `lib`, а не [`sys.platlibdir`](https://python-all.ru/3.10/library/sys.html#sys.platlibdir)): Сторонние модули690- `/usr/lib64/pythonX.Y/site-packages/`: Модули C-расширений сторонних пакетов691692Новое в версии 3.9.693694#### `sys.prefix`695696Строка, содержащая префикс каталога, специфичный для сайта, куда устанавливаются платформенно-независимые файлы Python; на Unix по умолчанию используется `/usr/local`. Этот префикс можно задать во время сборки с помощью аргумента [`--prefix`](https://python-all.ru/3.10/using/configure.html#cmdoption-prefix) скрипта **configure**. Полученные пути описаны в [путях установки](https://python-all.ru/3.10/library/sysconfig.html#installation-paths).697698> **Примечание**699>700> Если [виртуальное окружение](https://python-all.ru/3.10/library/venv.html#venv-def) активно, это значение изменится в `site.py`, чтобы указывать на виртуальное окружение. Значение для установки Python по-прежнему будет доступно через [`base_prefix`](https://python-all.ru/3.10/library/sys.html#sys.base_prefix).701702#### `sys.ps1`703704#### `sys.ps2`705706Строки, задающие основное и дополнительное приглашения интерпретатора. Они определены только в интерактивном режиме. Их начальные значения в этом случае – `'>>> '` и `'... '`. Если одной из этих переменных присвоить объект, не являющийся строкой, его [`str()`](https://python-all.ru/3.10/library/stdtypes.html#str) будет вычисляться заново каждый раз, когда интерпретатор готовится читать новую интерактивную команду; это можно использовать для реализации динамического приглашения.707708#### `sys.setdlopenflags(n)`709710Устанавливает флаги, используемые интерпретатором для вызовов `dlopen()`, например, при загрузке модулей расширений. В частности, это включает отложенное разрешение символов при импорте модуля, если вызвано как `sys.setdlopenflags(0)`. Чтобы обмениваться символами между модулями расширений, вызывайте как `sys.setdlopenflags(os.RTLD_GLOBAL)`. Символические имена значений флагов можно найти в модуле [`os`](https://python-all.ru/3.10/library/os.html#module-os) (константы `RTLD_xxx`, например [`os.RTLD_LAZY`](https://python-all.ru/3.10/library/os.html#os.RTLD_LAZY)).711712[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Unix.713714#### `sys.set_int_max_str_digits(maxdigits)`715716Устанавливает [ограничение на длину строкового представления целых чисел](https://python-all.ru/3.10/library/stdtypes.html#int-max-str-digits), используемое этим интерпретатором. См. также [`get_int_max_str_digits()`](https://python-all.ru/3.10/library/sys.html#sys.get_int_max_str_digits).717718Новое в версии 3.10.7.719720#### `sys.setprofile(profilefunc)`721722Устанавливает профилирующую функцию системы, которая позволяет реализовать профилировщик исходного кода Python на Python. Дополнительную информацию о профилировщике Python см. в главе [Профилировщики Python](https://python-all.ru/3.10/library/profile.html#profile). Системная профилирующая функция вызывается аналогично системной трассировочной функции (см. [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace)), но с другими событиями; например, она не вызывается для каждой исполняемой строки кода (только при вызове и возврате, причём событие возврата сообщается даже при установленном исключении). Функция привязана к потоку, но у профилировщика нет способа узнать о переключениях контекста между потоками, поэтому использовать её в многопоточном окружении не имеет смысла. Кроме того, её возвращаемое значение не используется, так что она может просто возвращать `None`. Ошибка в профилирующей функции приведёт к её сбросу.723724Функции профилирования должны принимать три аргумента: *frame*, *event* и *arg*. *frame* – это текущий стековый фрейм. *event* – строка: `'call'`, `'return'`, `'c_call'`, `'c_return'` или `'c_exception'`. *arg* зависит от типа события.725726Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys.setprofile` без аргументов.727728События имеют следующее значение:729730**`'call'`**731732Вызывается функция (или выполняется вход в другой блок кода). Вызывается профилирующая функция; *arg* равен `None`.733734**`'return'`**735736Функция (или другой блок кода) собирается вернуть результат. Вызывается профилирующая функция; *arg* – это возвращаемое значение, или `None`, если событие вызвано возбуждением исключения.737738**`'c_call'`**739740Готовится вызов C-функции. Это может быть функция расширения или встроенная функция. *arg* – это объект C-функции.741742**`'c_return'`**743744C-функция вернула результат. *arg* – это объект C-функции.745746**`'c_exception'`**747748C-функция возбудила исключение. *arg* – это объект C-функции.749750#### `sys.setrecursionlimit(limit)`751752Устанавливает максимальную глубину стека интерпретатора Python в *limit*. Этот предел предотвращает переполнение C-стека из-за бесконечной рекурсии и аварийное завершение Python.753754Максимально возможный предел зависит от платформы. Пользователь может увеличить предел, если программа требует глубокой рекурсии, а платформа поддерживает более высокий предел. Это следует делать с осторожностью, так как слишком высокий предел может привести к аварийному завершению.755756Если новый предел слишком мал для текущей глубины рекурсии, возбуждается исключение [`RecursionError`](https://python-all.ru/3.10/library/exceptions.html#RecursionError).757758Изменено в версии 3.5.1: Теперь возбуждается исключение [`RecursionError`](https://python-all.ru/3.10/library/exceptions.html#RecursionError), если новый предел слишком мал для текущей глубины рекурсии.759760#### `sys.setswitchinterval(interval)`761762Устанавливает интервал переключения потоков интерпретатора (в секундах). Это значение с плавающей точкой определяет идеальную длительность «квантов времени», выделяемых одновременно работающим потокам Python. Обратите внимание, что фактическое значение может быть больше, особенно при использовании долго выполняющихся внутренних функций или методов. Кроме того, какой поток будет запланирован по окончании интервала, решает операционная система – у интерпретатора нет собственного планировщика.763764Новое в версии 3.2.765766#### `sys.settrace(tracefunc)`767768Устанавливает трассировочную функцию системы, которая позволяет реализовать отладчик исходного кода Python на Python. Функция привязана к потоку; чтобы отладчик поддерживал несколько потоков, он должен зарегистрировать трассировочную функцию с помощью [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace) для каждого отлаживаемого потока или использовать [`threading.settrace()`](https://python-all.ru/3.10/library/threading.html#threading.settrace).769770Функции трассировки должны принимать три аргумента: *frame*, *event* и *arg*. *frame* – текущий стековый кадр. *event* – строка: `'call'`, `'line'`, `'return'`, `'exception'` или `'opcode'`. *arg* зависит от типа события.771772Трассировочная функция вызывается (с *event*, установленным в `'call'`) всякий раз, когда входит в новую локальную область видимости; она должна возвращать ссылку на локальную трассировочную функцию для новой области или `None`, если область не должна трассироваться.773774Локальная трассировочная функция должна возвращать ссылку на себя (или на другую функцию для дальнейшей трассировки в этой области видимости) или `None` для отключения трассировки в этой области775776Если в функции трассировки произошла ошибка, она будет отключена, как если бы была вызвана `settrace(None)`.777778События имеют следующее значение:779780**`'call'`**781782Функция вызвана (или начат другой блок кода). Вызывается глобальная функция трассировки; *arg* равно `None`; возвращаемое значение задаёт локальную функцию трассировки.783784**`'line'`**785786Интерпретатор собирается выполнить новую строку кода или повторно вычислить условие цикла. Вызывается локальная трассировочная функция; *arg* равно `None`; возвращаемое значение задаёт новую локальную трассировочную функцию. См. `Objects/lnotab_notes.txt` для подробного объяснения работы этого механизма. События на строку могут быть отключены для фрейма установкой `f_trace_lines` в [`False`](https://python-all.ru/3.10/library/constants.html#False) на этом фрейме787788**`'return'`**789790Функция (или другой блок кода) собирается вернуть значение. Вызывается локальная функция трассировки; *arg* – это значение, которое будет возвращено, или `None`, если событие вызвано возбуждённым исключением. Возвращаемое значение функции трассировки игнорируется.791792**`'exception'`**793794Произошло исключение. Вызывается локальная функция трассировки; *arg* – это кортеж `(exception, value, traceback)`; возвращаемое значение задаёт новую локальную функцию трассировки.795796**`'opcode'`**797798Интерпретатор собирается выполнить новый опкод (см. [`dis`](https://python-all.ru/3.10/library/dis.html#module-dis) для подробностей об опкодах). Вызывается локальная трассировочная функция; *arg* равно `None`; возвращаемое значение задаёт новую локальную трассировочную функцию. События на опкод не генерируются по умолчанию; их необходимо явно запросить, установив `f_trace_opcodes` в [`True`](https://python-all.ru/3.10/library/constants.html#True) на фрейме799800Обратите внимание, что при распространении исключения по цепочке вызывающих на каждом уровне генерируется событие `'exception'`.801802Для более тонкого управления можно задать функцию трассировки явно, присвоив `frame.f_trace = tracefunc`, а не полагаясь на то, что она будет установлена косвенно через возвращаемое значение уже установленной функции трассировки. Это также необходимо для активации функции трассировки на текущем фрейме, чего [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace) не делает. Обратите внимание, что для этого глобальная функция трассировки должна быть установлена с помощью [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace), чтобы включить механизм трассировки времени выполнения, но это не обязательно должна быть та же самая функция трассировки (например, это может быть функция с низкими накладными расходами, которая просто возвращает `None`, чтобы немедленно отключить себя на каждом фрейме).803804Дополнительную информацию об объектах кода и фреймах см. в [Стандартной иерархии типов](https://python-all.ru/3.10/reference/datamodel.html#types).805806Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys.settrace` без аргументов.807808**Особенность реализации CPython:** Функция [`settrace()`](https://python-all.ru/3.10/library/sys.html#sys.settrace) предназначена только для реализации отладчиков, профилировщиков, инструментов покрытия кода и тому подобного. Её поведение является частью платформы реализации, а не частью определения языка, и поэтому может быть недоступно во всех реализациях Python.809810Изменено в версии 3.7: Добавлен тип события `'opcode'`; добавлены атрибуты `f_trace_lines` и `f_trace_opcodes` у фреймов.811812#### `sys.set_asyncgen_hooks(firstiter, finalizer)`813814Принимает два необязательных именованных аргумента, которые являются вызываемыми объектами, принимающими [итератор асинхронного генератора](https://python-all.ru/3.10/glossary.html#term-asynchronous-generator-iterator) в качестве аргумента. Вызываемый объект *firstiter* будет вызван, когда асинхронный генератор будет итерирован в первый раз. Вызываемый объект *finalizer* будет вызван, когда асинхронный генератор будет готов к сборке мусора.815816Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys.set_asyncgen_hooks_firstiter` без аргументов.817818Возбуждает [событие аудита](https://python-all.ru/3.10/library/sys.html#auditing) `sys.set_asyncgen_hooks_finalizer` без аргументов.819820Генерируются два события аудита, поскольку базовый API состоит из двух вызовов, каждый из которых должен порождать собственное событие.821822Новое в версии 3.6: Подробности см. в [**PEP 525**](https://python-all.ru/3.10/library/sys.html), а пример реализации метода *finalizer* – в коде `asyncio.Loop.shutdown_asyncgens` из [Lib/asyncio/base\_events.py](https://python-all.ru/src/3.10/Lib/asyncio/base_events.py)823824> **Примечание**825>826> Эта функция была добавлена на временной основе (см. [**PEP 411**](https://python-all.ru/3.10/library/sys.html) для подробностей).827828#### `sys.set_coroutine_origin_tracking_depth(depth)`829830Позволяет включить или отключить отслеживание источника корутин. При включении атрибут `cr_origin` объектов-корутин будет содержать кортеж из троек (имя файла, номер строки, имя функции), описывающих трассировку места создания объекта-корутины, причем самый последний вызов будет первым. При отключении `cr_origin` будет равен None.831832Чтобы включить, передайте значение *depth* больше нуля; это задаёт количество фреймов, информация о которых будет захвачена. Чтобы отключить, передайте для *depth* значение ноль.833834Эта настройка является потоковой.835836Добавлено в версии 3.7.837838> **Примечание**839>840> Эта функция была добавлена на временной основе (см. [**PEP 411**](https://python-all.ru/3.10/library/sys.html) для подробностей). Используйте её только для целей отладки.841842#### `sys._enablelegacywindowsfsencoding()`843844Изменяет [кодировку файловой системы и обработчик ошибок](https://python-all.ru/3.10/glossary.html#term-filesystem-encoding-and-error-handler) на ‘mbcs’ и ‘replace’ соответственно для совместимости с версиями Python старше 3.6.845846Это эквивалентно установке переменной окружения [`PYTHONLEGACYWINDOWSFSENCODING`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONLEGACYWINDOWSFSENCODING) перед запуском Python.847848См. также [`sys.getfilesystemencoding()`](https://python-all.ru/3.10/library/sys.html#sys.getfilesystemencoding) и [`sys.getfilesystemencodeerrors()`](https://python-all.ru/3.10/library/sys.html#sys.getfilesystemencodeerrors).849850[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Windows.851852Новое в версии 3.6: Подробности см. в [**PEP 529**](https://python-all.ru/3.10/library/sys.html).853854#### `sys.stdin`855856#### `sys.stdout`857858#### `sys.stderr`859860[Объекты файлов](https://python-all.ru/3.10/glossary.html#term-file-object), используемые интерпретатором для стандартного ввода, вывода и ошибок:861862- `stdin` используется для всего интерактивного ввода (включая вызовы [`input()`](https://python-all.ru/3.10/library/functions.html#input));863- `stdout` используется для вывода [`print()`](https://python-all.ru/3.10/library/functions.html#print) и [выражений](https://python-all.ru/3.10/glossary.html#term-expression), а также для приглашений [`input()`](https://python-all.ru/3.10/library/functions.html#input);864- Собственные приглашения интерпретатора и его сообщения об ошибках выводятся в `stderr`.865866Эти потоки являются обычными [текстовыми файлами](https://python-all.ru/3.10/glossary.html#term-text-file), подобными тем, что возвращает функция [`open()`](https://python-all.ru/3.10/library/functions.html#open). Их параметры выбираются следующим образом:867868- Кодировка и обработка ошибок инициализируются из [`PyConfig.stdio_encoding`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig.stdio_encoding) и [`PyConfig.stdio_errors`](https://python-all.ru/3.10/c-api/init_config.html#c.PyConfig.stdio_errors).869870  В Windows для консольного устройства используется UTF-8. Несимвольные устройства, такие как дисковые файлы и каналы, используют кодировку системной локали (то есть кодовую страницу ANSI). Не консольные символьные устройства, такие как NUL (то есть когда `isatty()` возвращает `True`), используют значения кодовых страниц консольного ввода и вывода при запуске, соответственно для stdin и stdout/stderr. По умолчанию это [кодировка локали](https://python-all.ru/3.10/glossary.html#term-locale-encoding) системы, если процесс изначально не прикреплен к консоли.871872  Особое поведение консоли можно переопределить, установив переменную окружения PYTHONLEGACYWINDOWSSTDIO перед запуском Python. В этом случае кодовые страницы консоли используются как для любого другого символьного устройства.873874  На всех платформах можно переопределить кодировку символов, установив переменную окружения [`PYTHONIOENCODING`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONIOENCODING) перед запуском Python или используя новый параметр командной строки [`-X`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X) `utf8` и переменную окружения [`PYTHONUTF8`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONUTF8). Однако для консоли Windows это применимо только в том случае, если также установлена [`PYTHONLEGACYWINDOWSSTDIO`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONLEGACYWINDOWSSTDIO).875- В интерактивном режиме поток `stdout` буферизуется построчно. В противном случае он буферизуется блоками, как обычные текстовые файлы. Поток `stderr` буферизуется построчно в обоих случаях. Оба потока можно сделать небуферизованными, передав параметр командной строки [`-u`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-u) или установив переменную окружения [`PYTHONUNBUFFERED`](https://python-all.ru/3.10/using/cmdline.html#envvar-PYTHONUNBUFFERED).876877Изменено в версии 3.9: Неинтерактивный `stderr` теперь буферизуется построчно вместо полной буферизации.878879> **Примечание**880>881> Для записи или чтения двоичных данных в/из стандартных потоков используйте базовый двоичный объект [`buffer`](https://python-all.ru/3.10/library/io.html#io.TextIOBase.buffer). Например, для записи байтов в [`stdout`](https://python-all.ru/3.10/library/sys.html#sys.stdout) используйте `sys.stdout.buffer.write(b'abc')`.882>883> Однако если вы пишете библиотеку (и не контролируете, в каком контексте будет выполняться её код), имейте в виду, что стандартные потоки могут быть заменены объектами, подобными файлам, такими как [`io.StringIO`](https://python-all.ru/3.10/library/io.html#io.StringIO), которые не поддерживают атрибут `buffer`.884885#### `sys.__stdin__`886887#### `sys.__stdout__`888889#### `sys.__stderr__`890891Эти объекты содержат исходные значения `stdin`, `stderr` и `stdout` в начале программы. Они используются во время финализации и могут быть полезны для вывода в реальный стандартный поток, независимо от того, был ли перенаправлен объект `sys.std*`.892893Его также можно использовать для восстановления реальных файлов до известных работающих файловых объектов, если они были перезаписаны некорректным объектом. Однако предпочтительный способ – явно сохранить предыдущий поток перед его заменой и восстановить сохранённый объект.894895> **Примечание**896>897> При некоторых условиях `stdin`, `stdout` и `stderr`, а также исходные значения `__stdin__`, `__stdout__` и `__stderr__` могут быть `None`. Обычно это происходит в Windows GUI-приложениях, не подключённых к консоли, и в приложениях Python, запущенных с помощью **pythonw**.898899#### `sys.stdlib_module_names`900901Frozenset строк, содержащий имена модулей стандартной библиотеки.902903Он одинаков на всех платформах. Также перечислены модули, недоступные на некоторых платформах, и модули, отключённые при сборке Python. Перечислены все типы модулей: чистые Python-, встроенные, замороженные и модули-расширения. Тестовые модули исключены.904905Для пакетов перечислен только основной пакет: подпакеты и подмодули не перечисляются. Например, пакет `email` перечислен, а подпакет `email.mime` и подмодуль `email.message` – нет.906907См. также список [`sys.builtin_module_names`](https://python-all.ru/3.10/library/sys.html#sys.builtin_module_names).908909Новое в версии 3.10.910911#### `sys.thread_info`912913[Именованный кортеж](https://python-all.ru/3.10/glossary.html#term-named-tuple), содержащий информацию о реализации потоков.914915| Атрибут | Пояснение |916| --- | --- |917| `name` | Имя реализации потоков `'nt'`: потоки Windows `'pthread'`: потоки POSIX `'solaris'`: потоки Solaris |918| `lock` | Имя реализации блокировки: `'semaphore'`: блокировка использует семафор `'mutex+cond'`: блокировка использует мьютекс и условную переменную `None`, если эта информация неизвестна |919| [`version`](https://python-all.ru/3.10/library/sys.html#sys.version) | Имя и версия библиотеки потоков. Это строка, или `None`, если эта информация неизвестна. |920921Новое в версии 3.3.922923#### `sys.tracebacklimit`924925Когда этой переменной присвоено целое значение, она определяет максимальное количество уровней трассировки, выводимых при необработанном исключении. По умолчанию `1000`. Если установлено `0` или меньше, вся информация трассировки подавляется и выводятся только тип и значение исключения.926927#### `sys.unraisablehook(unraisable, /)`928929Обрабатывает неподнимаемое исключение.930931Вызывается, когда произошло исключение, но у Python нет способа его обработать. Например, когда деструктор вызывает исключение или во время сборки мусора ([`gc.collect()`](https://python-all.ru/3.10/library/gc.html#gc.collect)).932933Аргумент *unraisable* имеет следующие атрибуты:934935- *exc\_type*: тип исключения.936- *exc\_value*: значение исключения, может быть `None`.937- *exc\_traceback*: трассировка исключения, может быть `None`.938- *err\_msg*: Сообщение об ошибке, может быть `None`.939- *object*: Объект, вызвавший исключение, может быть `None`.940941Стандартный хук форматирует *err\_msg* и *object* следующим образом: `f'{err_msg}: {object!r}'`; использует сообщение об ошибке “Исключение проигнорировано в” если *err\_msg* равно `None`.942943[`sys.unraisablehook()`](https://python-all.ru/3.10/library/sys.html#sys.unraisablehook) можно переопределить, чтобы управлять обработкой неподнимаемых исключений.944945Сохранение *exc\_value* с помощью пользовательского перехватчика может создать циклическую ссылку. Её следует явно очистить, чтобы разорвать цикл ссылок, когда исключение больше не нужно.946947Сохранение *object* с помощью пользовательского хука может возродить его, если оно установлено на объект, который находится в процессе финализации. Избегайте сохранения *object* после завершения пользовательского хука, чтобы не возрождать объекты.948949См. также [`excepthook()`](https://python-all.ru/3.10/library/sys.html#sys.excepthook), который обрабатывает неперехваченные исключения.950951Порождает событие аудита `sys.unraisablehook` с аргументами `hook`, `unraisable`, когда возникает исключение, которое невозможно обработать. Объект `unraisable` тот же, что будет передан хуку. Если хук не был установлен, `hook` может быть `None`.952953Новое в версии 3.8.954955#### `sys.version`956957Строка, содержащая номер версии интерпретатора Python, а также дополнительную информацию о номере сборки и используемом компиляторе. Эта строка отображается при запуске интерактивного интерпретатора. Не извлекайте из неё информацию о версии; вместо этого используйте [`version_info`](https://python-all.ru/3.10/library/sys.html#sys.version_info) и функции, предоставляемые модулем [`platform`](https://python-all.ru/3.10/library/platform.html#module-platform).958959#### `sys.api_version`960961Версия C API для данного интерпретатора. Программисты могут счесть это полезным при отладке конфликтов версий между Python и модулями расширения.962963#### `sys.version_info`964965Кортеж, содержащий пять компонентов номера версии: *major*, *minor*, *micro*, *releaselevel* и *serial*. Все значения, кроме *releaselevel*, являются целыми числами; уровень выпуска – `'alpha'`, `'beta'`, `'candidate'` или `'final'`. Значение `version_info`, соответствующее версии Python 2.0, равно `(2, 0, 0, 'final', 0)`. Компоненты также можно получать по имени, поэтому `sys.version_info[0]` эквивалентно `sys.version_info.major` и так далее.966967Изменено в версии 3.1: Добавлены именованные атрибуты компонентов.968969#### `sys.warnoptions`970971Это деталь реализации механизма предупреждений; не изменяйте это значение. Обратитесь к модулю [`warnings`](https://python-all.ru/3.10/library/warnings.html#module-warnings) за дополнительной информацией о механизме предупреждений.972973#### `sys.winver`974975Номер версии, используемый для формирования ключей реестра на платформах Windows. Он хранится как строковый ресурс 1000 в DLL Python. Обычно значение представляет собой основной и дополнительный номера версии работающего интерпретатора Python. Он предоставляется в модуле [`sys`](https://python-all.ru/3.10/library/sys.html#module-sys) в информационных целях; изменение этого значения не влияет на ключи реестра, используемые Python.976977[Доступность](https://python-all.ru/3.10/library/intro.html#availability): Windows.978979#### `sys._xoptions`980981Словарь различных флагов, специфичных для реализации, переданных через параметр командной строки [`-X`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X). Имена параметров либо сопоставляются с их значениями, если они указаны явно, либо с [`True`](https://python-all.ru/3.10/library/constants.html#True). Пример:982983```console984$ ./python -Xa=b -Xc985Python 3.2a3+ (py3k, Oct 16 2010, 20:14:50)986[GCC 4.4.3] on linux2987Type "help", "copyright", "credits" or "license" for more information.988>>> import sys989>>> sys._xoptions990{'a': 'b', 'c': True}991```992993**Особенность реализации CPython:** Это специфичный для CPython способ доступа к параметрам, переданным через [`-X`](https://python-all.ru/3.10/using/cmdline.html#cmdoption-X). Другие реализации могут экспортировать их другими средствами или не экспортировать вовсе.994995Новое в версии 3.2.996997Ссылки998999**[C99](https://python-all.ru/3.10/library/sys.html#id1)**10001001ISO/IEC 9899:1999. «Programming languages – C». Публичный проект этого стандарта доступен по адресу [https://www.open-std.org/jtc1/sc22/wg14/www/docs/n1256.pdf](https://python-all.ru/3.10/library/sys.html).1002