Python Glossary English

все Python 3warningsпонятие

warnings

модуль

Выдача предупреждений и управление ими: показать, скрыть, превратить в ошибку или перехватить в тесте.

Синтаксис

import warnings

Предупреждение сообщает о проблеме, которая не мешает программе работать, — чаще всего об устаревшем API; warnings.warn() выдаёт его, а фильтры решают, будет ли оно показано. Одинаковое предупреждение из одного места по умолчанию печатается один раз, а DeprecationWarning вне __main__ скрыт — поэтому его легко не заметить. Для сообщений о работе программы берите logging, а в тестах — catch_warnings(record=True) или флаг -W error.

Примеры

import warnings
with warnings.catch_warnings(record=True) as caught:
    warnings.simplefilter("always")
    warnings.warn("old API")
print(caught[0].category.__name__, caught[0].message)  # → UserWarning old API

См. также

Открыть в полном глоссарииdocs.python.orgСообщить о неточности