جلسهی 20: پرتاب استثنا و استثنای سفارشی Raising Exceptions
تابعهای خوب ورودی نامعتبر را بیصدا تحمل نمیکنند: با raise خطای معنادار پرتاب میکنیم، کلاس استثنای اختصاصی میسازیم و استثنا را با زمینهاش دوباره پرتاب میکنیم.
در این جلسه یاد میگیری
- با
raiseاستثنای مناسب (ValueError،TypeError، ...) و پیام دقیق پرتاب کنی. - کلاس استثنای سفارشی بهصورت زیرکلاس
Exceptionتعریف کنی و یک سلسلهمراتب کوچک بسازی. - استثنا را با
raiseتنها دوباره پرتاب کنی یا باraise ... fromزنجیره کنی. - اعتبارسنجی ورودی را به تابعهایی بسپاری که در صورت خطا استثنا پرتاب میکنند.
درس
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 خاموش نکن؛ باگ پنهان از باگ آشکار گرانتر است.
مثالهای این جلسه
- مثال مدیریت خطا با try در پایتون: try: — پرتاب استثنا و استثنای سفارشی
- مثال کلاس و شیء در پایتون: class InsufficientFunds(Exception):
- مثال کلاس و شیء در پایتون: class AppError(Exception):
- مثال کلاس و شیء در پایتون: class ConfigError(Exception):
چالشها
- Validate Age (آسان)
- Custom Exception (آسان)
- Type Check (آسان)
- Username Rules (متوسط)
- Parse Error With Line (متوسط)
- Log and Re-raise (متوسط)
- Exception Chaining (متوسط)
- Exception Hierarchy (سخت)
- Batch Record Validation (سخت)
- Strict Amount Parser (سخت)
- Error With Field (متوسط)