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

جلسه‌ی 39: مدیران زمینه Context Managers

با with منابع را مطمئن باز و بسته می‌کنیم و مدیر زمینه (context manager) خودمان را با کلاس و با contextlib می‌سازیم.

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

درس

مدیر زمینه (context manager) تضمین می‌کند کار پایانی (بستن فایل، آزاد کردن قفل، بستن اتصال) حتماً انجام شود، حتی اگر وسط کار خطا رخ دهد. with open(...) رایج‌ترین مثال است و جایگزین try/finally دستی است.

with open("notes.txt", "w") as f:
    f.write("hello\n")
print(f.closed)  # True

هر شیئی با دو متد __enter__ و __exit__ مدیر زمینه است. مقدار برگشتی __enter__ به متغیر بعد از as می‌رسد و __exit__ موقع خروج از بلوک، چه عادی چه با خطا، اجرا می‌شود.

class Section:
    def __init__(self, name):
        self.name = name
    def __enter__(self):
        print(f"[{self.name}] start")
        return self
    def __exit__(self, exc_type, exc, tb):
        print(f"[{self.name}] end")

__exit__ سه آرگومان می‌گیرد: نوع خطا، خود خطا و traceback؛ اگر خطایی نباشد هر سه None هستند. اگر __exit__ مقدار True برگرداند خطا مهار (suppress) می‌شود و برنامه بعد از بلوک ادامه می‌یابد. فقط وقتی این کار را بکنید که واقعاً خطا را مدیریت کرده‌اید.

def __exit__(self, exc_type, exc, tb):
    if exc_type is ValueError:
        print("bad value ignored")
        return True
    return False

contextlib.contextmanager مدیر زمینه را با یک تابع ژنراتور می‌سازد: کد قبل از yield نقش __enter__ و کد بعد از آن نقش __exit__ را دارد. برای اینکه پاک‌سازی حتی با خطا انجام شود yield را داخل try/finally بگذارید.

from contextlib import contextmanager

@contextmanager
def tag(name):
    print(f"<{name}>")
    try:
        yield
    finally:
        print(f"</{name}>")

contextlib.suppress نوع‌های مشخصی از خطا را بی‌صدا نادیده می‌گیرد و خواناتر از try/except: pass است. چند مدیر زمینه را هم می‌توان در یک with با کاما نوشت.

from contextlib import suppress

with suppress(FileNotFoundError):
    open("missing.txt")

with open("a.txt", "w") as a, open("b.txt", "w") as b:
    a.write("1"); b.write("2")

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

چالش‌ها

  1. Write and Read Back (آسان)
  2. Closed After with (آسان)
  3. Suppress Bad Input (آسان)
  4. Section Markers (متوسط)
  5. Collector (متوسط)
  6. HTML Tags with contextmanager (متوسط)
  7. Guarded Division (متوسط)
  8. Transaction Rollback (سخت)
  9. Cleanup Even on Error (سخت)
  10. Temporary Setting (سخت)
  11. Copy with Two Managers (متوسط)
  12. Indented Output (سخت)

بیشتر بخوان

← جلسه‌ی 38: دکوریتورها جلسه‌ی 40: جعبه‌ابزار کتابخانه‌ی استاندارد →