Генерация собственных исключений в Python: практическое руководство с примерами

Пример 1: Иерархия пользовательских исключений для приложения

class AppError(Exception):
    """Базовое исключение приложения"""
    pass

class InputError(AppError):
    def __init__(self, field, message):
        self.field = field
        self.message = message
        super().__init__(f'{field}: {message}')

class ProcessingError(AppError):
    def __init__(self, data, message):
        self.data = data
        self.message = message
        super().__init__(f'Data {data}: {message}')

def process_input(user_input):
    if not user_input:
        raise InputError('username', 'Поле обязательно')
    if len(user_input) < 3:
        raise ProcessingError(user_input, 'Слишком короткое')

try:
    process_input('ab')
except InputError as e:
    print('InputError:', e)
except ProcessingError as e:
    print('ProcessingError:', e)
except AppError as e:
    print('Other AppError:', e)

ProcessingError: Data ab: Слишком короткое

Создана иерархия: базовый класс AppError и два наследника. Это позволяет перехватывать ошибки на разных уровнях детализации.

Пример 2: Исключение с методами для извлечения информации

class HTTPError(Exception):
    def __init__(self, status_code, message):
        self.status_code = status_code
        self.message = message
        super().__init__(message)
    def is_client_error(self):
        return 400 <= self.status_code < 500

try:
    raise HTTPError(404, 'Not Found')
except HTTPError as e:
    print(e.is_client_error())  # True

True

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

Пример 3: Цепочка исключений и подавление через from None

def connect():
    raise ConnectionError('Сервер недоступен')

def get_data():
    try:
        connect()
    except ConnectionError as e:
        raise RuntimeError('Не удалось получить данные') from e

def main():
    try:
        get_data()
    except RuntimeError as e:
        print('Основная ошибка:', e)
        print('Причина:', e.__cause__)

main()

Основная ошибка: Не удалось получить данные
Причина: Сервер недоступен

Использование from e сохраняет цепочку. Для подавления исходной ошибки применяют raise ... from None:

def read_config(path):
    try:
        with open(path) as f:
            return f.read()
    except FileNotFoundError:
        raise RuntimeError('Файл конфигурации отсутствует') from None

try:
    read_config('missing.txt')
except RuntimeError as e:
    print(e)
    print('__cause__:', e.__cause__)

Файл конфигурации отсутствует
__cause__: None

Пример 4: Сравнение assert и raise для валидации

def set_age_assert(age):
    assert isinstance(age, int), 'Возраст должен быть целым числом'
    assert 0 <= age <= 150, 'Возраст вне допустимого диапазона'
    return age

def set_age_raise(age):
    if not isinstance(age, int):
        raise TypeError('Возраст должен быть целым числом')
    if not (0 <= age <= 150):
        raise ValueError('Возраст вне допустимого диапазона')
    return age

# Пример вызова с assert (может быть отключено)
try:
    set_age_assert('20')
except AssertionError as e:
    print('AssertionError:', e)

# Пример вызова с raise
try:
    set_age_raise('20')
except TypeError as e:
    print('TypeError:', e)

AssertionError: Возраст должен быть целым числом
TypeError: Возраст должен быть целым числом

assert компактен, но менее гибок. raise даёт точный контроль над типом исключения и надёжен в production.