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
.