Для чего используются предупреждения (warnings) в Python и как можно создать собственное предупреждение?

Предупреждения используются для уведомления разработчика или пользователя о потенциальных проблемах или нерекомендуемом использовании кода, которые не являются ошибками и не прерывают выполнение программы. Они менее критичны, чем исключения.

Создать собственное предупреждение можно, создав новый класс, наследующийся от встроенного класса Warning или его подклассов (например, UserWarning, DeprecationWarning).

class MyCustomWarning(UserWarning):
    # Пользовательский класс предупреждения
    pass

Для генерации предупреждения используется функция warnings.warn().

import warnings

def my_function(arg):
    if arg < 0:
        # Генерация пользовательского предупреждения
        warnings.warn("Аргумент должен быть неотрицательным.", MyCustomWarning)
    # Остальная логика функции
    pass

# Пример вызова функции, генерирующей предупреждение
my_function(-5)