Python contextlib.suppress: игнорировать исключение

Категория: Python · Язык: Python · Обновлено:

contextlib.suppress — контекстный менеджер, который подавляет только перечисленные исключения. Он заменяет конструкцию try/except: pass и явно показывает, какую ошибку мы считаем допустимой. В отличие от голого except, он не скрывает остальные сбои.

Удалить файл, если он существует

Python
import os
from contextlib import suppress

with suppress(FileNotFoundError):
    os.remove("missing.txt")

with suppress(FileNotFoundError):
    os.remove("missing.txt")

print("готово")  # готово

Оба вызова os.remove завершаются ошибкой, но FileNotFoundError подавляется. Если возникнет PermissionError или IsADirectoryError, исключение пробросится наружу. Для удаления пути есть более явный Path("missing.txt").unlink(missing_ok=True), но suppress удобен для произвольных операций.

Не подавлять лишнее

Python
from contextlib import suppress

try:
    with suppress(FileNotFoundError):
        raise ValueError("важно")
except ValueError as exc:
    print(str(exc))  # важно

ValueError не указан в suppress, поэтому выходит наружу. Не используйте suppress(Exception) без крайней необходимости: так можно скрыть ошибку программиста. BaseException вроде KeyboardInterrupt и SystemExit тоже не подавляются, если не перечислены явно.

suppress полезен для очистки временных файлов, закрытия сокетов и необязательных операций, где отсутствие ресурса — норма. Он не заменяет логирование: если ошибка важна для диагностики, запишите её перед подавлением. Не оборачивайте в suppress целые бизнес-операции: потеря ошибки усложнит отладку.

Менеджер доступен с Python 3.4. В async-коде suppress работает так же, но не отменяет CancelledError, если он не указан. Для нескольких исключений передайте их списком: suppress(FileNotFoundError, PermissionError).

Документация: contextlib.suppress, исключения Python.