Merge pull request #38 from saeiddrv/draft

UPDATE#00125

Author: Saeid Darvish

_static/l24-python-assertion-flowchart.png

@@ -129,6 +129,11 @@
   <lastmod>2021-03-29T17:10:25+00:00</lastmod>
   <priority>0.80</priority>
 </url>
+<url>
+  <loc>https://python.coderz.ir/lessons/l24.html</loc>
+  <lastmod>2021-04-01T17:10:25+00:00</lastmod>
+  <priority>0.80</priority>
+</url>
 <url>
   <loc>https://python.coderz.ir/log.html</loc>
   <lastmod>2021-03-17T17:10:19+00:00</lastmod>

_static/l24-python-exception-hierarchy-warnings.png

@@ -9,9 +9,11 @@
 گزارش حمایت‌های مالی
 =========================
 
-مبالغ مهم نیستند، از اقدام و پیام تشویق شما دوستان بسیار سپاسگذارم. (*اطلاعات این صفحه به صورت آنی بروز نمی‌شود!*)
+**مبالغ مهم نیستند، از اقدام و پیام تشویق شما دوستان بسیار سپاسگذارم.**
 
-**از ابتدا (1394): 2,121,222 تومان** [آخرین بروزرسانی:‌ 27-12-1399]
+(*اطلاعات این صفحه به صورت آنی بروز نمی‌شود!*)
+
+**از ابتدا (1394): 2,201,222 تومان** [آخرین بروزرسانی:‌ 13-01-1400]
 
 ----
 
@@ -25,6 +27,31 @@
 
 
 
+
+
+
+
+
+
+.. raw:: html
+
+    <p id="7904c5" >54: <strong style="color:#5C6BC0">50,000 تومان</strong> در زمان 20:34 12-01-1400<br><q>از زحمات شما ممنونم . خیلی ناقابل هست</q></p>
+
+----
+
+.. raw:: html
+
+    <p id="8d97db" >53: <strong style="color:#5C6BC0">10,000 تومان</strong> در زمان 11:44 12-01-1400<br><q>با تشکر از مطالب خیلی مفید بعضی نکات که به دنبالشون بودم را توی این کتاب پیدا کردم</q></p>
+
+----
+
+.. raw:: html
+
+    <p id="779f30" >52: <strong style="color:#5C6BC0">20,000 تومان</strong> در زمان 21:12 11-01-1400<br><q>خیلی هم خوب</q></p>
+
+----
+
+
 |
 
 **سال 1399: 652,222 تومان**

_static/sitemap-index.xml

@@ -49,6 +49,7 @@
    lessons/l21
    lessons/l22
    lessons/l23
+   lessons/l24
    log
    donate-report
    python-interactive

donate-report.rst

@@ -5,8 +5,8 @@
    :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, انواع شی, انواع داده, پایتون
 
 
-درس ۱۱: کتابخانه استاندارد پایتون: math و os
-================================================
+درس ۱۱: ماژول‌های math (تابع‌های ریاضی) و os (ارتباط با  سیستم‌عامل) پایتون
+============================================================================
 
 .. figure:: /_static/pages/11-python-os-path-math.jpg
     :align: center

index.rst

@@ -5,7 +5,7 @@
    :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, تابع, کتابخانه, پایتون, re
 
 
-درس ۱۶: کتابخانه استاندارد پایتون: re
+درس ۱۶: ماژول re (عبارات باقاعده) پایتون
 ============================================================================
 
 .. figure:: /_static/pages/16-python-regex-re.jpg

lessons/l11.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>`__
 
@@ -745,6 +745,168 @@ property@
 .. tip:: 
 
   از ``property@`` تنها برای Instance Attributeها می‌توان استفاده کرد.
+  
+  
+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) - Start/Stop, Lock/Release, Change/Reset - کردن هستند. 
+
+در این بخش می‌خواهیم به بررسی چگونگی ایجاد یک کلاس به همراه قابلیت  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__>`__] را در کلاس مورد نظر خود پیاده‌سازی کنیم:
+
+.. code-block:: python
+    :linenos:
+    
+    class SampleContextManager:
+        def __enter__(self):
+            print('---> Entered into context manager!')
+
+        def __exit__(self, *args):
+            print('<--- Exiting from context manager!')
+
+
+    with SampleContextManager():
+        print('Inside context manager!')
+
+::
+
+    ---> Entered into context manager!
+    Inside context manager!
+    <--- Exiting from context manager!
+
+همانطوری که از خروجی نمونه کد بالا قابل مشاهده می‌باشد، در هنگام اجرای دستور ``with``، ابتدا متد ``__enter__`` از شی Context Manager و سپس دستورات داخل بدنه دستور ``with`` و در نهایت نیز متد ``__exit__`` از شی Context Manager اجرا می‌گردد.
+
+
+اگر بخواهیم کمی عمیق‌تر به ماجرا نگاه کنیم:
+
+* اجرای متد ``__enter__`` زمانی است که خط اجرای برنامه می‌خواهد وارد اجرای دستورات داخل ``with`` یا به اصطلاح  وارد runtime context شود و خروجی این متد می‌بایست شی‌ای باشد که می‌خواهیم در طول اجرای دستور  ``with`` یا به اصطلاح context، با آن کار کنیم. البته خروجی می‌تواند ``None`` باشد ولی باید توجه داشت که خروجی این متد است که توسط دستور ``as`` به نام ``target`` ارجاع می‌خورد!
+
+* اجرای متد ``__exit__`` زمانی است که انجام کار دستورات ``with`` یا اجرای 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 ======
+
+به متد ``__exit__`` برگردیم، براساس مستندات پایتون تعریف کامل این متد به شکل زیر است::
+
+    __exit__(self, exc_type, exc_value, traceback)
+
+سه پارامتر انتهایی در صورت بروز Exception هنگام اجرای context (دستورات داخل بدنه ``with``) دارای مقدار غیر ``None`` و در غیر این صورت برابر با مقدار ``None`` خواهند بود. وجود این مقادیر به معنی عدم پایان صحیح context می‌باشد که ممکن است بتواند در گرفتن تصمیم شما در زمان خروج از context تاثیر داشته باشد.
+
+.. code-block:: python
+    :linenos:
+
+    class SampleContextManager:
+        def __enter__(self):
+            print('---> Entered into context manager!')
+
+        def __exit__(self, exc_type, exc_value, traceback):
+            print('exc_type:', exc_type)
+            print('exc_value:', exc_value)
+            print('traceback:', traceback)
+            print('<--- Exiting from context manager!')
+
+
+    with SampleContextManager():
+        print('|||||||||Inside context manager! - Top')
+        a = 8 / 0
+        print('|||||||||Inside context manager! - Bottom')
+
+
+    print('***FINISH***')
+
+::
+
+     ---> Entered into context manager!
+     |||||||||Inside context manager! - Top
+     exc_type: <class 'ZeroDivisionError'>
+     exc_value: division by zero
+     traceback: <traceback object at 0x7f1c8aebd0c8>
+     <--- Exiting from context manager!
+     Traceback (most recent call last):
+       File "sample.py", line 14, in <module>
+         a = 8 / 0
+     ZeroDivisionError: division by zero
+
+
+همان‌طور که از نمونه کد بالا قابل مشاهده است، در زمان اجرای دستورات context یک خطای (تقسیم بر صفر) ``ZeroDivisionError`` رخ داده است. نکته قابل توجه این است که حتی با وجود بروز خطا و ناتمام ماندن اجرای context، ولی بدنه متد ``__exit__`` به صورت کامل اجرا شده است. در واقع مفسر پایتون اعلام Exception را که می‌تواند منجر به توقف کل برنامه شود را به صورت موقت تا پایان اجرا ``__exit__`` معلق نگه می‌دارد.
+
+در چنین حالتی اگر متد ``__exit__`` مقدار ``True`` را برگرداند، مفسر پایتون از بروز Exception خودداری خواهد کرد:
+
+.. code-block:: python
+    :linenos:
+
+    class SampleContextManager:
+        def __enter__(self):
+            print('---> Entered into context manager!')
+
+        def __exit__(self, exc_type, exc_value, traceback):
+            print('exc_type:', exc_type)
+            print('exc_value:', exc_value)
+            print('traceback:', traceback)
+            print('<--- Exiting from context manager!')
+            return True
+
+
+    with SampleContextManager():
+        print('|||||||||Inside context manager! - Top')
+        a = 8 / 0
+        print('|||||||||Inside context manager! - Bottom')
+
+
+    print('***FINISH***')
+
+::
+
+    ---> Entered into context manager!
+    |||||||||Inside context manager! - Top
+    exc_type: <class 'ZeroDivisionError'>
+    exc_value: division by zero
+    traceback: <traceback object at 0x7f4b3d520048>
+    <--- Exiting from context manager!
+    ***FINISH***
+
+یادآوری:‌ می‌دانیم که خروجی هر تابع یا متد به صورت پیش‌فرض برای ``None`` می‌باشد و این مقدار در مقام ارزش‌سنجی بولین، ارزشی برابر با مقدار ``False`` دارد.
+
+*در طی دروس آینده به مبحث Exception و مدیریت آن خواهیم پرداخت.*
+
+ 
+
+
 
 |
 

lessons/l16.rst

@@ -677,6 +677,7 @@
     ******************************
     --------> Finished!
 
+
 روند انتشار Exception
 ----------------------------
 
@@ -718,7 +719,6 @@
 در نمونه کد بالا همانطور که مشخص است تمام Exceptionها در داخل تابع ``print_sum_div_first`` رخ می‌دهد ولی از آنجا که این تابع فاقد handler می‌باشد، Exceptionها به یک مرحله قبل‌تر یعنی تابع ``action`` تحویل می‌گردند، ولی این تابع تنها یک handler برای ``ZeroDivisionError`` داشته پس تمامی Exceptionهای احتمالی دیگر از جمله ``TypeError`` به یک مرحله قبل‌تر تحویل و خوشبختانه در آن‌جا handle می‌شوند!
 
 
-
 مدیریت خطای تودرتو (Nested Exception Handling)
 ---------------------------------------------------
 
@@ -727,6 +727,52 @@
 البته از آنجا که در یکی از بندهای فلسفه پایتون آمده: `PEP 20: Flat is better than nested <https://www.python.org/dev/peps/pep-0020/>`__ انجام این‌کار چندان پایتونی نمی‌باشد و برنامه‌نویس احتمالا می‌تواند با کمی دقت بیشر از ساختار تودرتو پرهیز کند و کدی به مراتب خواناتر توسعه دهد. به هر حال امکان این کار در زبان برنامه‌نویسی پایتون برای برنامه‌نویس محفوظ نگه‌داشته شده است.
 
 
+
+مدیریت خطا و دستور ``with``
+--------------------------------------
+
+از درس بیست و یکم با مفهوم Context Manager و ارتباط آن با دستور ``with`` آشنا هستیم. اینکه مدیریت خطا برای این ساختار چگونه باشد به این بستگی دارد که می‌خواهیم در کدام نقطه Exception احتمالی را handle کنیم. بر اساس مفهوم Context Manager، در چند نقطه زیر احتمال بروز Exception وجود دارد:
+
+* داخل متد ``__init__`` کلاس ContextManager
+* داخل متد ``__enter__`` کلاس ContextManager
+* داخل بدنه دستور ``with``
+* داخل متد ``__exit__`` کلاس ContextManager
+
+
+اگر برایمان مهم نباشد می‌توانیم به صورت زیر یک handler برای بروز Exceptionهای احتمالی در تمام حالات بالا پیاده‌سازی نماییم::
+
+
+    try:
+        with ContextManager():
+            do_something()
+    except Exception as err:
+        pass
+
+
+در غیر این صورت می‌توانید مشابه نمونه کد زیر عمل نمایید::
+
+    try:
+        context_manager = ContextManager()
+
+    except Exception as err:
+        # Handler for: '__init__'
+
+    else:
+        try:
+            with context_manager:
+                try:
+                    do_something()
+
+                except Exception as err:
+                    # Handler for: 'with' body
+
+        except Exception as err:
+            # Handler for: '__enter__' and '__exit__'
+
+
+[`PEP 343 - Specification: The 'with' Statement <https://www.python.org/dev/peps/pep-0343/#specification-the-with-statement>`__]
+
+
 کارایی (Performance)
 ----------------------------