Python для начинающих

Создание собственных исключений для понятной обработки ошибок

Стандартные исключения Python (ValueError, TypeError, KeyError и т.д.) хороши, но иногда они слишком общие. Если вы пишете библиотеку, игру или веб‑сервис, вам нужно чётко понимать: какая именно логическая ошибка произошла и что с ней делать. Тут и вступают в игру собственные исключения.

---

## Зачем нужны свои исключения

Представьте интернет‑магазин. Ошибка “ValueError” может означать всё что угодно: от некорректной цены до пустого списка товаров. Гораздо понятнее:

- InvalidPriceError
- OutOfStockError
- PaymentDeclinedError

Код сразу становится самодокументируемым: по имени исключения видно, что пошло не так и где это обрабатывать.

---

## Как создать своё исключение

Создание простое: наследуемся от Exception (или другого базового класса исключений):

class InvalidPriceError(Exception):
    """Raised when product price is invalid."""
    pass

Используем:

def set_price(price: float) -> None:
    if price <= 0:
        raise InvalidPriceError(f"Price must be positive, got: {price}")

---

## Иерархия исключений

Красота начинается, когда вы строите семейство ошибок:

class ShopError(Exception):
    """Base exception for shop-related errors."""
    pass


class OutOfStockError(ShopError):
    pass


class PaymentError(ShopError):
    pass


class PaymentDeclinedError(PaymentError):
    pass

Теперь можно:

try:
    process_order(order)
except PaymentDeclinedError as e:
    log_warning(e)
    show_message("Payment was declined, try another card.")
except ShopError as e:
    log_error(e)
    show_message("Something went wrong with your order.")

Преимущество: вы можете ловить как конкретные, так и все “магазинные” ошибки разом.

---

## Добавляем контекст к исключениям

Исключения могут не только “орать”, но и нести данные:

class OutOfStockError(ShopError):
    def __init__(self, product_id: int, requested: int, available: int):
        self.product_id = product_id
        self.requested = requested
        self.available = available
        message = (f"Product {product_id}: requested {requested}, "
                   f"available {available}")
        super().__init__(message)

Использование:

try:
    reserve_product(product_id=42, quantity=10)
except OutOfStockError as e:
    print(e.product_id, e.requested, e.available)

Так обработчик ошибок видит не только текст, но и структурированные данные.

---

## Когда точно стоит заводить своё исключение

- Ошибка связана с предметной областью (деньги, заказы, уровни в игре).
- Вам нужно по‑разному реагировать на разные типы ошибок.
- Вы пишете код, которым будут пользоваться другие разработчики.

Если же ошибка — просто “не тот тип” или “не то значение”, часто достаточно стандартных исключений.

Собственные исключения — это не “косметика”, а мощный инструмент архитектуры. Они превращают хаос “что-то упало” в чёткую систему сигналов, по которой программа может разумно реагировать на проблемы.

🔥3❤2👍1

266 views04:32