بتل کد Battle Codeدارد باز می‌شود…

جلسه‌ی 20: پرتاب استثنا و استثنای سفارشی Raising Exceptions

تابع‌های خوب ورودی نامعتبر را بی‌صدا تحمل نمی‌کنند: با raise خطای معنادار پرتاب می‌کنیم، کلاس استثنای اختصاصی می‌سازیم و استثنا را با زمینه‌اش دوباره پرتاب می‌کنیم.

در این جلسه یاد می‌گیری

درس

raise یک استثنا را پرتاب می‌کند. نوع درست را انتخاب کن: ValueError برای مقدار نامعتبر از نوع درست، TypeError برای نوع اشتباه. پیام باید بگوید چه چیزی انتظار می‌رفت.

def set_ratio(value):
    if not 0 <= value <= 1:
        raise ValueError(f"ratio must be in [0, 1], got {value}")
    return value

try:
    set_ratio(1.5)
except ValueError as e:
    print(e)

برای خطاهای دامنه‌ی برنامه‌ات کلاس اختصاصی بساز. ساده‌ترین شکل یک زیرکلاس خالی از Exception است. فراخواننده می‌تواند دقیقاً همین خطا را بگیرد و آن را با خطاهای دیگر اشتباه نگیرد.

class InsufficientFunds(Exception):
    pass

def withdraw(balance, amount):
    if amount > balance:
        raise InsufficientFunds(f"need {amount - balance} more")
    return balance - amount

یک کلاس پایه برای کل برنامه (AppError) و زیرکلاس‌هایی برای هر حالت بساز. این‌طور می‌توان هم خطای خاص و هم «هر خطای برنامه» را گرفت. اگر داده‌ی اضافه لازم است، __init__ را بازنویسی و super().__init__(message) را صدا بزن.

class AppError(Exception):
    pass

class NotFound(AppError):
    pass

class ParseError(AppError):
    def __init__(self, line, message):
        super().__init__(f"line {line}: {message}")
        self.line = line

گاهی می‌خواهی خطا را ثبت کنی ولی تصمیم را به لایه‌ی بالاتر بسپاری: raise تنها داخل except همان استثنا را دوباره پرتاب می‌کند. برای ترجمه‌ی یک خطای سطح پایین به خطای دامنه از raise NewError(...) from e استفاده کن؛ علت اصلی در __cause__ حفظ می‌شود.

class ConfigError(Exception):
    pass

def read_port(config):
    try:
        return int(config["port"])
    except KeyError as e:
        raise ConfigError("port is not set") from e

اصل «زود شکست بخور» (fail fast): ورودی را در مرز سیستم اعتبارسنجی کن و با اولین مشکل استثنا پرتاب کن. هرگز استثنا را با except: pass خاموش نکن؛ باگ پنهان از باگ آشکار گران‌تر است.

مثال‌های این جلسه

چالش‌ها

  1. Validate Age (آسان)
  2. Custom Exception (آسان)
  3. Type Check (آسان)
  4. Username Rules (متوسط)
  5. Parse Error With Line (متوسط)
  6. Log and Re-raise (متوسط)
  7. Exception Chaining (متوسط)
  8. Exception Hierarchy (سخت)
  9. Batch Record Validation (سخت)
  10. Strict Amount Parser (سخت)
  11. Error With Field (متوسط)

بیشتر بخوان

← جلسه‌ی 19: مدیریت استثناها جلسه‌ی 21: کار با فایل‌ها →