def process_age(age):
    if not isinstance(age, int):
        # Явное возбуждение исключения при неверном типе данных
        raise TypeError("Возраст должен быть целым числом.")
    if age < 0:
        # Явное возбуждение исключения при логической ошибке (отрицательный возраст)
        raise ValueError("Возраст не может быть отрицательным.")
    
    print(f"Возраст {age} успешно обработан.")

# Пример работы Fail-Fast
process_age(-5)  # Программа немедленно упадет с ValueError, не продолжая выполнение

# Правильное использование raise с передачей сообщения (рекомендуется)
def divide(a, b):
    if b == 0:
        raise ZeroDivisionError("Делитель не может быть равен нулю. Проверьте входные данные.")
    return a / b

# Использование raise без сообщения (допустимо, но менее информативно)
def check_status(status):
    if status not in ['active', 'pending']:
        raise ValueError

# ОШИБКА: попытка возбудить тип, не являющийся исключением
# raise "Bad Request"  # Это вызовет TypeError

# Проблема использования только встроенных исключений (Плохая практика)
def process_payment(balance, amount):
    if balance < amount:
        raise ValueError("Недостаточно средств")
    if amount <= 0:
        raise ValueError("Сумма должна быть положительной")

try:
    process_payment(100, 200)
except ValueError as e:
    # Приходится парсить текст, чтобы понять, что делать!
    if "Недостаточно средств" in str(e):
        print("Перенаправление на страницу пополнения баланса...")
    elif "Сумма должна быть" in str(e):
        print("Показ всплывающего окна об ошибке ввода...")

# Создание пустого пользовательского исключения
class InsufficientFundsError(Exception):
    """Исключение, выбрасываемое при нехватке средств на счете."""
    pass  # Наследуем всё поведение базового Exception

def withdraw(balance, amount):
    if amount > balance:
        # Возбуждаем наше кастомное исключение, передавая сообщение базовому классу
        raise InsufficientFundsError(f"Не хватает {amount - balance} руб. для операции.")
    return balance - amount

# Перехват кастомного исключения
try:
    withdraw(100, 500)
except InsufficientFundsError as e:
    print(f"ОШИБКА ОПЛАТЫ: {e}")

class ValidationError(Exception):
    """Исключение для ошибок валидации данных."""
    
    def __init__(self, message, field_name, error_code=400):
        # 1. Вызываем __init__ базового класса Exception
        super().__init__(message)
        
        # 2. Сохраняем дополнительные данные как атрибуты объекта
        self.field_name = field_name
        self.error_code = error_code

def register_user(username):
    if len(username) < 3:
        # Возбуждаем ошибку с детальной информацией
        raise ValidationError("Имя пользователя слишком короткое", field_name="username", error_code=422)

try:
    register_user("Al")
except ValidationError as e:
    # Обращаемся к кастомным атрибутам объекта ошибки
    print(f"[{e.error_code}] Ошибка в поле '{e.field_name}': {e}")

class DatabaseConnectionError(Exception):
    """Исключение с кастомным форматированием строки вывода."""
    
    def __init__(self, db_host, port, message="Не удалось подключиться к БД"):
        super().__init__(message)
        self.db_host = db_host
        self.port = port
        self.message = message
        
    def __str__(self):
        # Формируем красивое сообщение для логов
        return f"{self.message} [Хост: {self.db_host}, Порт: {self.port}]"

# Демонстрация работы __str__
try:
    raise DatabaseConnectionError("127.0.0.1", 5432, "Timeout соединения")
except DatabaseConnectionError as e:
    print(e)  # Автоматически вызовет e.__str__()
    # Вывод: Timeout соединения [Хост: 127.0.0.1, Порт: 5432]

# 1. Создаем корневое исключение для всего нашего проекта
class ShopBaseError(Exception):
    """Базовый класс для всех исключений магазина."""
    pass

# 2. Наследуем конкретные ошибки от ShopBaseError
class OutOfStockError(ShopBaseError):
    pass

class InvalidCouponError(ShopBaseError):
    pass

# 3. Функция верхнего уровня, обрабатывающая все ошибки проекта
def process_order():
    try:
        # Имитация бизнес-логики, которая может выбросить разные ошибки
        raise InvalidCouponError("Промокод истек")
    except ShopBaseError as e:
        # Этот блок поймает и OutOfStockError, и InvalidCouponError
        # Но он НЕ поймает обычный ValueError или TypeError
        print(f"Логирование бизнес-ошибки: {e}")
        print("Извините, произошла ошибка в логике магазина.")

class AppError(Exception): pass

# Промежуточные группирующие классы
class AuthError(AppError): pass
class DatabaseError(AppError): pass

# Конкретные ошибки авторизации
class TokenExpiredError(AuthError): pass
class InvalidPasswordError(AuthError): pass

def login(token):
    if token == "old":
        raise TokenExpiredError("Токен протух")
    elif token == "bad":
        raise AuthError("Неизвестная ошибка авторизации")

try:
    login("old")
except TokenExpiredError:
    # Специфичный обработчик (ВСЕГДА ДОЛЖЕН БЫТЬ ВЫШЕ базового)
    print("Перенаправление на страницу обновления токена")
except AuthError:
    # Общий обработчик для всех остальных ошибок авторизации
    print("Доступ запрещен. Пожалуйста, авторизуйтесь заново.")

class StorageError(Exception):
    """Высокоуровневая ошибка хранения данных."""
    pass

def read_config():
    try:
        # Имитация ошибки на низком уровне
        open("non_existent_config.json")
    except FileNotFoundError as e:
        # Перехватываем низкоуровневую ошибку (FileNotFoundError)
        # И выбрасываем высокоуровневую (StorageError), связывая их через from
        raise StorageError("Не удалось загрузить конфигурацию приложения") from e

# При запуске read_config() Python выведет два traceback:
# 1. Оригинальный: FileNotFoundError: [Errno 2] No such file or directory
# 2. Сообщение: The above exception was the direct cause of the following exception:
# 3. Новый: StorageError: Не удалось загрузить конфигурацию приложения

def fetch_user_data(user_id):
    try:
        # Имитация: пользователь обращается к закрытым данным
        # Это вызывает ошибку безопасности на уровне ОС
        raise PermissionError("Доступ к /etc/passwd запрещен")
    except PermissionError:
        # Если мы сделаем просто raise ValueError, оригинальная PermissionError
        # всё равно "прилипнет" и будет видна в логах.
        # Поэтому мы явно подавляем цепочку с помощью from None.
        raise ValueError("Пользователь не найден или данные недоступны") from None

# При запуске traceback покажет ТОЛЬКО ValueError. 
# Никакого упоминания PermissionError или системных путей не будет.

def process_transaction(amount):
    try:
        # Какая-то сложная логика транзакции
        if amount < 0:
            raise ValueError("Сумма не может быть отрицательной")
    except ValueError as e:
        # 1. Выполняем побочное действие (логирование)
        print(f"[АЛЕРТ ДЛЯ АДМИНА] Попытка нелегальной транзакции: {e}")
        
        # 2. Пробрасываем эту же ошибку дальше наверх (reraise)
        # Это сохранит оригинальный traceback, как будто ошибка не перехватывалась
        raise

# Проектирование иерархии исключений для магазина
class ShopBaseException(Exception):
    """Корневое исключение магазина"""
    pass

class ValidationFailedError(ShopBaseException):
    """Ошибка валидации данных пользователя"""
    def __init__(self, field, message):
        super().__init__(message)
        self.field = field
        self.message = message
        
    def __str__(self):
        return f"Ошибка валидации поля '{self.field}': {self.message}"

class PaymentProcessingError(ShopBaseException):
    """Ошибка на стороне платежного шлюза"""
    def __init__(self, transaction_id, message):
        super().__init__(message)
        self.transaction_id = transaction_id
        
    def __str__(self):
        return f"Сбой платежа [TX: {self.transaction_id}]: {self.message}"

def process_order(cart):
    # Этап 1: Валидация (Fail-Fast)
    if not cart:
        raise ValidationFailedError(field="cart", message="Корзина пуста.")
    
    for item in cart:
        if item['quantity'] <= 0:
            raise ValidationFailedError(field="quantity", message=f"Неверное количество для {item['name']}")
            
    # Этап 2: Имитация платежа, который падает
    try:
        # Имитация низкоуровневого сбоя сети
        raise ConnectionError("Timeout 5000ms")
    except ConnectionError as e:
        # Оборачиваем системную ошибку в бизнес-ошибку с помощью from
        tx_id = "TXN-999-XYZ"
        raise PaymentProcessingError(tx_id, "Нет связи с банком") from e

# Главный контроллер
try:
    my_cart = [{'name': 'Laptop', 'quantity': 0}] # Ошибка в количестве
    process_order(my_cart)
except ValidationFailedError as e:
    print(f"[HTTP 400] Клиентская ошибка. Подсветить поле {e.field} красным.")
    print(f"Текст для пользователя: {e.message}")
except PaymentProcessingError as e:
    print(f"[HTTP 402] Ошибка оплаты. Сохраняем TX_ID {e.transaction_id} в базу для разбора.")
    print("Текст для пользователя: Оплата не прошла, попробуйте позже.")