Сообщить об ошибке.

Функция warn_explicit() модуля warnings в Python

Низкоуровневый интерфейс к функции warnings.warn()

Синтаксис:

import warnings

warnings.warn_explicit(message, category, filename, \
                       lineno, module=None, registry=None, \
                       module_globals=None, source=None)

Параметры:

  • message - строка предупреждения,
  • category - категория предупреждения,
  • filename - имя файла с предупреждением,
  • lineno - номер строки с предупреждением,
  • module=None - имя модуля,
  • registry=None - реестр,
  • module_globals=None - источники импорта модулей,
  • source=None - объект, который выдал исключение ResourceWarning.

Возвращаемое значение:

  • выдает предупреждение.

Описание:

Функция warn_explicit() модуля warnings представляет собой низкоуровневый интерфейс к функциям warnings.warn(), в котором явно передаются сообщение message, категория category, имя файла filename и номер строки lineno, а также, необязательно, имя модуля module и реестр registry, который должен быть словарем модуля __warningregistry__.

Аргумент module по умолчанию соответствует имени файла с расширением .py.

Если аргумент registry не передан, предупреждение никогда не подавляется.

Аргумент message должен быть строкой, но при этом должна быть указана категория category или message может быть экземпляр Warning, то в этом случае категория category будет игнорироваться.

Аргумент module_globals, если указан, должен быть глобальным пространством имен, используемым кодом, для которого выдается предупреждение. Этот аргумент используется для поддержки словаря источников импорта модулей, найденных в zipfiles или других источниках импорта, не относящихся к файловой системе.

Аргумент source, если он указан, это уничтоженный объект, который выдал исключение ResourceWarning.