python-docs-fa/library/asyncio-extending.po at 3.15 · python/python-docs-fa · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Revisto <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-17 13:34+0330\n"
"PO-Revision-Date: 2026-09-14 15:56+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
"X-Generator: Poedit 3.6\n"

msgid "Extending"
msgstr "گسترش"

msgid "The main direction for :mod:`asyncio` extending is writing custom *event loop* classes. Asyncio has helpers that could be used to simplify this task."
msgstr "جهت اصلی گسترش :mod:`asyncio`، نوشتن کلاس‌های سفارشی *حلقه رویداد* است. Asyncio ابزارهای کمکی دارد که می‌توان از آن‌ها برای ساده‌سازی این کار استفاده کرد."

msgid "Third-parties should reuse existing asyncio code with caution, a new Python version is free to break backward compatibility in *internal* part of API."
msgstr "اشخاص ثالث باید با احتیاط از کد asyncio موجود دوباره استفاده کنند؛ یک نسخه جدید پایتون مجاز است سازگاری عقب‌گرد را در بخش *داخلی* API نقض کند."

msgid "Writing a Custom Event Loop"
msgstr "نوشتن یک حلقه رویداد سفارشی"

msgid ":class:`asyncio.AbstractEventLoop` declares very many methods.  Implementing all them from scratch is a tedious job."
msgstr ":class:`asyncio.AbstractEventLoop` تعداد بسیار زیادی متد را اعلام می‌کند. پیاده‌سازی همه‌ی آن‌ها از ابتدا کار خسته‌کننده‌ای است."

msgid "A loop can get many common methods implementation for free by inheriting from :class:`asyncio.BaseEventLoop`."
msgstr "یک حلقه می‌تواند با ارث‌بری از :class:`asyncio.BaseEventLoop`، پیاده‌سازی بسیاری از متدهای رایج را به‌رایگان به دست آورد."

msgid "In turn, the successor should implement a bunch of *private* methods declared but not implemented in :class:`asyncio.BaseEventLoop`."
msgstr "به‌نوبه خود، جانشین باید تعدادی متد *خصوصی* را که در :class:`asyncio.BaseEventLoop` اعلام‌شده‌اند اما پیاده‌سازی‌نشده‌اند، پیاده‌سازی کند."

msgid "For example, ``loop.create_connection()`` checks arguments, resolves DNS addresses, and calls ``loop._make_socket_transport()`` that should be implemented by inherited class. The ``_make_socket_transport()`` method is not documented and is considered as an *internal* API."
msgstr "برای مثال، ``loop.create_connection()`` آرگومان‌ها را بررسی می‌کند، آدرس‌های DNS را حل می‌کند و ``loop._make_socket_transport()`` را فراخوانی می‌کند که باید توسط کلاس مشتق‌شده پیاده‌سازی شود. متد ``_make_socket_transport()`` مستند نشده است و به‌عنوان یک API *داخلی* در نظر گرفته می‌شود."

msgid "Future and Task private constructors"
msgstr "سازنده‌های خصوصی Future و Task"

msgid ":class:`asyncio.Future` and :class:`asyncio.Task` should be never created directly, please use corresponding :meth:`loop.create_future` and :meth:`loop.create_task`, or :func:`asyncio.create_task` factories instead."
msgstr ":class:`asyncio.Future` و :class:`asyncio.Task` را هرگز نباید به‌صورت مستقیم ایجاد کرد؛ لطفاً به‌جای آن‌ها از کارخانه‌های متناظر :meth:`loop.create_future` و :meth:`loop.create_task` یا :func:`asyncio.create_task` استفاده کنید."

msgid "However, third-party *event loops* may *reuse* built-in future and task implementations for the sake of getting a complex and highly optimized code for free."
msgstr "با این حال، *حلقه‌های رویداد* شخص ثالث ممکن است برای به‌دست آوردن کدی پیچیده و بسیار بهینه‌شده به‌صورت رایگان، از پیاده‌سازی‌های توکار future و task *دوباره استفاده کنند*."

msgid "For this purpose the following, *private* constructors are listed:"
msgstr "برای این منظور، سازنده‌های *خصوصی* زیر فهرست شده‌اند:"

msgid "Create a built-in future instance."
msgstr "یک نمونه‌ی فیوچر توکار ایجاد کنید."

msgid "*loop* is an optional event loop instance."
msgstr "*loop* نمونه‌ای اختیاری از حلقه رویداد است."

msgid "Create a built-in task instance."
msgstr "یک نمونه از وظیفه توکار ایجاد کنید."

msgid "*loop* is an optional event loop instance. The rest of arguments are described in :meth:`loop.create_task` description."
msgstr "*loop* یک نمونه اختیاری از حلقه رویداد است. سایر آرگومان‌ها در توضیحات :meth:`loop.create_task` شرح داده شده‌اند."

msgid "*context* argument is added."
msgstr "آرگومان *context* اضافه شد."

msgid "Task lifetime support"
msgstr "پشتیبانی از طول عمر Task"

msgid "A third party task implementation should call the following functions to keep a task visible by :func:`asyncio.all_tasks` and :func:`asyncio.current_task`:"
msgstr "یک پیاده‌سازی وظیفه شخص ثالث باید توابع زیر را فراخوانی کند تا یک وظیفه برای :func:`asyncio.all_tasks` و :func:`asyncio.current_task` قابل مشاهده باقی بماند:"

msgid "Register a new *task* as managed by *asyncio*."
msgstr "یک *وظیفه* جدید را به‌عنوان مدیریت‌شده توسط *asyncio* ثبت کنید."

msgid "Call the function from a task constructor."
msgstr "تابع را از یک سازنده‌ی وظیفه فراخوانی کنید."

msgid "Unregister a *task* from *asyncio* internal structures."
msgstr "ثبت یک *task* را از ساختارهای داخلی *asyncio* حذف کنید."

msgid "The function should be called when a task is about to finish."
msgstr "این تابع باید هنگامی فراخوانی شود که یک وظیفه در آستانه‌ی پایان قرار دارد."

msgid "Switch the current task to the *task* argument."
msgstr "وظیفه جاری را به آرگومان *task* تغییر دهید."

msgid "Call the function just before executing a portion of embedded *coroutine* (:meth:`coroutine.send` or :meth:`coroutine.throw`)."
msgstr "تابع را درست پیش از اجرای بخشی از *هم‌روال* تعبیه‌شده فراخوانی کنید (:meth:`coroutine.send` یا :meth:`coroutine.throw`)."

msgid "Switch the current task back from *task* to ``None``."
msgstr "وظیفه‌ی جاری را از *task* به ``None`` بازمی‌گرداند."

msgid "Call the function just after :meth:`coroutine.send` or :meth:`coroutine.throw` execution."
msgstr "تابع را درست پس از اجرای :meth:`coroutine.send` یا :meth:`coroutine.throw` فراخوانی کنید."