translating part of library/__main__.po

msgid "Note that if the module didn't encapsulate code inside the ``main`` function but instead put it directly within the ``if __name__ == '__main__'`` block, the ``phrase`` variable would be global to the entire module.  This is error-prone as other functions within the module could be unintentionally using the global variable instead of a local name.  A ``main`` function solves this problem."

Author: invincible627

GLOSSARY.md

@@ -65,6 +65,7 @@
 | parameter        | پارامتر                  |
 | positional        | جایگاهی                  |
 | property         | ویژگی، پراپرتی، خصوصیت   |
+| pass        | پاس دادن           |
 | quotation        | علامت نقل‌وقول           |
 | raise            | پرتاب                    |
 | return           | بازگشت، برگرداندن        |

library/__main__.po

@@ -146,28 +146,31 @@ msgid "In each of these situations, the top-level module's ``__name__`` is set t
 msgstr "در هر کدام از این موقعیت‌ها، ``__name__`` ماژول سطح‌بالا به ``'__main__'`` تنظیم می‌شود."
 
 msgid "As a result, a module can discover whether or not it is running in the top-level environment by checking its own ``__name__``, which allows a common idiom for conditionally executing code when the module is not initialized from an import statement::"
-msgstr ""
+msgstr "در نتیجه، یک ماژول می‌تواند با بررسی ``__name__`` خود متوجه شود که آیا در محیط سطح‌بالا اجرا می‌شود یا نه، که این امکان یک الگوی رایج برای اجرای شرطی کد را فراهم می‌کند زمانی که ماژول از یک دستور ایمپورت مقداردهی اولیه نشده است::"
 
 msgid ""
 "if __name__ == '__main__':\n"
 "    # Execute when the module is not initialized from an import statement.\n"
 "    ..."
 msgstr ""
+"if __name__ == '__main__':\n"
+"    # وقتی ماژول با دستور ایمپورت راه‌اندازی نشده باشد اجرا می‌شود.\n"
+"    ..."
 
 msgid "For a more detailed look at how ``__name__`` is set in all situations, see the tutorial section :ref:`tut-modules`."
-msgstr ""
+msgstr "برای نگاهی دقیق‌تر به نحوه‌ی تنظیم ``__name__`` در همه‌ی موقعیت‌ها، به بخش آموزش :ref:`tut-modules` مراجعه کنید."
 
 msgid "Idiomatic Usage"
-msgstr ""
+msgstr "استفاده‌ی اصطلاحی"
 
 msgid "Some modules contain code that is intended for script use only, like parsing command-line arguments or fetching data from standard input.  If a module like this was imported from a different module, for example to unit test it, the script code would unintentionally execute as well."
-msgstr ""
+msgstr "بعضی ماژول‌ها دارای کدی هستند که فقط برای استفاده‌ی اسکریپتی در نظر گرفته شده است، مانند تجزیه‌ی آرگومان‌های خط فرمان یا دریافت داده از ورودی استاندارد.  اگر چنین ماژولی از ماژول دیگری ایمپورت شود، مثلاً برای یونیت‌تست آن، کد اسکریپتی نیز به‌طور ناخواسته اجرا خواهد شد."
 
 msgid "This is where using the ``if __name__ == '__main__'`` code block comes in handy. Code within this block won't run unless the module is executed in the top-level environment."
-msgstr ""
+msgstr "اینجاست که استفاده از بلوک کد ``if __name__ == '__main__'`` به کار می‌آید. کد داخل این بلوک اجرا نمی‌شود مگر اینکه ماژول در محیط سطح‌بالا اجرا شود."
 
 msgid "Putting as few statements as possible in the block below ``if __name__ == '__main__'`` can improve code clarity and correctness. Most often, a function named ``main`` encapsulates the program's primary behavior::"
-msgstr ""
+msgstr "قرار دادن کمترین تعداد دستور ممکن در بلوک زیر ``if __name__ == '__main__'`` می‌تواند وضوح و صحت کد را بهبود بخشد. اغلب، یک تابع به نام ``main`` رفتار اصلی برنامه را در خود محصور می‌کند::"
 
 msgid ""
 "# echo.py\n"
@@ -190,9 +193,28 @@ msgid ""
 "if __name__ == '__main__':\n"
 "    sys.exit(main())  # next section explains the use of sys.exit"
 msgstr ""
+"# echo.py\n"
+"\n"
+"import shlex\n"
+"import sys\n"
+"\n"
+"def echo(phrase: str) -> None:\n"
+"   \"\"\"یک پوشش ساختگی برای print.\"\"\"\n"
+"   # برای اهداف نمایشی، می‌توانید تصور کنید که منطق ارزشمندی\n"
+"   # و قابل استفاده‌ی مجددی درون این تابع وجود دارد\n"
+"   print(phrase)\n"
+"\n"
+"def main() -> int:\n"
+"    \"\"\"آرگومان‌های ورودی را به خروجی استاندارد بازتاب می‌دهد\"\"\"\n"
+"    phrase = shlex.join(sys.argv)\n"
+"    echo(phrase)\n"
+"    return 0\n"
+"\n"
+"if __name__ == '__main__':\n"
+"    sys.exit(main())  # بخش بعدی استفاده از sys.exit را توضیح می‌دهد"
 
 msgid "Note that if the module didn't encapsulate code inside the ``main`` function but instead put it directly within the ``if __name__ == '__main__'`` block, the ``phrase`` variable would be global to the entire module.  This is error-prone as other functions within the module could be unintentionally using the global variable instead of a local name.  A ``main`` function solves this problem."
-msgstr ""
+msgstr "توجه داشته باشید که اگر ماژول کد را درون تابع ``main`` محصور نمی‌کرد و به جای آن مستقیماً آن را درون بلوک ``if __name__ == '__main__'`` قرار می‌داد، متغیر ``phrase`` برای کل ماژول سراسری می‌شد.  این امر مستعد خطا است، زیرا ممکن است سایر توابع درون ماژول به‌طور ناخواسته از متغیر سراسری به جای یک نام محلی استفاده کنند.  تابع ``main`` این مشکل را حل می‌کند."
 
 msgid "Using a ``main`` function has the added benefit of the ``echo`` function itself being isolated and importable elsewhere. When ``echo.py`` is imported, the ``echo`` and ``main`` functions will be defined, but neither of them will be called, because ``__name__ != '__main__'``."
 msgstr ""