warnings.md
1> **Источник:** https://python-all.ru/3.8/library/warnings.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`warnings`](https://python-all.ru/3.8/library/warnings.html#module-warnings) – Управление предупреждениями89**Исходный код:** [Lib/warnings.py](https://python-all.ru/src/3.8/Lib/warnings.py)1011---1213Предупреждения обычно выводятся в ситуациях, когда полезно предупредить пользователя о некотором условии в программе, когда это условие (обычно) не требует возбуждения исключения и завершения программы. Например, может потребоваться выдать предупреждение, если программа использует устаревший модуль.1415Разработчики на Python выводят предупреждения, вызывая функцию [`warn()`](https://python-all.ru/3.8/library/warnings.html#warnings.warn), определённую в этом модуле. (Разработчики на C используют [`PyErr_WarnEx()`](https://python-all.ru/3.8/c-api/exceptions.html#c.PyErr_WarnEx); см. [Обработка исключений](https://python-all.ru/3.8/c-api/exceptions.html#exceptionhandling) для подробностей).1617Предупреждения обычно записываются в [`sys.stderr`](https://python-all.ru/3.8/library/sys.html#sys.stderr), но их обработку можно гибко изменять: от игнорирования всех предупреждений до превращения их в исключения. Обработка предупреждений может зависеть от [категории предупреждения](https://python-all.ru/3.8/library/warnings.html#warning-categories), текста предупреждающего сообщения и места в исходном коде, где оно выдается. Повторные предупреждения для одного и того же места в исходном коде обычно подавляются.1819Управление предупреждениями состоит из двух этапов: сначала каждый раз при выдаче предупреждения определяется, должно ли сообщение быть выдано; затем, если сообщение должно быть выдано, оно форматируется и выводится с помощью настраиваемого пользователем перехватчика.2021Решение о том, выдавать ли предупреждающее сообщение, управляется [фильтром предупреждений](https://python-all.ru/3.8/library/warnings.html#warning-filter), который представляет собой последовательность правил сопоставления и действий. Правила можно добавлять в фильтр, вызывая [`filterwarnings()`](https://python-all.ru/3.8/library/warnings.html#warnings.filterwarnings), и сбрасывать в состояние по умолчанию, вызывая [`resetwarnings()`](https://python-all.ru/3.8/library/warnings.html#warnings.resetwarnings).2223Вывод предупреждающих сообщений выполняется вызовом [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning), который может быть переопределён; реализация по умолчанию этой функции форматирует сообщение вызовом [`formatwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.formatwarning), который также доступен для использования в пользовательских реализациях.2425> **См. также**26>27> [`logging.captureWarnings()`](https://python-all.ru/3.8/library/logging.html#logging.captureWarnings) позволяет обрабатывать все предупреждения с помощью стандартной инфраструктуры журналирования.2829## Категории предупреждений3031Существует ряд встроенных исключений, представляющих категории предупреждений. Такая категоризация полезна для фильтрации групп предупреждений.3233Хотя технически это [встроенные исключения](https://python-all.ru/3.8/library/exceptions.html#warning-categories-as-exceptions), они documented here, потому что концептуально относятся к механизму предупреждений.3435Пользовательский код может определять дополнительные категории предупреждений, создавая подкласс одной из стандартных категорий предупреждений. Категория предупреждения всегда должна быть подклассом класса [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning).3637В настоящее время определены следующие классы категорий предупреждений:3839| Класс | Описание |40| --- | --- |41| [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning) | Это базовый класс всех классов категорий предупреждений. Он является подклассом [`Exception`](https://python-all.ru/3.8/library/exceptions.html#Exception). |42| [`UserWarning`](https://python-all.ru/3.8/library/exceptions.html#UserWarning) | Категория по умолчанию для [`warn()`](https://python-all.ru/3.8/library/warnings.html#warnings.warn). |43| [`DeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#DeprecationWarning) | Базовая категория для предупреждений об устаревших возможностях, если эти предупреждения предназначены для других разработчиков Python (игнорируется по умолчанию, если не вызвано кодом в `__main__`). |44| [`SyntaxWarning`](https://python-all.ru/3.8/library/exceptions.html#SyntaxWarning) | Базовый тип для предупреждений о сомнительных синтаксических особенностях. |45| [`RuntimeWarning`](https://python-all.ru/3.8/library/exceptions.html#RuntimeWarning) | Базовая категория для предупреждений о сомнительных возможностях времени выполнения. |46| [`FutureWarning`](https://python-all.ru/3.8/library/exceptions.html#FutureWarning) | Базовая категория для предупреждений об устаревших возможностях, если эти предупреждения предназначены для конечных пользователей приложений, написанных на Python. |47| [`PendingDeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#PendingDeprecationWarning) | Базовая категория для предупреждений о возможностях, которые будут объявлены устаревшими в будущем (игнорируется по умолчанию). |48| [`ImportWarning`](https://python-all.ru/3.8/library/exceptions.html#ImportWarning) | Базовая категория для предупреждений, возникающих в процессе импорта модуля (игнорируется по умолчанию). |49| [`UnicodeWarning`](https://python-all.ru/3.8/library/exceptions.html#UnicodeWarning) | Базовая категория для предупреждений, связанных с Юникодом. |50| [`BytesWarning`](https://python-all.ru/3.8/library/exceptions.html#BytesWarning) | Базовая категория для предупреждений, связанных с [`bytes`](https://python-all.ru/3.8/library/stdtypes.html#bytes) и [`bytearray`](https://python-all.ru/3.8/library/stdtypes.html#bytearray). |51| [`ResourceWarning`](https://python-all.ru/3.8/library/exceptions.html#ResourceWarning) | Базовый класс для предупреждений, связанных с использованием ресурсов. |5253Изменено в версии 3.7: Ранее [`DeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#DeprecationWarning) и [`FutureWarning`](https://python-all.ru/3.8/library/exceptions.html#FutureWarning) различались по тому, удалялась ли возможность полностью или меняла своё поведение. Теперь они различаются по целевой аудитории и способу обработки фильтрами предупреждений по умолчанию.5455## Фильтр предупреждений5657Фильтр предупреждений управляет тем, игнорируются ли предупреждения, выводятся на экран или превращаются в ошибки (вызывают исключение).5859Концептуально фильтр предупреждений поддерживает упорядоченный список спецификаций фильтра; любое конкретное предупреждение последовательно сопоставляется с каждой спецификацией фильтра из списка, пока не будет найдено совпадение; фильтр определяет обработку совпадения. Каждая запись представляет собой кортеж вида (*действие*, *сообщение*, *категория*, *модуль*, *номер\_строки*), где:6061- *Действие* – одна из следующих строк:6263 | Значение | Действие |64 | --- | --- |65 | `"default"` | выводить первое вхождение подходящих предупреждений для каждого местоположения (модуль + номер строки), где выдано предупреждение |66 | `"error"` | превращать подходящие предупреждения в исключения |67 | `"ignore"` | никогда не выводить подходящие предупреждения |68 | `"always"` | всегда выводить подходящие предупреждения |69 | `"module"` | выводить первое вхождение подходящих предупреждений для каждого модуля, где выдано предупреждение (независимо от номера строки) |70 | `"once"` | выводить только первое вхождение подходящих предупреждений, независимо от местоположения |71- *message* – это строка с регулярным выражением, которому должно соответствовать начало предупреждающего сообщения. Выражение компилируется с игнорированием регистра.72- *category* – это класс (подкласс [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning)), подклассом которого должна быть категория предупреждения для совпадения.73- *module* – это строка с регулярным выражением, которому должно соответствовать имя модуля. Выражение компилируется с учётом регистра.74- *lineno* – это целое число, которому должен соответствовать номер строки, где произошло предупреждение, или `0` для соответствия всем номерам строк.7576Поскольку класс [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning) является наследником встроенного класса [`Exception`](https://python-all.ru/3.8/library/exceptions.html#Exception), чтобы превратить предупреждение в ошибку, мы просто возбуждаем `category(message)`.7778Если предупреждение зарегистрировано и не соответствует ни одному из установленных фильтров, то применяется действие «default» (отсюда и его название).7980### Описание фильтров предупреждений8182Фильтр предупреждений инициализируется опциями [`-W`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-w), переданными в командной строке интерпретатора Python, и переменной окружения [`PYTHONWARNINGS`](https://python-all.ru/3.8/using/cmdline.html#envvar-PYTHONWARNINGS). Интерпретатор сохраняет аргументы для всех предоставленных записей без интерпретации в [`sys.warnoptions`](https://python-all.ru/3.8/library/sys.html#sys.warnoptions); модуль [`warnings`](https://python-all.ru/3.8/library/warnings.html#module-warnings) анализирует их при первом импорте (недопустимые опции игнорируются после вывода сообщения в [`sys.stderr`](https://python-all.ru/3.8/library/sys.html#sys.stderr)).8384Отдельные фильтры предупреждений задаются в виде последовательности полей, разделённых двоеточиями:8586```python87action:message:category:module:line88```8990Значение каждого из этих полей описано в разделе [Фильтр предупреждений](https://python-all.ru/3.8/library/warnings.html#warning-filter). При перечислении нескольких фильтров в одной строке (как для [`PYTHONWARNINGS`](https://python-all.ru/3.8/using/cmdline.html#envvar-PYTHONWARNINGS)) отдельные фильтры разделяются запятыми, и фильтры, указанные позже, имеют приоритет над теми, что указаны раньше (поскольку они применяются слева направо, и последние применённые фильтры имеют преимущество перед более ранними).9192Обычно используемые фильтры предупреждений применяются либо ко всем предупреждениям, либо к предупреждениям определённой категории, либо к предупреждениям, вызванным определёнными модулями или пакетами. Несколько примеров:9394```python95default # Показывать все предупреждения (даже те, что игнорируются по умолчанию)96ignore # Игнорировать все предупреждения97error # Преобразовать все предупреждения в ошибки98error::ResourceWarning # Обрабатывать сообщения ResourceWarning как ошибки99default::DeprecationWarning # Показывать сообщения DeprecationWarning100ignore,default:::mymodule # Сообщать только о предупреждениях, вызванных "mymodule"101error:::mymodule[.*] # Преобразовывать предупреждения в ошибки в "mymodule"102 # и любые подпакеты "mymodule"103```104105### Фильтр предупреждений по умолчанию106107По умолчанию Python устанавливает несколько фильтров предупреждений, которые можно переопределить с помощью параметра командной строки [`-W`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-w), переменной окружения [`PYTHONWARNINGS`](https://python-all.ru/3.8/using/cmdline.html#envvar-PYTHONWARNINGS) и вызовов [`filterwarnings()`](https://python-all.ru/3.8/library/warnings.html#warnings.filterwarnings).108109В обычных сборках релиза фильтр предупреждений по умолчанию имеет следующие записи (в порядке приоритета):110111```python112default::DeprecationWarning:__main__113ignore::DeprecationWarning114ignore::PendingDeprecationWarning115ignore::ImportWarning116ignore::ResourceWarning117```118119В отладочных сборках список фильтров предупреждений по умолчанию пуст.120121Изменено в версии 3.2: [`DeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#DeprecationWarning) теперь по умолчанию игнорируется в дополнение к [`PendingDeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#PendingDeprecationWarning).122123Изменено в версии 3.7: [`DeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#DeprecationWarning) снова отображается по умолчанию при непосредственном вызове кодом в `__main__`.124125Изменено в версии 3.7: [`BytesWarning`](https://python-all.ru/3.8/library/exceptions.html#BytesWarning) больше не появляется в списке фильтров по умолчанию и вместо этого настраивается через [`sys.warnoptions`](https://python-all.ru/3.8/library/sys.html#sys.warnoptions), когда [`-b`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-b) указан дважды.126127### Переопределение фильтра по умолчанию128129Разработчики приложений на Python могут захотеть скрыть *все* предупреждения уровня Python от пользователей по умолчанию и показывать их только во время тестирования или другой работы над приложением. Атрибут [`sys.warnoptions`](https://python-all.ru/3.8/library/sys.html#sys.warnoptions), используемый для передачи конфигураций фильтра интерпретатору, может служить маркером, указывающим, следует ли отключить предупреждения:130131```python132import sys133134if not sys.warnoptions:135 import warnings136 warnings.simplefilter("ignore")137```138139Разработчикам средств запуска тестов для кода Python рекомендуется вместо этого обеспечить, чтобы *все* предупреждения отображались по умолчанию для тестируемого кода, используя код наподобие:140141```python142import sys143144if not sys.warnoptions:145 import os, warnings146 warnings.simplefilter("default") # Изменить фильтр в этом процессе147 os.environ["PYTHONWARNINGS"] = "default" # Также действовать на подпроцессы148```149150Наконец, разработчикам интерактивных оболочек, выполняющих пользовательский код в пространстве имён, отличном от `__main__`, рекомендуется обеспечить, чтобы сообщения [`DeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#DeprecationWarning) были видны по умолчанию, используя код наподобие следующего (где `user_ns` – это модуль, используемый для выполнения вводимого интерактивно кода):151152```python153import warnings154warnings.filterwarnings("default", category=DeprecationWarning,155 module=user_ns.get("__name__"))156```157158## Временное подавление предупреждений159160Если вы используете код, который, как известно, вызовет предупреждение (например, устаревшую функцию), но не хотите видеть это предупреждение (даже если предупреждения были явно настроены через командную строку), то предупреждение можно подавить с помощью контекстного менеджера [`catch_warnings`](https://python-all.ru/3.8/library/warnings.html#warnings.catch_warnings):161162```python163import warnings164165def fxn():166 warnings.warn("deprecated", DeprecationWarning)167168with warnings.catch_warnings():169 warnings.simplefilter("ignore")170 fxn()171```172173Пока менеджер контекста активен, все предупреждения просто игнорируются. Это позволяет использовать заведомо устаревший код, не видя предупреждения, при этом не подавляя предупреждения для другого кода, который может не знать об использовании устаревших функций. Примечание: это гарантируется только в однопоточном приложении. Если два или более потока одновременно используют менеджер контекста [`catch_warnings`](https://python-all.ru/3.8/library/warnings.html#warnings.catch_warnings), поведение не определено.174175## Тестирование предупреждений176177Для тестирования предупреждений, вызываемых кодом, используйте контекстный менеджер [`catch_warnings`](https://python-all.ru/3.8/library/warnings.html#warnings.catch_warnings). С его помощью можно временно изменить фильтр предупреждений, чтобы упростить тестирование. Например, сделайте следующее, чтобы перехватить все возникающие предупреждения для проверки:178179```python180import warnings181182def fxn():183 warnings.warn("deprecated", DeprecationWarning)184185with warnings.catch_warnings(record=True) as w:186 # Привести к тому, что все предупреждения всегда будут срабатывать.187 warnings.simplefilter("always")188 # Вызвать предупреждение.189 fxn()190 # Проверить некоторые вещи191 assert len(w) == 1192 assert issubclass(w[-1].category, DeprecationWarning)193 assert "deprecated" in str(w[-1].message)194```195196Также можно сделать все предупреждения исключениями, используя `error` вместо `always`. Следует учитывать, что если предупреждение уже было вызвано из-за правила `once`/`default`, то, независимо от установленных фильтров, оно не будет показано снова, пока не будет очищен реестр предупреждений, связанный с этим предупреждением.197198После выхода из менеджера контекста фильтр предупреждений восстанавливается до состояния на момент входа. Это предотвращает непреднамеренное изменение фильтра предупреждений между тестами и получение неопределённых результатов. Функция [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning) в модуле также восстанавливается до исходного значения. Примечание: это гарантируется только в однопоточном приложении. Если два или более потока одновременно используют менеджер контекста [`catch_warnings`](https://python-all.ru/3.8/library/warnings.html#warnings.catch_warnings), поведение не определено.199200При тестировании нескольких операций, вызывающих один и тот же тип предупреждения, важно тестировать их так, чтобы подтвердить, что каждая операция вызывает новое предупреждение (например, настроить предупреждения как исключения и проверить, что операции вызывают исключения, проверить, что длина списка предупреждений увеличивается после каждой операции, или удалять предыдущие записи из списка предупреждений перед каждой новой операцией).201202## Обновление кода для новых версий зависимостей203204Категории предупреждений, представляющие интерес в первую очередь для разработчиков Python (а не для конечных пользователей приложений на Python), по умолчанию игнорируются.205206Примечательно, что этот список «игнорируемых по умолчанию» включает [`DeprecationWarning`](https://python-all.ru/3.8/library/exceptions.html#DeprecationWarning) (для каждого модуля, кроме `__main__`), что означает, что разработчики должны обязательно тестировать свой код с видимыми предупреждениями, которые обычно игнорируются, чтобы своевременно получать уведомления о будущих ломающих изменениях API (как в стандартной библиотеке, так и в сторонних пакетах).207208В идеале код будет иметь подходящий набор тестов, а средство запуска тестов позаботится о неявном включении всех предупреждений при выполнении тестов (средство запуска тестов, предоставляемое модулем [`unittest`](https://python-all.ru/3.8/library/unittest.html#module-unittest), делает это).209210В менее идеальных случаях приложения можно проверить на использование устаревших интерфейсов, передав [`-Wd`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-w) интерпретатору Python (это сокращение для `-W default`) или установив `PYTHONWARNINGS=default` в окружении. Это включает обработку по умолчанию для всех предупреждений, включая те, которые игнорируются по умолчанию. Чтобы изменить действие для встреченных предупреждений, можно изменить аргумент, передаваемый [`-W`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-w) (например, `-W error`). См. флаг [`-W`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-w) для подробностей о возможностях.211212## Доступные функции213214#### `warnings.warn(message, category=None, stacklevel=1, source=None)`215216Выдаёт предупреждение, или же игнорирует его, или вызывает исключение. Аргумент *category*, если указан, должен быть [классом категории предупреждения](https://python-all.ru/3.8/library/warnings.html#warning-categories); по умолчанию он равен [`UserWarning`](https://python-all.ru/3.8/library/exceptions.html#UserWarning). В качестве альтернативы *message* может быть экземпляром [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning), и в этом случае *category* игнорируется, а используется `message.__class__`. В этом случае текст сообщения будет `str(message)`. Эта функция вызывает исключение, если конкретное выданное предупреждение превращается в ошибку [фильтром предупреждений](https://python-all.ru/3.8/library/warnings.html#warning-filter). Аргумент *stacklevel* может использоваться функциями-обёртками, написанными на Python, например:217218```python219def deprecation(message):220 warnings.warn(message, DeprecationWarning, stacklevel=2)221```222223Благодаря этому предупреждение указывает на вызывающий код `deprecation()`, а не на источник самого `deprecation()` (поскольку иначе терялся бы смысл сообщения предупреждения).224225Если указан, *source* – это уничтоженный объект, который породил [`ResourceWarning`](https://python-all.ru/3.8/library/exceptions.html#ResourceWarning).226227Изменено в версии 3.6: Добавлен параметр *source*.228229#### `warnings.warn_explicit(message, category, filename, lineno, module=None, registry=None, module_globals=None, source=None)`230231Это низкоуровневый интерфейс к функциональности [`warn()`](https://python-all.ru/3.8/library/warnings.html#warnings.warn), который принимает явно сообщение, категорию, имя файла и номер строки, а также опционально имя модуля и реестр (который должен быть словарём `__warningregistry__` модуля). Имя модуля по умолчанию равно имени файла с удалённым `.py`; если реестр не передан, предупреждение никогда не подавляется. *сообщение* должно быть строкой, а *категория* – подклассом [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning), или *сообщение* может быть экземпляром [`Warning`](https://python-all.ru/3.8/library/exceptions.html#Warning), и в этом случае *категория* будет проигнорирован.232233*module\_globals*, если указан, должно быть глобальным пространством имён, используемым кодом, для которого выдаётся предупреждение. (Этот аргумент используется для поддержки отображения исходного кода для модулей, найденных в zip-файлах или других источниках импорта, не основанных на файловой системе).234235Если указан, *source* – это уничтоженный объект, который породил [`ResourceWarning`](https://python-all.ru/3.8/library/exceptions.html#ResourceWarning).236237Изменено в версии 3.6: Добавлен параметр *source*.238239#### `warnings.showwarning(message, category, filename, lineno, file=None, line=None)`240241Записывает предупреждение в файл. Реализация по умолчанию вызывает `formatwarning(message, category, filename, lineno, line)` и записывает результирующую строку в *file*, который по умолчанию равен [`sys.stderr`](https://python-all.ru/3.8/library/sys.html#sys.stderr). Эту функцию можно заменить любой вызываемой, присвоив её `warnings.showwarning`. *line* – это строка исходного кода, которая должна быть включена в сообщение предупреждения; если *line* не указана, [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning) попытается прочитать строку, заданную *filename* и *lineno*.242243#### `warnings.formatwarning(message, category, filename, lineno, line=None)`244245Форматирует предупреждение стандартным способом. Возвращает строку, которая может содержать встроенные символы новой строки и заканчивается символом новой строки. *line* – это строка исходного кода, которая должна быть включена в сообщение предупреждения; если *line* не указана, [`formatwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.formatwarning) попытается прочитать строку, заданную *filename* и *lineno*.246247#### `warnings.filterwarnings(action, message='', category=Warning, module='', lineno=0, append=False)`248249Вставляет запись в список [спецификаций фильтра предупреждений](https://python-all.ru/3.8/library/warnings.html#warning-filter). По умолчанию запись вставляется в начало; если *append* равен истине, она вставляется в конец. Эта функция проверяет типы аргументов, компилирует регулярные выражения *message* и *module* и вставляет их в виде кортежа в список фильтров предупреждений. Записи, находящиеся ближе к началу списка, имеют приоритет над записями, находящимися ближе к концу, если обе соответствуют конкретному предупреждению. Опущенные аргументы по умолчанию принимают значение, которое соответствует всему.250251#### `warnings.simplefilter(action, category=Warning, lineno=0, append=False)`252253Вставляет простую запись в список [спецификаций фильтра предупреждений](https://python-all.ru/3.8/library/warnings.html#warning-filter). Смысл параметров функции такой же, как у [`filterwarnings()`](https://python-all.ru/3.8/library/warnings.html#warnings.filterwarnings), но регулярные выражения не нужны, так как вставленный фильтр всегда соответствует любому сообщению в любом модуле, если совпадают категория и номер строки.254255#### `warnings.resetwarnings()`256257Сбрасывает фильтр предупреждений. Это отменяет действие всех предыдущих вызовов [`filterwarnings()`](https://python-all.ru/3.8/library/warnings.html#warnings.filterwarnings), включая вызовы, сделанные с помощью параметров командной строки [`-W`](https://python-all.ru/3.8/using/cmdline.html#cmdoption-w) и вызовы [`simplefilter()`](https://python-all.ru/3.8/library/warnings.html#warnings.simplefilter).258259## Доступные контекстные менеджеры260261#### `class warnings.catch_warnings(*, record=False, module=None)`262263Менеджер контекста, который копирует и при выходе восстанавливает фильтр предупреждений и функцию [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning). Если аргумент *record* равен [`False`](https://python-all.ru/3.8/library/constants.html#False) (по умолчанию), менеджер контекста возвращает [`None`](https://python-all.ru/3.8/library/constants.html#None) при входе. Если *record* равен [`True`](https://python-all.ru/3.8/library/constants.html#True), возвращается список, который постепенно заполняется объектами, как их видит пользовательская функция [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning) (которая также подавляет вывод в `sys.stdout`). Каждый объект в списке имеет атрибуты с теми же именами, что и аргументы [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning).264265Аргумент *module* принимает модуль, который будет использоваться вместо модуля, возвращаемого при импорте [`warnings`](https://python-all.ru/3.8/library/warnings.html#module-warnings), фильтр которого будет защищён. Этот аргумент существует в основном для тестирования самого модуля [`warnings`](https://python-all.ru/3.8/library/warnings.html#module-warnings).266267> **Примечание**268>269> Менеджер [`catch_warnings`](https://python-all.ru/3.8/library/warnings.html#warnings.catch_warnings) работает путём замены, а затем восстановления функции [`showwarning()`](https://python-all.ru/3.8/library/warnings.html#warnings.showwarning) модуля и внутреннего списка спецификаций фильтров. Это означает, что менеджер контекста изменяет глобальное состояние и поэтому не является потокобезопасным.270