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

Форматировать строку с предупреждением warning

Синтаксис:

import warnings

warnings.formatwarning(message, category, \
                       filename, lineno, line=None)

Параметры:

• message - строка предупреждения,
• category - категория предупреждения,
• filename - имя файла с предупреждением,
• lineno - номер строки с предупреждением,
• line=None - строка исходного кода, для включение в message.

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

• строка с отформатированным предупреждением.

Описание:

Функция formatwarning() модуля warnings форматирует предупреждение стандартным способом.

Функция warnings.formatwarning() возвращает строку, которая может содержать встроенные символы новой строки \n и заканчивается новой строкой \n.

Аргумент line - это строка исходного кода, которая должна быть включена в предупреждение. Если строка line не указана, то функция warnings.formatwarning() попытается прочитать строку, указанную в filename и lineno.

Примеры:

# ПСЕВДОКОД
import warnings

...
...
s = warnings.formatwarning(message, category, filename, lineno, line)
logger = getLogger("py.warnings")
logger.warning("%s", s)
...
...