l21 -->split: l21,l22

Author: Saeid Darvish

index.rst

@@ -47,6 +47,7 @@
    lessons/l19
    lessons/l20
    lessons/l21
+   lessons/l22
    log
    donate-report
    python-interactive

lessons/l21.rst

@@ -1,11 +1,11 @@
 .. role:: emoji-size
 
 .. meta::
-   :description: کتاب آموزش زبان برنامه نویسی پایتون به فارسی، آموزش شی گرایی در پایتون، OOP در پایتون،  Decorators در پایتون، Descriptors در پایتون، Properties در پایتون، دیتا کلاس در پایتون، Data Classe در پایتون
+   :description: کتاب آموزش زبان برنامه نویسی پایتون به فارسی، آموزش شی گرایی در پایتون، OOP در پایتون،  Decorators در پایتون، Descriptors در پایتون، Properties در پایتون
    :keywords:  آموزش, آموزش پایتون, آموزش برنامه نویسی, پایتون, Decorators, کتابخانه, پایتون, شی گرایی در پایتون, Descriptors,Properties 
 
 
-درس ۲۱: شی گرایی (OOP) در پایتون: Descriptors ،Decorator ،Data Class و Properties
+درس ۲۱: شی گرایی (OOP) در پایتون: Descriptors ،Decorator و Properties
 ===================================================================================================
 
 
@@ -99,238 +99,6 @@ Properties
 
 
 
-
-Data Classes
-----------------------------
-
-از **نسخه 3.7 پایتون** یک ویژگی جالب به پایتون اضافه گردید. دیتا کلاس **(Data Class)** [`PEP 557 <https://www.python.org/dev/peps/pep-0557>`__]، در واقع یک سینتکسی ساده‌سازی شده برای ایجاد کلاس‌هایی که معمولا تنها حاوی Instance Attribute می‌باشند. این نوع کلاس با استفاده از دکوراتور ``dataclass@`` از ماژول ``dataclasses`` ایجاد می‌گردد [`اسناد پایتون <https://docs.python.org/3/library/dataclasses.html>`__]. برای مثال کلاس زیر را در نظر بگیرید:
-
-
-.. code-block:: python
-    :linenos:
-
-    from dataclasses import dataclass
-
-    @dataclass
-    class Student:
-        name: str
-        score: int
-
-    student = Student('Saeid', 70)
-    print(student)
-    print('-' * 30)
-    print(student.name)
-    print(student.score)
-    print('-' * 30)
-    print(Student('Saeid', 70) == Student('Saeid', 70))
-
-::
-
-    Student(name='Saeid', score=70)
-    ------------------------------
-    Saeid
-    70
-    ------------------------------
-    True
-
-
-در این نوع کلاس برای تعریف Attributeها از سینتکس  Variable Annotations [`PEP 526 <https://www.python.org/dev/peps/pep-0526/>`__] استفاده می‌شود. این سینتکس و در کل ذکر نوع داده در پایتون یا Type Hints [`PEP 484 <https://www.python.org/dev/peps/pep-0484/>`__] **موضوع درس بعدی است**. در این شیوه نوع متغیرها به صراحت ذکر می‌گردد. در حالت عادی تعریف یک متغییر در زبان برنامه‌نویسی پایتون به صورت ``var = value`` می‌باشد (درس ششم)، همانطور که می‌دانیم تاکنون هیچ‌گاه در پایتون برای تعریف متغییر نیازی به ذکر صریح نوع داده نمی‌بود، **اکنون نیز نیازی نیست**، ولی از **نسخه 3.6 پایتون** می‌توانیم اینکار را انجام دهیم، می‌توانیم نوع داده را خودمان مشخص کنیم یا به اصطلاح آن نوع را annotation کنیم. سینتکس این عملیات به صورت ``var: annotation`` می‌باشد، این سینتکس مشخص می‌کند که متغییر var از نوع annotation می‌باشد. همچنین با استفاده از سینتکس ``var: annotation = value`` نیز می‌توان همزمان عملیات انتساب و مقداردهی را نیز انجام داد. باید توجه داشت که تغییری در ساختار مفسر پایتون ایجاد نشده است!، بلکه صرفا سینتکس جدیدی اضافه شده که می‌تواند به ابزارهای شخص‌ثالث (third party) همانند IDEها برای کنترل نوع داده‌ها در زمان توسعه برنامه یاری‌رسان باشد.
-
-باید توجه داشت که طبق سند PEP 484 پیروی از اصول Type Hints در پایتون اجباری نبوده و نخواهد شد. ولی Data Class یک استثناست و در آن حتما می‌بایست Attributeها به شیوه شرح داده شده، تعریف گردند و به آن‌ها فیلدهای (field) دیتا کلاس گفته می‌شود.
-
-از آنجا که این نوع کلاس برای ایجاد یک کاربرد عمومی از کلاس‌ها توسعه یافته (نگهداری اطلاعات)، بنابراین بسیاری از عملیات‌ها در آن خودکارسازی شده تا پیاده‌سازی این کلاس ساده‌تر از هر کلاس دیگری باشد. برای مثال نیازی به پیاده‌سازی متد ``__init__`` نیست و این متد به صورت خودکار برای کلاس ما ایجاد می‌گردد. اکنون اگر بخواهیم دیتاکلاس مثال قبل را به صورت عادی پیاده‌سازی کنیم:
-
-
-.. code-block:: python
-    :linenos:
-
-    class Student:
-
-        def __init__(self, name, score):
-            self.name = name
-            self.score = score
-
-
-    student = Student('Saeid', 70)
-    print(student)
-    print('-' * 30)
-    print(student.name)
-    print(student.score)
-    print('-' * 30)
-    print(Student('Saeid', 70) == Student('Saeid', 70))
-
-::
-
-    <__main__.Student object at 0x7f922a311518>
-    ------------------------------
-    Saeid
-    70
-    ------------------------------
-    False
-
-
-با مقایسه این دو خروجی، مشاهده می‌شود که مقدار چاپ شی (سطر ۹) و نیز حاصل مقایسه دو شی (سطر ۱۴) با مقادیر یکسان متفاوت است. دلیل نیز پیشتر بیان شد،‌ تعدادی متد خاص همانند ``__init__`` برای دیتا کلاس‌ها پیاده‌سازی می‌شود که با پیاده‌سازی پیش‌فرض متفاوت‌ بوده و بر نوع کاربرد این کلاس‌ها و راحتی استفاده آن‌ها تمرکز شده است. این پیاده‌سازی را می‌توان به صورت زیر نمایش داد:
-
-
-
-.. code-block:: python
-    :linenos:
-
-    class Student:
-
-        def __init__(self, name, score):
-            self.name = name
-            self.score = score
-
-        def __str__(self):
-            return (f'{self.__class__.__name__}'
-                    f'(name={self.name!r}, score={self.score!r})')
-
-        def __eq__(self, other):
-            return (self.name, self.score) == (other.name, other.score)
-
-
-    student = Student('Saeid', 70)
-    print(student)
-    print('-' * 30)
-    print(student.name)
-    print(student.score)
-    print('-' * 30)
-    print(Student('Saeid', 70) == Student('Saeid', 70))
-
-::
-
-    Student(name='Saeid', score=70)
-    ------------------------------
-    Saeid
-    70
-    ------------------------------
-    True
-
-از درس پیش با متد ``__eq__`` آشنا هستیم، متد ``__str__`` [`اسناد پایتون <https://docs.python.org/3/reference/datamodel.html#object.__str__>`__] نیز یکی دیگر از متدهای خاص پایتون می‌باشد و هنگامی که یک شی می‌خواهد به نوع str تبدیل گردد، به صورت خودکار فراخوانی می‌گردد (**تبدیل به نوع رشته - درس هفتم**)، به صورت مشابه متد ``__repr__`` [`اسناد پایتون <https://docs.python.org/3/reference/datamodel.html#object.__repr__>`__] نیز قابل پیاده سازی است.
-
-
-متد ``__post_init__``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-دیتا کلاس‌ها همچنین می‌توانند شامل متد نیز باشند، چگونگی تعریف متد در دیتا کلاس تفاوتی با دیگر کلاس‌ها ندارد. 
-
-از طرفی می‌دانیم که متد ``__init__`` یک دیتا کلاس به صورت خودکار ایجاد می‌گردد و مرحله initialize شی از دستان ما خارج شده است. با این حال چنانچه اگر کلاس  شامل متدی با نام ``__post_init__`` باشد، این متد پس از ``__init__`` به صورت خودکار فراخوانی می‌گردد:
-
-.. code-block:: python
-    :linenos:
-
-    from dataclasses import dataclass
-
-    @dataclass
-    class Student:
-        name: str
-        score: int
-
-        def __post_init__(self):
-            print("__post_init__ got called:", self)
-            if self.name == 'Saeed':
-                self.name =  'Saeid'
-
-
-    student = Student('Saeed', 70)
-    print(student)
-
-::
-
-    __post_init__ got called: Student(name='Saeed', score=70)
-    Student(name='Saeid', score=70)
-
-
-
-از طریق ماژول ``dataclasses`` یک نوع یک annotation type جدید با نام ``InitVar`` در دسترس است. چنانچه در تعریف هر یک از Attributeها کلاس از این نوع استفاده کنیم، آن Attribute به عنوان پارامتر به متد ``__post_init__`` ارسال می‌گردد. باید توجه داشت که این نوع Attributeها به عنوان **Init-only variables** شناخته می‌شوند [`اسناد پایتون <https://docs.python.org/3/library/dataclasses.html#init-only-variables>`__] و مفسر پایتون آن‌ها را صرفا به ``__post_init__`` ارسال می‌کند و **جزو فیلدهای دیتا کلاس قرار نمی‌دهد**:
-
-
-.. code-block:: python
-    :linenos:
-
-
-    @dataclass
-    class Student:
-        name: InitVar[str]
-        score: int
-
-        def __post_init__(self, name):
-            if name == 'Saeid':
-                self.score =  100
-
-
-    student = Student('Saeid', 70)
-    print(student)
-
-
-::
-
-    Student(score=100)
-
-
-تابع ``field`` و ``fields``
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-تابع ``fields`` از ماژول ``dataclasses`` یک شی از دیتا کلاس یا خود دیتا کلاس را از ورودی دریافت و یک تاپل حاوی تمام فیلد‌های آن بر می‌گرداند [`اسناد پایتون <https://docs.python.org/3/library/dataclasses.html#dataclasses.fields>`__]:
-
-.. code-block:: python
-    :linenos:
-
-    from dataclasses import dataclass, InitVar, fields
-
-    @dataclass
-    class Student:
-        name: str
-        score: int = 70
-        age: InitVar[int] = 18
-
-
-    obj = Student('saeid', 90, 20)
-    print(obj)
-    print(fields(obj))
-
-::
-
-   Student(name='saeid', score=90)
-   (Field(name='name',type=<class 'str'>,default=<dataclasses._MISSING_TYPE object at 0x7f7e5c68cd68>,default_factory=<dataclasses._MISSING_TYPE object at 0x7f7e5c68cd68>,init=True,repr=True,hash=None,compare=True,metadata=mappingproxy({}),_field_type=_FIELD), Field(name='score',type=<class 'int'>,default=70,default_factory=<dataclasses._MISSING_TYPE object at 0x7f7e5c68cd68>,init=True,repr=True,hash=None,compare=True,metadata=mappingproxy({}),_field_type=_FIELD))
-
-
-پیش‌تر گفتیم، Attributeهای داخل یک دیتا کلاس فیلد (Field) خوانده می‌شوند. خروجی بالا نمایش ساختار یک شی Field از دیتا کلاس می‌باشد [`اسناد پایتون <https://docs.python.org/3/library/dataclasses.html#dataclasses.field>`__]. در واقع متغیرهایی که داخل دیتا کلاس با سنتکس Variable Annotations تعریف می‌شوند، به صورت خودکار به فیلد (Field) تبدیل می‌شوند. فیلدها می‌توانند حاوی مقدار پیش‌فرض باشند (همانند فیلد ``score``). برای کاستن از حجم functionality داخل یک دیتا کلاس، ماژول ``dataclasses`` پایتون شامل تابعی است با نام ``field`` که توانایی و انعطاف زیادی در فراهم آوردن مقدار پیش‌فرض برای فیلدهای تعریف شده ایجاد می‌کند. 
-
-یک شی فیلد شامل پارامترهایی است که از طریق تابع ``field`` قابل تنظیم هستند، البته به جز دو پارامتر زیر که از تعریف Variable Annotations استنباط می‌شوند:
-
-
-* ``name``: نام فیلد
-
-* ``type``: نوع (type) فیلد
-
-**تعریف مقدار پیش‌فرض برای یک فیلد با استفاده از تابع** ``field``::
-
-    field(*, default=MISSING, default_factory=MISSING, repr=True, hash=None, init=True, compare=True, metadata=None)
-
-* توجه:‌ همانطور که از مبحث Keyword-Only Arguments از درس دوازدهم به یاد داریم، فراخوانی این تابع تنها با استفاده از ارسال آرگومان به صورت نام=مقدار مجاز خواهید بود.
-
-
-* ``default``:  مقدار پیش‌فرض فیلد، در صورت عدم نیاز می‌بایست با مقدار ویژه ``MISSING`` مقداردهی گردد.
-
-* ``default_factory``: یک موجودیت callable بدون آرگومان را دریافت می‌کند و در زمانی که به مقدار پیش‌فرض برای فیلد نیاز باشد، فراخوانی می‌گردد. در صورت عدم نیاز می‌بایست با مقدار ویژه ``MISSING`` مقداردهی گردد. به بیانی دیگر می‌توان با استفاده از این پارامتر،‌ یک تابع به فیلد اختصاص داد که مقدار یا مقادیر پیش‌فرضی را برای فیلد مورد نظر تولید نماید. 
-
-* توجه: در هر فیلد تنها یکی از دو پارامتر ``default`` یا ``default_factory`` می‌بایست حاوی مقداری غیر از ``MISSING`` باشد.
-
-
-* ``repr``, ``init``, ``compare``, ``hash``: در صورتی که هر کدام از این پارامتر‌ها برابر با مقدار ``True`` (پیش‌فرض) تنطیم گردند، فیلد مربوطه به متدهای ایجاد شده متناظر با هر پارامتر ارسال خواهد شد::
-
-      repr    -->> __repr__ __str__
-      init    -->> __init__
-      compare -->> __eq__ __ne__ __lt__ __le__ __gt__ __ge__
-      hash    -->> __hash__
-
-
-* توجه چنانچه مقدار ``compare`` برای ``True`` تنظیم گردد (حالت پیش‌فرض)،‌مقدار ``hash`` می‌بایست ``None`` (و نه ``False``) باشد، چرا که عملیات مقایسه دو شی دیگر به مقدار hash وابسته نبوده و از طریق متدهای تولید شده (__eq__ و غیره) انجام خواهد شد. 
-
-
-
 |
 
 ----