Содержание с кратким описанием:
Модуль warnings полезен, когда необходимо предупредить пользователя о каком-либо условии и оно не требует создания исключения и завершения программы. Эти сообщения записываются в sys.stderr, но их расположение можно изменять, от игнорирования всех предупреждений до превращения их в исключения.
Пользовательский код может определять дополнительные категории предупреждений путем подкласса одной из стандартных категорий предупреждений. Категория предупреждения всегда должна быть подклассом базового класса для категорий предупреждений `Warning`.
Фильтр предупреждений определяет, будут ли предупреждения игнорироваться, отображаться или превращаться в ошибки, вызывая исключение.
В разделе рассмотрены несколько вариантов переопределения фильтра предупреждений, установленного в сборках Python по умолчанию.
Если вы используете код, который вызывает предупреждение, например из за устаревшей функции, но не хотите видеть эти предупреждения, то можно отключить предупреждение с помощью контекстного менеджера `warnings.catch_warnings()`.
Чтобы проверить предупреждения, выданные кодом, используйте менеджер контекста `warnings.catch_warnings()`. С его помощью можно временно отключить фильтр предупреждений, чтобы облегчить тестирование.
Функция `warn()` модуля `warnings` выдает предупреждение или вызывает исключение, согласно настройкам фильтра предупреждений.
Функция `warn_explicit()` модуля `warnings` представляет собой низкоуровневый интерфейс к функциям `warnings.warn()`, в котором явно передаются сообщение `message`, категория `category`, имя файла `filename` и номер строки `lineno`.
Функция `showwarning()` модуля `warnings` записывает предупреждение в файл. Реализация по умолчанию вызывает `warnings.formatwarning()` и записывает результирующую строку в файл `file` или по умолчанию в `sys.stderr`.
Функция `formatwarning()` модуля `warnings` форматирует предупреждение стандартным способом.
Функция `filterwarnings()` модуля `warnings` вставляет расширенную запись в список спецификаций фильтра предупреждений. Запись вставляется спереди по умолчанию.
Функция `simplefilter()` модуля `warnings` вставляет простую запись в список спецификаций фильтра предупреждений.
Функция `resetwarnings()` модуля `warnings` сбрасывает фильтр предупреждений к первоначальному состоянию.
Класс catch_warnings() модуля warnings представляет собой менеджер контекста, который копирует и при выходе восстанавливает фильтр предупреждений и функцию warnings.showwarning().