*

Author: Saeid

lessons/l21.rst

@@ -1,16 +1,16 @@
 .. role:: emoji-size
 
 .. meta::
-   :description: کتاب آموزش زبان برنامه نویسی پایتون به فارسی، آموزش شی گرایی در پایتون، OOP در پایتون،  Decorators در پایتون، Descriptors در پایتون، property@ در پایتون
+   :description: کتاب آموزش زبان برنامه نویسی پایتون به فارسی، آموزش شی گرایی در پایتون، OOP در پایتون،  Decorators در پایتون، Descriptors در پایتون، property@ در پایتون، Context Manager در پایتون، دستور with / as
    :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, Decorators, کتابخانه, پایتون, شی گرایی در پایتون, Descriptors,property@ 
 
 
-درس ۲۱: شی گرایی (OOP) در پایتون: __Descriptors ،Decorator ،__slots و property@
+درس ۲۱: شی گرایی (OOP) در پایتون: Context Manager ،Descriptors ،Decorator
 ===================================================================================================
 
 .. figure:: /_static/pages/21-python-object-oriented-programming-property-descriptors.jpg
     :align: center
-    :alt: شی گرایی (OOP) در پایتون: __Descriptors ،Decorator ،__slots و property@
+    :alt: شی گرایی (OOP) در پایتون: __Descriptors ، Context Manager ،Decorator ،__slots و property@
 
     Photo by `Mathyas Kurmann <https://unsplash.com/photos/fb7yNPbT0l8>`__
 
@@ -752,14 +752,14 @@ Context Manager و دستور ``with/as``
 
 یکی دیگر از قابلیت‌های کمتر شناخته شده در زبان برنامه‌نویسی پایتون، Context Manager می‌باشد [`اسناد پایتون <http://docs.python.org/3/library/stdtypes.html#typecontextmanager>`__]. با این حال اکثر برنامه‌نویسان پایتون به صورت مداوم از آن بهره می‌گیرند. اگر درس دهم را به یاد داشته باشیم، از دستور ``with/as`` برای کار با فایل‌ها در پایتون استفاده می‌کردیم و شاهد راحتی و زیبایی کارها نسبت به قبل بودیم. در آن زمان تنها اشاره شد که شی فایل پایتون را می‌توان با دستور ``with/as`` استفاده کرد چون این شی از قابلیت Context Manager پشتیبانی می‌کند.
 
-به صورت کلی Context Manager در زبان برنامه‌نویسی پایتون قابلیتی برای مدیرت منابع (فایل‌ها، دیتابیس و...) می‌باشد، منابعی که کار کردن با آن‌ها همواره نیازمند عملیات‌ ثابتی همچون باز (Open) و بسته (Close) کردن هستند. در این بخش می‌خواهیم به بررسی چگونگی ایجاد یک کلاس به همراه قابلیت  Context Manager بپردازیم که در نهایت از اشیای آن بتوانیم در کنار دستور ``with/as`` استفاده نماییم.
+به صورت کلی Context Manager در زبان برنامه‌نویسی پایتون قابلیتی برای مدیرت منابع (فایل‌ها، دیتابیس، ارتباط و سایر منابع) می‌باشد، منابعی که کار کردن با آن‌ها همواره نیازمند عملیات‌ ثابتی همچون باز (Open) و بسته (Close) - Start/Stop, Lock/Release, Change/Reset - کردن هستند. 
 
-اجازه دهید بار دیگر ساختار دستور ``with/as`` را بررسی نماییم::
+در این بخش می‌خواهیم به بررسی چگونگی ایجاد یک کلاس به همراه قابلیت  Context Manager بپردازیم که در نهایت از اشیای آن بتوانیم در کنار دستور ``with/as`` استفاده نماییم. ابتدا اجازه دهید بار دیگر ساختار دستور ``with/as`` را بررسی نماییم::
 
     with context_expression [as target]:
         with_statement_body
 
-در این ساختار بخش ``as`` اختیاری بوده و تنها زمانی که در داخل بدنه دستور ``with`` به شی ``context_expression`` نیاز داشته باشیم، استفاده می‌گردد؛ در این صورت یک ارجاع از شی مذکور به نام دلخواه ``target`` ایجاد و در سترس قرار می‌گیرد. ``context_expression`` نیز معرف یک شی‌ای است که توانایی مدیریت یا handle کردن دو وضعیت «ورود به» (entry into) و «خروج از» (exit from) را داشته باشد. برای ایجاد همچین شی‌ای می‌بایست دو متد خاص ``__enter__`` 	[`اسناد پایتون <https://docs.python.domainunion.de/3/reference/datamodel.html#object.__enter__>`__] و ``__exit__`` [`اسناد پایتون <https://docs.python.domainunion.de/3/reference/datamodel.html#object.__exit__>`__] را در کلاس مورد نظر خود پیاده‌سازی کنیم:
+در این ساختار بخش ``as`` اختیاری بوده و تنها زمانی که در داخل بدنه دستور ``with`` به شی ``context_expression`` نیاز داشته باشیم، استفاده می‌گردد؛ در این صورت یک ارجاع از شی مورد نیاز به نام دلخواه ``target`` ایجاد و در دسترس قرار می‌گیرد. ``context_expression`` نیز معرف یک شی‌ای است که توانایی مدیریت یا handle کردن دو وضعیت «ورود به» (entry into) و «خروج از» (exit from) را داشته باشد. برای ایجاد همچین شی‌ای می‌بایست دو متد خاص ``__enter__`` 	[`اسناد پایتون <https://docs.python.domainunion.de/3/reference/datamodel.html#object.__enter__>`__] و ``__exit__`` [`اسناد پایتون <https://docs.python.domainunion.de/3/reference/datamodel.html#object.__exit__>`__] را در کلاس مورد نظر خود پیاده‌سازی کنیم:
 
 .. code-block:: python
     :linenos:
@@ -790,6 +790,38 @@ Context Manager و دستور ``with/as``
 
 * اجرای متد ``__exit__`` زمانی است که کار یا اجرای context به پایان رسیده است. این متد در واقع  فرصتی برای تمیزکاری یا به اصطلاح clean up کردن آثار اجرای context می‌باشد. به مانند پاک کردن فایل‌هایی که موقت ایجاد شده‌اند، حذف اشیای اضافی باقی‌مانده یا انجام عمل بستن یک فایل یا پایان دادن یک ارتباط (Connection) یا...
 
+برای آشنایی بیشتر در نمونه کد زیر یک Wrapper برای شی فایل ایجاد کرده‌ایم:
+
+.. code-block:: python
+    :linenos:
+    
+    class FileWritterWrapper:
+        def __init__(self, filename):
+            self.filename = filename
+        
+        def __enter__(self):
+            self.opened_file = open(self.filename, 'a')
+            self.opened_file.write('====== OPEN FILE ======\n')
+            return self.opened_file
+    
+        def __exit__(self, *args):
+            self.opened_file.write('\n====== CLOSE FILE ======\n')
+            self.opened_file.close()
+
+
+    with FileWritterWrapper('test_log.txt') as managed_file:
+        managed_file.write('Inside context manager!')
+
+محتویات فایل test_log.txt، پس از اجرای کد بالا:
+
+::
+
+    
+    ====== OPEN FILE ======
+    Inside context manager!
+    ====== CLOSE FILE ======
+
+
 |
 
 ----