python
diff --git a/‎tutorial/classes.po‎
Lines changed: 147 additions & 29 deletions b/‎tutorial/classes.po‎
Lines changed: 147 additions & 29 deletions
@@ -1560,14 +1560,17 @@ msgstr ""
 
 #: ../../tutorial/classes.rst:738
 msgid "Odds and Ends"
-msgstr ""
+msgstr "نکات متفرقه"
 
 #: ../../tutorial/classes.rst:740
 msgid ""
 "Sometimes it is useful to have a data type similar to the Pascal \"record\" "
 "or C \"struct\", bundling together a few named data items. The idiomatic "
 "approach is to use :mod:`dataclasses` for this purpose::"
 msgstr ""
+"گاهی اوقات داشتن یک نوع داده مشابه «رکورد» در پاسکال یا "
+"«ساختار» در C مفید است، که چندین آیتم داده‌ی نام‌دار را کنار هم بسته‌بندی می‌کند. روش استاندارد "
+"برای این کار استفاده از :mod:`dataclasses` است::"
 
 #: ../../tutorial/classes.rst:744
 msgid ""
@@ -1579,6 +1582,13 @@ msgid ""
 "    dept: str\n"
 "    salary: int"
 msgstr ""
+"from dataclasses import dataclass\n"
+"\n"
+"@dataclass\n"
+"class Employee:\n"
+"    name: str\n"
+"    dept: str\n"
+"    salary: int"
 
 #: ../../tutorial/classes.rst:754
 msgid ""
@@ -1588,6 +1598,11 @@ msgid ""
 ">>> john.salary\n"
 "1000"
 msgstr ""
+">>> john = Employee('john', 'computer lab', 1000)\n"
+">>> john.dept\n"
+"'computer lab'\n"
+">>> john.salary\n"
+"1000"
 
 #: ../../tutorial/classes.rst:760
 msgid ""
@@ -1598,6 +1613,12 @@ msgid ""
 "and :meth:`~io.TextIOBase.readline` that get the data from a string buffer "
 "instead, and pass it as an argument."
 msgstr ""
+"یک قطعه کد پایتون که انتظار یک نوع دادهٔ انتزاعی خاص را دارد، اغلب "
+"می‌تواند به جای آن، یک کلاس دریافت کند که متدهای آن نوع داده را شبیه‌سازی می‌کند. "
+"برای مثال، اگر تابعی دارید که داده‌هایی را از یک شیء فایل قالب‌بندی می‌کند، "
+"می‌توانید کلاسی تعریف کنید با متدهای :meth:`~io.TextIOBase.read` "
+"و :meth:`~io.TextIOBase.readline` که داده‌ها را از یک بافر رشته‌ای دریافت می‌کنند، "
+"و آن را به عنوان آرگومان به تابع ارسال کنید."
 
 #: ../../tutorial/classes.rst:772
 msgid ""
@@ -1606,16 +1627,22 @@ msgid ""
 "method :meth:`!m`, and :attr:`m.__func__ <method.__func__>` is "
 "the :ref:`function object <user-defined-funcs>` corresponding to the method."
 msgstr ""
+":ref:`اشیاء متد نمونه <instance-methods>` نیز ویژگی‌هایی دارند: "
+":attr:`m.__self__ <method.__self__>` شیء نمونه‌ای است که متد :meth:`!m` "
+"به آن تعلق دارد، و :attr:`m.__func__ <method.__func__>` همان "
+":ref:`شیء تابع <user-defined-funcs>` متناظر با آن متد است."
 
 #: ../../tutorial/classes.rst:782
 msgid "Iterators"
-msgstr ""
+msgstr "تکرارگرها"
 
 #: ../../tutorial/classes.rst:784
 msgid ""
 "By now you have probably noticed that most container objects can be looped "
 "over using a :keyword:`for` statement::"
 msgstr ""
+"تا اینجا احتمالاً متوجه شده‌اید که می‌توان روی بیشتر اشیاء ظرف با استفاده از "
+"دستور :keyword:`for` حلقه زد::"
 
 #: ../../tutorial/classes.rst:787
 msgid ""
@@ -1630,6 +1657,16 @@ msgid ""
 "for line in open(\"myfile.txt\"):\n"
 "    print(line, end='')"
 msgstr ""
+"for element in [1, 2, 3]:\n"
+"    print(element)\n"
+"for element in (1, 2, 3):\n"
+"    print(element)\n"
+"for key in {'one':1, 'two':2}:\n"
+"    print(key)\n"
+"for char in \"123\":\n"
+"    print(char)\n"
+"for line in open(\"myfile.txt\"):\n"
+"    print(line, end='')"
 
 #: ../../tutorial/classes.rst:798
 msgid ""
@@ -1643,6 +1680,15 @@ msgid ""
 "to terminate.  You can call the :meth:`~iterator.__next__` method using "
 "the :func:`next` built-in function; this example shows how it all works::"
 msgstr ""
+"این سبک دسترسی واضح، مختصر و راحت است.  استفاده از "
+"تکرارگرها در همه‌جا نفوذ کرده و پایتون را یکپارچه می‌کنند.  در پشت صحنه، "
+"دستور :keyword:`for` تابع :func:`iter` را روی شیء ظرف فراخوانی می‌کند.  "
+"این تابع یک شیء تکرارگر برمی‌گرداند که "
+"متد :meth:`~iterator.__next__` را تعریف می‌کند که به المان‌ها در ظرف "
+"یکی یکی دسترسی پیدا می‌کند.  وقتی المان‌ها تمام شوند، :meth:`~iterator.__next__` "
+"یک استثنای :exc:`StopIteration` ایجاد می‌کند که به حلقه‌ی :keyword:`!for` می‌گوید "
+"پایان یابد.  می‌توانید متد :meth:`~iterator.__next__` را با استفاده از "
+"تابع داخلی :func:`next` فراخوانی کنید؛ این مثال نشان می‌دهد که چگونه همه‌چیز کار می‌کند::"
 
 #: ../../tutorial/classes.rst:807
 msgid ""
@@ -1662,6 +1708,21 @@ msgid ""
 "    next(it)\n"
 "StopIteration"
 msgstr ""
+">>> s = 'abc'\n"
+">>> it = iter(s)\n"
+">>> it\n"
+"<str_iterator object at 0x10c90e650>\n"
+">>> next(it)\n"
+"'a'\n"
+">>> next(it)\n"
+"'b'\n"
+">>> next(it)\n"
+"'c'\n"
+">>> next(it)\n"
+"Traceback (most recent call last):\n"
+"  File \"<stdin>\", line 1, in <module>\n"
+"    next(it)\n"
+"StopIteration"
 
 #: ../../tutorial/classes.rst:823
 msgid ""
@@ -1671,6 +1732,11 @@ msgid ""
 "the class defines :meth:`!__next__`, then :meth:`!__iter__` can just return "
 "``self``::"
 msgstr ""
+"حالا که با سازوکار پشت پروتکل تکرارگر آشنا شدید، اضافه کردن "
+"رفتار تکرارگر به کلاس‌هایتان آسان است.  یک متد :meth:`~container.__iter__` تعریف کنید "
+"که یک شیء با متد :meth:`~iterator.__next__` برمی‌گرداند.  اگر "
+"کلاس :meth:`!__next__` را تعریف کرده باشد، آنگاه :meth:`!__iter__` می‌تواند فقط "
+"``self`` را برگرداند::"
 
 #: ../../tutorial/classes.rst:828
 msgid ""
@@ -1689,6 +1755,20 @@ msgid ""
 "        self.index = self.index - 1\n"
 "        return self.data[self.index]"
 msgstr ""
+"class Reverse:\n"
+"    \"\"\"Iterator for looping over a sequence backwards.\"\"\"\n"
+"    def __init__(self, data):\n"
+"        self.data = data\n"
+"        self.index = len(data)\n"
+"\n"
+"    def __iter__(self):\n"
+"        return self\n"
+"\n"
+"    def __next__(self):\n"
+"        if self.index == 0:\n"
+"            raise StopIteration\n"
+"        self.index = self.index - 1\n"
+"        return self.data[self.index]"
 
 #: ../../tutorial/classes.rst:845
 msgid ""
@@ -1703,10 +1783,20 @@ msgid ""
 "p\n"
 "s"
 msgstr ""
+">>> rev = Reverse('spam')\n"
+">>> iter(rev)\n"
+"<__main__.Reverse object at 0x00A1DB50>\n"
+">>> for char in rev:\n"
+"...     print(char)\n"
+"...\n"
+"m\n"
+"a\n"
+"p\n"
+"s"
 
 #: ../../tutorial/classes.rst:860
 msgid "Generators"
-msgstr ""
+msgstr "تولیدکننده‌ها"
 
 #: ../../tutorial/classes.rst:862
 msgid ""
@@ -1718,12 +1808,12 @@ msgid ""
 "An example shows that generators can be trivially easy to create::"
 msgstr ""
 ":term:`Generators <generator>` یک ابزار ساده و قدرتمند برای ایجاد "
-"اینتراتورها هستند. آنها مانند توابع عادی نوشته می شوند اما هر زمان که می "
-"خواهند داده ای را بازگردانند از دستور :keyword:`yield` استفاده می کنند. هر "
-"بار که :func:`next` بر روی آن فراخوانی می شود، مولد از جایی که متوقف شده "
-"ادامه می یابد (تمام مقادیر داده ها و اینکه آخرین دستور اجرا شده چه بوده را "
-"به خاطر می آورد). یک مثال نشان می دهد که ایجاد مولدها می تواند به طرز "
-"باورنکردنی ساده باشد::"
+"اینتراتور‌ها هستند. آن‌ها مانند توابع عادی نوشته می‌شوند اما هر زمان که می‌خواهند "
+"داده‌ای را بازگردانند از دستور :keyword:`yield` استفاده می‌کنند. هر "
+"بار که :func:`next` بر روی آن فراخوانی می‌شود، مولد از جایی که متوقف شده "
+"ادامه می‌یابد (تمام مقادیر داده‌ها و اینکه آخرین دستور اجرا شده چه بوده را "
+"به خاطر می‌آورد). یک مثال نشان می‌دهد که ایجاد مولد‌ها می‌تواند به طرز "
+"باور‌نکردنی ساده باشد::"
 
 #: ../../tutorial/classes.rst:869
 msgid ""
@@ -1760,11 +1850,11 @@ msgid ""
 "compact is that the :meth:`~iterator.__iter__` "
 "and :meth:`~generator.__next__` methods are created automatically."
 msgstr ""
-"هر چیزی که با تولیدکننده ها (generators) قابل انجام است، می تواند با استفاده "
-"از تکرارگرهای مبتنی بر کلاس نیز انجام شود، همانطور که در بخش قبلی توضیح داده "
-"شد. آنچه تولیدکننده ها را فشرده می کند، این است که روش "
-"های :meth:`~iterator.__iter__` و :meth:`~generator.__next__` به طور خودکار "
-"ایجاد می شوند."
+"هر چیزی که با تولیدکننده‌ها قابل انجام است، می‌تواند با استفاده "
+"از تکرارگر‌های مبتنی بر کلاس نیز انجام شود، همانطور که در بخش قبلی توضیح داده "
+"شد. آنچه تولیدکننده‌ها را فشرده می‌کند، این است که روش‌های "
+":meth:`~iterator.__iter__` و :meth:`~generator.__next__` به‌طور خودکار "
+"ایجاد می‌شوند."
 
 #: ../../tutorial/classes.rst:888
 msgid ""
@@ -1773,10 +1863,10 @@ msgid ""
 "and much more clear than an approach using instance variables like "
 "``self.index`` and ``self.data``."
 msgstr ""
-"یکی دیگر از ویژگی های کلیدی این است که متغیرهای محلی و وضعیت اجرا به طور "
-"خودکار بین فراخوانی ها ذخیره می شوند. این امر نوشتن تابع را آسان تر و خیلی "
-"واضح تر از رویکردی که از متغیرهای نمونه ای مانند ``self.index`` و "
-"``self.data`` استفاده می کند، کرده است."
+"یکی دیگر از ویژگی‌های کلیدی این است که متغیر‌های محلی و وضعیت اجرا به‌طور "
+"خودکار بین فراخوانی‌ها ذخیره می‌شوند. این امر نوشتن تابع را آسان‌تر و خیلی "
+"واضح‌تر از رویکردی که از متغیر‌های نمونه‌ای مانند ``self.index`` و "
+"``self.data`` استفاده می‌کند، کرده است."
 
 #: ../../tutorial/classes.rst:893
 msgid ""
@@ -1785,14 +1875,14 @@ msgid ""
 "combination, these features make it easy to create iterators with no more "
 "effort than writing a regular function."
 msgstr ""
-"علاوه بر ایجاد خودکار متدها و ذخیره سازی وضعیت برنامه، زمانی که جنراتورها "
-"خاتمه می یابند، به طور خودکار :exc:`StopIteration` را ایجاد می کنند. این "
-"ویژگی ها به صورت ترکیبی، ساختن تکرارگرها را به همان سادگی نوشتن یک تابع عادی "
-"امکان پذیر می سازند."
+"علاوه بر ایجاد خودکار متد‌ها و ذخیره سازی وضعیت برنامه، زمانی که تولیدکننده‌ها "
+"خاتمه می‌یابند، به‌طور خودکار :exc:`StopIteration` را ایجاد می‌کنند. این "
+"ویژگی‌ها به صورت ترکیبی، ساختن تکرارگر‌ها را به همان سادگی نوشتن یک تابع عادی "
+"امکان پذیر می‌سازند."
 
 #: ../../tutorial/classes.rst:902
 msgid "Generator Expressions"
-msgstr ""
+msgstr "عبارات تولیدکننده"
 
 #: ../../tutorial/classes.rst:904
 msgid ""
@@ -1803,10 +1893,16 @@ msgid ""
 "compact but less versatile than full generator definitions and tend to be "
 "more memory friendly than equivalent list comprehensions."
 msgstr ""
+"برخی از تولیدکننده‌های ساده را می‌توان به‌صورت مختصر به عنوان عبارت کدنویسی کرد، با استفاده از یک نحو "
+"مشابه درک‌لیست‌ها اما با پرانتز به جای کروشه‌ی "
+"باز. این عبارت‌ها برای شرایطی طراحی شده‌اند که تولیدکننده "
+"بلافاصله توسط یک تابع محاط‌شونده استفاده می‌شود.  عبارت‌های تولیدکننده فشرده‌تر "
+"هستند اما نسبت به تعاریف کامل تولیدکننده، انعطاف‌پذیری کمتری دارند و معمولاً "
+"نسبت به درک‌لیست‌های معادل، با حافظه سازگارتر هستند."
 
 #: ../../tutorial/classes.rst:911
 msgid "Examples::"
-msgstr ""
+msgstr "مثال‌ها"
 
 #: ../../tutorial/classes.rst:913
 msgid ""
@@ -1827,10 +1923,26 @@ msgid ""
 ">>> list(data[i] for i in range(len(data)-1, -1, -1))\n"
 "['f', 'l', 'o', 'g']"
 msgstr ""
+">>> sum(i*i for i in range(10))                 # sum of squares\n"
+"285\n"
+"\n"
+">>> xvec = [10, 20, 30]\n"
+">>> yvec = [7, 5, 3]\n"
+">>> sum(x*y for x,y in zip(xvec, yvec))         # dot product\n"
+"260\n"
+"\n"
+">>> unique_words = set(word for line in page  for word in line.split())\n"
+"\n"
+">>> valedictorian = max((student.gpa, student.name) for student in "
+"graduates)\n"
+"\n"
+">>> data = 'golf'\n"
+">>> list(data[i] for i in range(len(data)-1, -1, -1))\n"
+"['f', 'l', 'o', 'g']"
 
 #: ../../tutorial/classes.rst:932
 msgid "Footnotes"
-msgstr ""
+msgstr "پا‌ورقی‌ها"
 
 #: ../../tutorial/classes.rst:933
 msgid ""
@@ -1841,19 +1953,25 @@ msgid ""
 "namespace implementation, and should be restricted to things like post-"
 "mortem debuggers."
 msgstr ""
+"به جز یک مورد.  اشیاء ماژول یک ویژگی مخفی فقط‌خواندنی دارند "
+"به نام :attr:`~object.__dict__` که دیکشنری مورد استفاده برای "
+"پیاده‌سازی فضای نام ماژول را برمی‌گرداند؛ نام ``__dict__`` یک ویژگی است اما "
+"یک نام سراسری نیست. بدیهی است که استفاده از این ویژگی، انتزاع "
+"پیاده‌سازی فضای نام را نقض می‌کند و باید به مواردی مانند "
+"اشکال‌زدای پس‌ازمرگ محدود شود."
 
 #: ../../tutorial/classes.rst:343
 msgid "object"
-msgstr ""
+msgstr "شیء"
 
 #: ../../tutorial/classes.rst:343
 msgid "method"
-msgstr ""
+msgstr "متد"
 
 #: ../../tutorial/classes.rst:679
 msgid "name"
-msgstr ""
+msgstr "اسم"
 
 #: ../../tutorial/classes.rst:679
 msgid "mangling"
-msgstr ""
+msgstr "دستکاری نام"