Translate parts of stdlib

Author: sepehr-rs

tutorial/stdlib.po

@@ -12,7 +12,7 @@ msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2026-07-25 12:59+0330\n"
-"PO-Revision-Date: 2026-07-31 13:23+0330\n"
+"PO-Revision-Date: 2026-08-01 16:31+0330\n"
 "Last-Translator: Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025\n"
 "Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
 "fa/)\n"
@@ -25,17 +25,17 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:5
 msgid "Brief tour of the standard library"
-msgstr ""
+msgstr "نگاهی کوتاه به کتابخانهٔ استاندارد"
 
 #: ../../tutorial/stdlib.rst:11
 msgid "Operating system interface"
-msgstr ""
+msgstr "رابط سیستم‌عامل"
 
 #: ../../tutorial/stdlib.rst:13
 msgid ""
 "The :mod:`os` module provides dozens of functions for interacting with the "
 "operating system::"
-msgstr ""
+msgstr "ماژول :mod:`os` ده‌ها تابع برای تعامل با سیستم‌عامل فراهم می‌کند::"
 
 #: ../../tutorial/stdlib.rst:16
 msgid ""
@@ -59,12 +59,17 @@ msgid ""
 "This will keep :func:`os.open` from shadowing the built-in :func:`open` "
 "function which operates much differently."
 msgstr ""
+"حتماً از سبک ``import os`` به‌جای ``from os import *`` استفاده کنید. این کار "
+"باعث می‌شود :func:`os.open` روی تابع داخلی :func:`open` که عملکرد کاملاً "
+"متفاوتی دارد، سایه نیندازد."
 
 #: ../../tutorial/stdlib.rst:29
 msgid ""
 "The built-in :func:`dir` and :func:`help` functions are useful as "
 "interactive aids for working with large modules like :mod:`os`::"
 msgstr ""
+"توابع داخلی :func:`dir` و :func:`help` به‌عنوان ابزارهای تعاملی برای کار با "
+"ماژول‌های بزرگی مانند :mod:`os` مفید هستند::"
 
 #: ../../tutorial/stdlib.rst:32
 msgid ""
@@ -85,6 +90,8 @@ msgid ""
 "For daily file and directory management tasks, the :mod:`shutil` module "
 "provides a higher level interface that is easier to use::"
 msgstr ""
+"برای کارهای روزمرهٔ مدیریت فایل‌ها و پوشه‌ها، ماژول :mod:`shutil` یک رابط سطح "
+"بالاتر ارائه می‌دهد که استفاده از آن ساده‌تر است::"
 
 #: ../../tutorial/stdlib.rst:41
 msgid ""
@@ -102,13 +109,15 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:51
 msgid "File wildcards"
-msgstr ""
+msgstr "الگوهای عام فایل"
 
 #: ../../tutorial/stdlib.rst:53
 msgid ""
 "The :mod:`glob` module provides a function for making file lists from "
 "directory wildcard searches::"
 msgstr ""
+"ماژول :mod:`glob` تابعی برای ساخت فهرستی از فایل‌ها با استفاده از جستجوهای "
+"الگوی عام در پوشه‌ها فراهم می‌کند::"
 
 #: ../../tutorial/stdlib.rst:56
 msgid ""
@@ -122,14 +131,17 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:64
 msgid "Command-line arguments"
-msgstr ""
+msgstr "آرگومان‌های خط فرمان"
 
 #: ../../tutorial/stdlib.rst:66
 msgid ""
 "Common utility scripts often need to process command line arguments. These "
 "arguments are stored in the :mod:`sys` module's *argv* attribute as a list.  "
 "For instance, let's take the following :file:`demo.py` file::"
 msgstr ""
+"اسکریپت‌های کاربردی معمولاً نیاز دارند آرگومان‌های خط فرمان را پردازش کنند. این "
+"آرگومان‌ها در ویژگی *argv* ماژول :mod:`sys` به‌صورت یک فهرست ذخیره می‌شوند. "
+"برای مثال، فایل :file:`demo.py` زیر را در نظر بگیرید::"
 
 #: ../../tutorial/stdlib.rst:70
 msgid ""
@@ -146,6 +158,7 @@ msgid ""
 "Here is the output from running ``python demo.py one two three`` at the "
 "command line::"
 msgstr ""
+"خروجی اجرای ``python demo.py one two three`` در خط فرمان به شکل زیر است::"
 
 #: ../../tutorial/stdlib.rst:77
 msgid "['demo.py', 'one', 'two', 'three']"
@@ -157,6 +170,9 @@ msgid ""
 "process command line arguments.  The following script extracts one or more "
 "filenames and an optional number of lines to be displayed::"
 msgstr ""
+"ماژول :mod:`argparse` سازوکار پیشرفته‌تری برای پردازش آرگومان‌های خط فرمان "
+"فراهم می‌کند. اسکریپت زیر یک یا چند نام فایل و همچنین تعداد اختیاری خطوطی که "
+"باید نمایش داده شوند را استخراج می‌کند::"
 
 #: ../../tutorial/stdlib.rst:83
 msgid ""
@@ -186,17 +202,23 @@ msgid ""
 "beta.txt``, the script sets ``args.lines`` to ``5`` and ``args.filenames`` "
 "to ``['alpha.txt', 'beta.txt']``."
 msgstr ""
+"هنگامی که این اسکریپت با دستور ``python top.py --lines=5 alpha.txt "
+"beta.txt`` در خط فرمان اجرا شود، اسکریپت مقدار ``args.lines`` را برابر ``5`` "
+"و مقدار ``args.filenames`` را برابر ``['alpha.txt', 'beta.txt']`` قرار می‌دهد."
 
 #: ../../tutorial/stdlib.rst:101
 msgid "Error output redirection and program termination"
-msgstr ""
+msgstr "تغییر مسیر خروجی خطا و پایان دادن به برنامه"
 
 #: ../../tutorial/stdlib.rst:103
 msgid ""
 "The :mod:`sys` module also has attributes for *stdin*, *stdout*, and "
 "*stderr*. The latter is useful for emitting warnings and error messages to "
 "make them visible even when *stdout* has been redirected::"
 msgstr ""
+"ماژول :mod:`sys` همچنین ویژگی‌هایی برای *stdin*، *stdout* و *stderr* دارد. "
+"مورد آخر برای ارسال هشدارها و پیام‌های خطا مفید است، زیرا حتی زمانی که "
+"*stdout* تغییر مسیر داده شده باشد، این پیام‌ها همچنان قابل مشاهده خواهند بود::"
 
 #: ../../tutorial/stdlib.rst:107
 msgid ""
@@ -209,17 +231,21 @@ msgstr ""
 #: ../../tutorial/stdlib.rst:110
 msgid "The most direct way to terminate a script is to use ``sys.exit()``."
 msgstr ""
+"مستقیم‌ترین راه برای پایان دادن به یک اسکریپت استفاده از ``sys.exit()`` است."
 
 #: ../../tutorial/stdlib.rst:116
 msgid "String pattern matching"
-msgstr ""
+msgstr "تطبیق الگوهای رشته‌ای"
 
 #: ../../tutorial/stdlib.rst:118
 msgid ""
 "The :mod:`re` module provides regular expression tools for advanced string "
 "processing. For complex matching and manipulation, regular expressions offer "
 "succinct, optimized solutions::"
 msgstr ""
+"ماژول :mod:`re` ابزارهای عبارت باقاعده را برای پردازش پیشرفتهٔ رشته‌ها فراهم "
+"می‌کند. برای تطبیق و تغییرات پیچیده، عبارت‌های باقاعده راه‌حل‌هایی کوتاه و بهینه "
+"ارائه می‌دهند::"
 
 #: ../../tutorial/stdlib.rst:122
 msgid ""
@@ -240,6 +266,8 @@ msgid ""
 "When only simple capabilities are needed, string methods are preferred "
 "because they are easier to read and debug::"
 msgstr ""
+"وقتی فقط به قابلیت‌های ساده نیاز است، استفاده از متدهای رشته‌ای ترجیح داده "
+"می‌شود، زیرا خواندن و اشکال‌زدایی آن‌ها آسان‌تر است::"
 
 #: ../../tutorial/stdlib.rst:131
 msgid ""
@@ -251,13 +279,15 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:138
 msgid "Mathematics"
-msgstr ""
+msgstr "ریاضیات"
 
 #: ../../tutorial/stdlib.rst:140
 msgid ""
 "The :mod:`math` module gives access to the underlying C library functions "
 "for floating-point math::"
 msgstr ""
+"ماژول :mod:`math` دسترسی به توابع کتابخانهٔ C زیرین برای محاسبات ممیز شناور "
+"را فراهم می‌کند::"
 
 #: ../../tutorial/stdlib.rst:143
 msgid ""
@@ -275,7 +305,7 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:149
 msgid "The :mod:`random` module provides tools for making random selections::"
-msgstr ""
+msgstr "ماژول :mod:`random` ابزارهایی برای انتخاب‌های تصادفی فراهم می‌کند::"
 
 #: ../../tutorial/stdlib.rst:151
 msgid ""
@@ -304,6 +334,8 @@ msgid ""
 "The :mod:`statistics` module calculates basic statistical properties (the "
 "mean, median, variance, etc.) of numeric data::"
 msgstr ""
+"ماژول :mod:`statistics` ویژگی‌های آماری پایه (مانند میانگین، میانه، واریانس و "
+"غیره) داده‌های عددی را محاسبه می‌کند::"
 
 #: ../../tutorial/stdlib.rst:164
 msgid ""
@@ -330,6 +362,7 @@ msgid ""
 "The SciPy project <https://scipy.org> has many other modules for numerical "
 "computations."
 msgstr ""
+"پروژهٔ SciPy <https://scipy.org> ماژول‌های بسیار دیگری برای محاسبات عددی دارد."
 
 #: ../../tutorial/stdlib.rst:179
 msgid "Internet access"
@@ -341,6 +374,9 @@ msgid ""
 "internet protocols. Two of the simplest are :mod:`urllib.request` for "
 "retrieving data from URLs and :mod:`smtplib` for sending mail::"
 msgstr ""
+"تعدادی ماژول برای دسترسی به اینترنت و پردازش پروتکل‌های اینترنتی وجود دارد. "
+"دو مورد از ساده‌ترین آن‌ها :mod:`urllib.request` برای دریافت داده از URLها "
+"و :mod:`smtplib` برای ارسال ایمیل هستند::"
 
 #: ../../tutorial/stdlib.rst:185
 msgid ""
@@ -385,10 +421,11 @@ msgstr ""
 #: ../../tutorial/stdlib.rst:204
 msgid "(Note that the second example needs a mailserver running on localhost.)"
 msgstr ""
+"(توجه کنید که مثال دوم به یک سرور ایمیل در حال اجرا روی localhost نیاز دارد.)"
 
 #: ../../tutorial/stdlib.rst:210
 msgid "Dates and times"
-msgstr ""
+msgstr "تاریخ‌ها و زمان‌ها"
 
 #: ../../tutorial/stdlib.rst:212
 msgid ""
@@ -398,6 +435,11 @@ msgid ""
 "for output formatting and manipulation.  The module also supports objects "
 "that are timezone aware. ::"
 msgstr ""
+"ماژول :mod:`datetime` کلاس‌هایی برای کار با تاریخ‌ها و زمان‌ها به روش‌های ساده و "
+"پیچیده فراهم می‌کند. با اینکه محاسبات مربوط به تاریخ و زمان پشتیبانی می‌شوند، "
+"تمرکز اصلی پیاده‌سازی بر استخراج کارآمد اعضا برای قالب‌بندی خروجی و تغییرات "
+"است. این ماژول همچنین از اشیایی که نسبت به منطقهٔ زمانی آگاه هستند پشتیبانی "
+"می‌کند.::"
 
 #: ../../tutorial/stdlib.rst:218
 msgid ""
@@ -431,7 +473,7 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:236
 msgid "Data compression"
-msgstr ""
+msgstr "فشرده‌سازی داده‌ها"
 
 #: ../../tutorial/stdlib.rst:238
 msgid ""
@@ -440,6 +482,9 @@ msgid ""
 "including: :mod:`zlib`, :mod:`gzip`, :mod:`bz2`, :mod:`lzma`, :mod:`zipfile` "
 "and :mod:`tarfile`. ::"
 msgstr ""
+"قالب‌های رایج بایگانی و فشرده‌سازی داده مستقیماً توسط ماژول‌هایی "
+"مانند :mod:`zlib`، :mod:`gzip`، :mod:`bz2`، :mod:`lzma`، :mod:`zipfile` "
+"و :mod:`tarfile` پشتیبانی می‌شوند. ::"
 
 #: ../../tutorial/stdlib.rst:242
 msgid ""
@@ -469,14 +514,17 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:258
 msgid "Performance measurement"
-msgstr ""
+msgstr "اندازه‌گیری کارایی"
 
 #: ../../tutorial/stdlib.rst:260
 msgid ""
 "Some Python users develop a deep interest in knowing the relative "
 "performance of different approaches to the same problem. Python provides a "
 "measurement tool that answers those questions immediately."
 msgstr ""
+"برخی کاربران پایتون علاقهٔ زیادی دارند که کارایی نسبی روش‌های مختلف برای حل یک "
+"مسئلهٔ یکسان را بدانند. پایتون ابزاری برای اندازه‌گیری فراهم می‌کند که بلافاصله "
+"به این پرسش‌ها پاسخ می‌دهد."
 
 #: ../../tutorial/stdlib.rst:264
 msgid ""
@@ -485,6 +533,9 @@ msgid ""
 "The :mod:`timeit` module quickly demonstrates a modest performance "
 "advantage::"
 msgstr ""
+"برای مثال، ممکن است وسوسه شوید که به‌جای روش سنتی جابه‌جایی آرگومان‌ها، از "
+"قابلیت بسته‌بندی و بازکردن تاپل‌ها استفاده کنید. ماژول :mod:`timeit` به‌سرعت یک "
+"برتری کوچک در کارایی را نشان می‌دهد::"
 
 #: ../../tutorial/stdlib.rst:268
 msgid ""
@@ -506,17 +557,23 @@ msgid ""
 "and :mod:`pstats` modules provide tools for identifying time critical "
 "sections in larger blocks of code."
 msgstr ""
+"برخلاف دقت بسیار بالای :mod:`timeit` در اندازه‌گیری‌های کوچک، "
+"ماژول‌های :mod:`profile` و :mod:`pstats` ابزارهایی برای شناسایی بخش‌های حساس "
+"از نظر زمانی در قطعه‌کدهای بزرگ‌تر فراهم می‌کنند."
 
 #: ../../tutorial/stdlib.rst:282
 msgid "Quality control"
-msgstr ""
+msgstr "کنترل کیفیت"
 
 #: ../../tutorial/stdlib.rst:284
 msgid ""
 "One approach for developing high quality software is to write tests for each "
 "function as it is developed and to run those tests frequently during the "
 "development process."
 msgstr ""
+"یکی از روش‌ها برای توسعهٔ نرم‌افزار با کیفیت بالا این است که برای هر تابع، "
+"هم‌زمان با توسعهٔ آن، آزمون‌هایی نوشته شود و این آزمون‌ها در طول فرایند توسعه "
+"به‌طور مکرر اجرا شوند."
 
 #: ../../tutorial/stdlib.rst:288
 msgid ""
@@ -527,6 +584,12 @@ msgid ""
 "example and it allows the doctest module to make sure the code remains true "
 "to the documentation::"
 msgstr ""
+"ماژول :mod:`doctest` ابزاری برای پیمایش یک ماژول و اعتبارسنجی آزمون‌هایی که "
+"در رشته‌های مستندات (docstring) برنامه قرار داده شده‌اند فراهم می‌کند. ساخت "
+"آزمون‌ها به سادگیِ کپی‌کردن یک فراخوانی معمولی به همراه نتیجهٔ آن در docstring "
+"است. این کار مستندات را بهتر می‌کند، زیرا نمونه‌ای برای کاربر فراهم می‌کند و "
+"همچنین به ماژول doctest اجازه می‌دهد اطمینان حاصل کند که کد همچنان مطابق با "
+"مستندات عمل می‌کند::"
 
 #: ../../tutorial/stdlib.rst:295
 msgid ""
@@ -558,6 +621,8 @@ msgid ""
 "module, but it allows a more comprehensive set of tests to be maintained in "
 "a separate file::"
 msgstr ""
+"ماژول :mod:`unittest` به اندازهٔ :mod:`doctest` ساده و بدون زحمت نیست، اما "
+"اجازه می‌دهد مجموعه‌ای جامع‌تر از آزمون‌ها در یک فایل جداگانه نگهداری شود::"
 
 #: ../../tutorial/stdlib.rst:310
 msgid ""
@@ -591,14 +656,17 @@ msgstr ""
 
 #: ../../tutorial/stdlib.rst:328
 msgid "Batteries included"
-msgstr ""
+msgstr "همه‌چیز آماده درون جعبه"
 
 #: ../../tutorial/stdlib.rst:330
 msgid ""
 "Python has a \"batteries included\" philosophy.  This is best seen through "
 "the sophisticated and robust capabilities of its larger packages. For "
 "example:"
 msgstr ""
+"پایتون از فلسفهٔ «همه‌چیز آماده درون جعبه» (batteries included) پیروی می‌کند. "
+"این موضوع را می‌توان به بهترین شکل در قابلیت‌های پیشرفته و قدرتمند بسته‌های "
+"بزرگ‌تر آن مشاهده کرد. برای مثال:"
 
 #: ../../tutorial/stdlib.rst:333
 msgid ""