update: add some fetures of python 3.8 log#00115

Saeid Darvish · Saeid Darvish · commit ed6819518a8b · 2021-02-20T22:49:14.000+03:30
diff --git a/donate-report.rst b/donate-report.rst
@@ -11,7 +11,7 @@
 
 مبالغ مهم نیستند، از اقدام و پیام تشویق شما دوستان بسیار سپاسگذارم. (*اطلاعات این صفحه به صورت آنی بروز نمی‌شود!*)
 
-**از ابتدا: 1,621,222 تومان**
+**از ابتدا (1395): 1,721,222 تومان**
 
 ----
 
@@ -24,6 +24,14 @@
 
 
 
+.. raw:: html
+
+    <p id="17e37d" >48: <strong style="color:#5C6BC0">100,000 تومان</strong> در زمان 09:03 02-12-1399<br><q>عالی بود</q></p>
+
+----
+
+
+
 .. raw:: html
 
     <p id="cfb1db" >47: <strong style="color:#5C6BC0">10,000 تومان</strong> در زمان 12:25 23-11-1399<br><q>ممنون بایت وقتی که گذاشتین</q></p>
diff --git a/lessons/l06.rst b/lessons/l06.rst
@@ -874,6 +874,28 @@ Docstring باید به عنوان دستور نخست درج گردد و این
 
 
 
+عملگر‌ شیرماهی (Walrus Operator)
+------------------------------------------------------------
+
+از نسخه **3.8 پایتون** یک عملگر جدید به نام Assignment Expressions یا Walrus Operator به سینتکس پایتون اضافه شده است. [`PEP 572 <https://www.python.org/dev/peps/pep-0572/>`__]. نمایش این عملگر به شکل ``=:`` (شبیه دو چشم و عاج یک شیرماهی! [`تصویر <https://en.wikipedia.org/wiki/Walrus#/media/File:Pacific_Walrus_-_Bull_(8247646168).jpg>`__]) می‌باشد و به ما این امکان را می‌دهد که عملیات انتساب و بازگرداندن مقدار را به صورت همزمان به انجام برسانیم. به نمونه کد زیر توجه نمایید::
+
+    >>> walrus = False
+    >>> print(walrus)
+    False
+
+::
+
+        >>> print(walrus := True)  # Python >= 3.8
+        True
+
+        >>> walrus
+        True
+
+دو نمونه کد بالا عملکرد یکسانی دارند با این تفاوت که در نمونه دوم تنها با استفاده یک سطر کد، متغیر ``walrus`` با انتساب مقدار ``True`` ایجاد و سپس به تابع ``print`` ارسال می‌گردد.
+
+
+
+
 |
 
 ----
diff --git a/lessons/l09.rst b/lessons/l09.rst
@@ -109,6 +109,15 @@
     Jhon
     >>>
 
+به مثال دیگری با استفاده از walrus operator (عملگر شیرماهی - درس ششم) و f-string (درس هفتم) توجه نمایید::
+
+    >>> # Python >= 3.8
+    >>> a_list = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+    >>> if (n := len(a_list)) > 5: 
+    ...     print(f"List is too long ({n} elements, expected <= 5)")
+    ... 
+    List is too long (10 elements, expected <= 5)
+
 
 .. rubric:: ۲. ساختار همراه با ``else`` (دو انتخابی)
 
diff --git a/lessons/l12.rst b/lessons/l12.rst
@@ -732,8 +732,6 @@
         File "<stdin>", line 1
       SyntaxError: positional argument follows keyword argument
 
-
-
   ::
 
     >>> def f(a, *b, c, d=5):
@@ -759,6 +757,24 @@
 
 
 
+  در بسط این مبحث لازم است اضافه گردد که می‌توان ارسال آرگومان به برخی پارامترهای یک تابع را ملزم به روش **نام=مقدار** کرد. در این شیوه از کاراکتر ``*`` به عنوان یک پارامتر نشانگر استفاده می‌گردد به این صورت که تمامی پارامترهای بعد از آن تنها می‌بایست به صورت **نام=مقدار** مقداردهی شوند. باید توجه داشت که ``*`` در اینجا پارامتر نبوده و تنها نقش یک نشانگر را دارد::
+
+      >>> def f(a, *, b, c):
+      ...     print(a, b, c)
+      ... 
+     >>> f(1, b=2, c=3)
+     1 2 3
+
+     >>> f(1, 2, c=3)
+     Traceback (most recent call last):
+       File "<stdin>", line 1, in <module>
+     TypeError: f() takes 1 positional argument but 2 positional arguments (and 1 keyword-only argument) were given
+
+     >>> f(1, 2, 3)
+     Traceback (most recent call last):
+       File "<stdin>", line 1, in <module>
+     TypeError: f() takes 1 positional argument but 3 were given
+
 
 
 
@@ -810,9 +826,26 @@
       7 14 () {'d': 28, 'c': 21}
 
 
+* Positional-Only Parameters [`PEP 570 <https://www.python.org/dev/peps/pep-0570/>`_]
 
+  از **نسخه 3.8 پایتون** سینتکس جدیدی به پایتون اضافه گردیده است که این امکان را به ما می‌دهد تا بتوانیم تعدادی پارامتر را در تعریف یک تابع مجبور به ارسال آرگومان متناظر آن‌ها بر اساس موقعیت نماییم و به بیانی دیگر امکان ارسال آرگومان به روش **نام=مقدار** را برای آن‌ها غیرفعال سازیم. این سینتکس در مواقعی که نام پارامترها در آینده ممکن است دستخوش تغییر شوند، مفید خواهد بود زیرا در این حالت بخش‌های دیگری از کد برنامه نیاز به تغییر نخواهد داشت.
 
+  در این سینتکس کافی است در تعریف پارامترهای تابع، پس از نام پارامترهای مورد نظر خود از کاراکتر ``/`` به عنوان یک پارامتر نشانگر استفاده نماییم. در این صورت ارسال آرگومان به روش نام=مقدار برای تمامی پارامترهای پیش از ``/`` ممنوع می‌گردد.  باید توجه داشت که ``/`` در اینجا پارامتر نبوده و تنها نقش یک نشانگر را دارد::
+
+      >>> def f(a, /):
+      ...     print(a)
+      ... 
+      >>> f(3)
+      3
+
+      >>> f(a=3)
+      Traceback (most recent call last):
+        File "<stdin>", line 1, in <module>
+      TypeError: f() got some positional-only arguments passed as keyword arguments: 'a'
+      >>> 
 
+  .. tip:: 
+      با توضیحات ارائه شده، در یک تابع با سرآیندی همچون ``def f(a, b, /, c, d, *, e, f)``  ارسال آرگومان برای دو پارامتر ``a`` و ``b`` به روش نام=مقدار ممنوع است (positional-only) و ارسال آرگومان برای دو پارامتر ``c`` و ``d`` می‌تواند با استفاده از هر دو روش نام=مقدار یا موقعیت باشد (positional or keyword) و همچنین ارسال آرگومان برای دو پارامتر ``e`` و ``f`` تنها با روش مقدار=نام مجاز خواهد بود (keyword-only).
 
 
 |
diff --git a/log.rst b/log.rst
@@ -9,6 +9,19 @@
 گزارش توسعه
 =============
 
+.. raw:: html
+
+    <p class="rubric" id="00115" ><a class="reference external" href="#00115">00115</a> - شنبه ۲ اسفند ۱۳۹۹</p>
+
+* بروزرسانی - ویژگی **پایتون 3.8:** مبحث Walrus Operator به درس ششم اضافه گردید.
+* بروزرسانی - ویژگی **پایتون 3.8:** مبحث Positional-Only Parameters به درس دوازدهم اضافه گردید.
+* گزارش حمایت مالی بروز گردید.
+
+----
+
+
+
+
 .. raw:: html
 
     <p class="rubric" id="00114" ><a class="reference external" href="#00114">00114</a> - جمعه ۱ اسفند ۱۳۹۹</p>
