glossary.po

# 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:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Alireza Feyzabadi Farahani, 2025
# Danial Behzadi <dani.behzi@ubuntu.com>, 2025
# taha haghgoo, 2025
# Rafael Fontenelle <rffontenelle@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-10-27 04:16+0000\n"
"PO-Revision-Date: 2026-08-26 08:03+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 "Glossary"
msgstr "واژه‌نامه"

msgid "``>>>``"
msgstr "``>>>``"

msgid "The default Python prompt of the :term:`interactive` shell.  Often seen for code examples which can be executed interactively in the interpreter."
msgstr "اعلان پیش‌فرض پایتون در پوسته‌ی :term:`تعاملی <interactive>`. اغلب برای نمونه‌های کدی دیده می‌شود که می‌توان آن‌ها را به‌صورت تعاملی در مفسر اجرا کرد."

msgid "``...``"
msgstr "``...``"

msgid "Can refer to:"
msgstr "می‌تواند به موارد زیر اشاره کند:"

msgid "The default Python prompt of the :term:`interactive` shell when entering the code for an indented code block, when within a pair of matching left and right delimiters (parentheses, square brackets, curly braces or triple quotes), or after specifying a decorator."
msgstr "اعلان پیش‌فرض پایتون در پوسته‌ی :term:`تعاملی <interactive>` هنگام وارد کردن کد برای یک بلوک کد تورفته، زمانی که درون یک جفت جداکننده‌ی چپ و راست متناظر (پرانتزها، کروشه‌ها، آکولادها یا علامت‌های نقل‌قول سه‌گانه) قرار دارید، یا پس از مشخص کردن یک دکوراتور."

msgid "The three dots form of the :ref:`Ellipsis <bltin-ellipsis-object>` object."
msgstr "شکل سه‌نقطه‌ای شیء :ref:`Ellipsis <bltin-ellipsis-object>`."

msgid "abstract base class"
msgstr "کلاس پایه‌ی انتزاعی"

msgid "Abstract base classes complement :term:`duck-typing` by providing a way to define interfaces when other techniques like :func:`hasattr` would be clumsy or subtly wrong (for example with :ref:`magic methods <special-lookup>`).  ABCs introduce virtual subclasses, which are classes that don't inherit from a class but are still recognized by :func:`isinstance` and :func:`issubclass`; see the :mod:`abc` module documentation.  Python comes with many built-in ABCs for data structures (in the :mod:`collections.abc` module), numbers (in the :mod:`numbers` module), streams (in the :mod:`io` module), import finders and loaders (in the :mod:`importlib.abc` module).  You can create your own ABCs with the :mod:`abc` module."
msgstr "کلاس‌های پایه‌ی انتزاعی با فراهم کردن روشی برای تعریف رابط‌ها، زمانی که تکنیک‌های دیگری مانند :func:`hasattr` دست‌وپاگیر یا به‌طور ضمنی نادرست هستند (برای مثال با :ref:`متدهای جادویی <special-lookup>`)، :term:`نوع‌دهی اردکی <duck-typing>` را تکمیل می‌کنند. ABCها زیرکلاس‌های مجازی معرفی می‌کنند، که کلاس‌هایی هستند که از یک کلاس دیگر به ارث نمی‌برند اما همچنان توسط :func:`isinstance` و :func:`issubclass` شناخته می‌شوند؛ مستندات ماژول :mod:`abc` را ببینید. پایتون همراه با ABCهای توکار بسیاری برای ساختارهای داده (در ماژول :mod:`collections.abc`)، اعداد (در ماژول :mod:`numbers`)، جریان‌ها (در ماژول :mod:`io`)، یابنده‌ها و بارگذارهای ایمپورت (در ماژول :mod:`importlib.abc`) ارائه می‌شود. شما می‌توانید ABCهای سفارشی خود را با ماژول :mod:`abc` ایجاد کنید."

msgid "annotate function"
msgstr "توابع حاشیه‌گذاری"

msgid "A callable that can be called to retrieve the :term:`annotations <annotation>` of an object. Annotate functions are usually :term:`functions <function>`, automatically generated as the :attr:`~object.__annotate__` attribute of functions, classes, and modules. Annotate functions are a subset of :term:`evaluate functions <evaluate function>`."
msgstr "فراخوانی‌پذیری که می‌توان آن را برای بازیابی :term:`حاشیه‌گذاری <annotation>` یک شیء فراخوانی کرد. توابع حاشیه‌گذاری معمولاً :term:`توابعی <function>` هستند که به‌صورت خودکار به‌عنوان ویژگی :attr:`~object.__annotate__` توابع، کلاس‌ها و ماژول‌ها تولید می‌شوند. توابع حاشیه‌گذاری زیرمجموعه‌ای از :term:`توابع ارزیابی <evaluate function>` هستند."

msgid "annotation"
msgstr "حاشیه‌گذاری"

msgid "A label associated with a variable, a class attribute or a function parameter or return value, used by convention as a :term:`type hint`."
msgstr "برچسبی مرتبط با یک متغیر، یک ویژگی کلاس، یا یک پارامتر تابع یا مقدار بازگشتی، که طبق قرارداد به‌عنوان یک :term:`راهنمای نوع <type hint>` استفاده می‌شود."

msgid "Annotations of local variables cannot be accessed at runtime, but annotations of global variables, class attributes, and functions can be retrieved by calling :func:`annotationlib.get_annotations` on modules, classes, and functions, respectively."
msgstr "حاشیه‌گذاری‌های متغیرهای محلی را نمی‌توان در زمان ران‌تایم دسترسی کرد، اما حاشیه‌گذاری‌های متغیرهای سراسری، ویژگی‌های کلاس و توابع را می‌توان با فراخوانی :func:`annotationlib.get_annotations` به‌ترتیب روی ماژول‌ها، کلاس‌ها و توابع بازیابی کرد."

msgid "See :term:`variable annotation`, :term:`function annotation`, :pep:`484`, :pep:`526`, and :pep:`649`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations."
msgstr "همچنین به :term:`حاشیه‌نویسی متغیر <variable annotation>`، :term:`حاشیه‌گذاری تابع <function annotation>`، :pep:`484`، :pep:`526` و :pep:`649` مراجعه کنید که این قابلیت را توضیح می‌دهند. همچنین برای بهترین روش‌ها در کار با حاشیه‌گذاری‌ها، :ref:`annotations-howto` را ببینید."

msgid "argument"
msgstr "آرگومان"

msgid "A value passed to a :term:`function` (or :term:`method`) when calling the function.  There are two kinds of argument:"
msgstr "مقداری که هنگام فراخوانی یک :term:`تابع <function>` (یا :term:`متد <method>`) به آن تابع ارسال می‌شود. دو نوع آرگومان وجود دارد:"

msgid ":dfn:`keyword argument`: an argument preceded by an identifier (e.g. ``name=``) in a function call or passed as a value in a dictionary preceded by ``**``.  For example, ``3`` and ``5`` are both keyword arguments in the following calls to :func:`complex`::"
msgstr ":dfn:`keyword argument`: آرگومانی که در فراخوانی تابع با یک شناسه (برای مثال ``name=``) پیش از آن قرار گرفته است، یا به‌عنوان مقداری در یک دیکشنری که پیش از آن ``**`` آمده است، ارسال می‌شود. برای مثال، ``3`` و ``5`` هر دو در فراخوانی‌های زیر از :func:`complex` آرگومان کلیدواژه‌ای هستند::"

msgid ""
"complex(real=3, imag=5)\n"
"complex(**{'real': 3, 'imag': 5})"
msgstr ""
"complex(real=3, imag=5)\n"
"complex(**{'real': 3, 'imag': 5})"

msgid ":dfn:`positional argument`: an argument that is not a keyword argument. Positional arguments can appear at the beginning of an argument list and/or be passed as elements of an :term:`iterable` preceded by ``*``. For example, ``3`` and ``5`` are both positional arguments in the following calls::"
msgstr ":dfn:`positional argument`: آرگومانی که آرگومان کلیدواژه‌ای نیست. آرگومان‌های جایگاهی می‌توانند در ابتدای یک فهرست آرگومان ظاهر شوند و/یا به‌عنوان عناصر یک :term:`پیمایش‌پذیر <iterable>` که پیش از آن ``*`` آمده است، ارسال شوند. برای مثال، ``3`` و ``5`` هر دو در فراخوانی‌های زیر آرگومان جایگاهی هستند::"

msgid ""
"complex(3, 5)\n"
"complex(*(3, 5))"
msgstr ""
"complex(3, 5)\n"
"complex(*(3, 5))"

msgid "Arguments are assigned to the named local variables in a function body. See the :ref:`calls` section for the rules governing this assignment. Syntactically, any expression can be used to represent an argument; the evaluated value is assigned to the local variable."
msgstr "آرگومان‌ها به متغیرهای محلی نام‌گذاری‌شده در بدنه‌ی یک تابع اختصاص داده می‌شوند. برای قوانین حاکم بر این تخصیص، بخش :ref:`calls` را ببینید. از نظر سینتکس، هر عبارتی می‌تواند برای نمایش یک آرگومان استفاده شود؛ مقدار ارزیابی‌شده به متغیر محلی اختصاص داده می‌شود."

msgid "See also the :term:`parameter` glossary entry, the FAQ question on :ref:`the difference between arguments and parameters <faq-argument-vs-parameter>`, and :pep:`362`."
msgstr "همچنین به ورودی واژه‌نامه‌ای :term:`پارامتر <parameter>`، پرسش متداول درباره‌ی :ref:`تفاوت بین آرگومان‌ها و پارامترها <faq-argument-vs-parameter>` و :pep:`362` مراجعه کنید."

msgid "asynchronous context manager"
msgstr "مدیر زمینه‌ی ناهمگام"

msgid "An object which controls the environment seen in an :keyword:`async with` statement by defining :meth:`~object.__aenter__` and :meth:`~object.__aexit__` methods.  Introduced by :pep:`492`."
msgstr "شی‌ءای که با تعریف متدهای :meth:`~object.__aenter__` و :meth:`~object.__aexit__`، محیط مشاهده‌شده در یک دستور :keyword:`async with` را کنترل می‌کند. این قابلیت توسط :pep:`492` معرفی شد."

msgid "asynchronous generator"
msgstr "تولیدگر ناهمگام"

msgid "Informally used to mean either an :term:`asynchronous generator function` or an :term:`asynchronous generator iterator`, depending on context.  The formal terms :term:`asynchronous generator function` and :term:`asynchronous generator iterator` are uncommon in practice; \"asynchronous generator\" alone is almost always sufficient."
msgstr "به‌صورت غیررسمی برای اشاره به یک :term:`تابع تولیدگر ناهمگام <asynchronous generator function>` یا یک :term:`پیمایش‌گر تولیدگر ناهمگام <asynchronous generator iterator>`، بسته به زمینه، استفاده می‌شود. اصطلاحات رسمی :term:`تابع تولیدگر ناهمگام <asynchronous generator function>` و :term:`پیمایش‌گر تولیدگر ناهمگام <asynchronous generator iterator>` در عمل کمتر استفاده می‌شوند؛ «تولیدگر ناهمگام» به‌تنهایی تقریباً همیشه کافی است."

msgid "asynchronous generator function"
msgstr "تابع تولیدگر ناهمگام"

msgid "A function which returns an :term:`asynchronous generator iterator`. It looks like a coroutine function defined with :keyword:`async def` except that it contains :keyword:`yield` expressions for producing a series of values usable in an :keyword:`async for` loop.  See :pep:`525`."
msgstr "تابعی که یک :term:`پیمایش‌گر تولیدگر ناهمگام <asynchronous generator iterator>` بازمی‌گرداند. این تابع شبیه یک تابع هم‌روال که با :keyword:`async def` تعریف شده است به نظر می‌رسد، با این تفاوت که شامل عبارت‌های :keyword:`yield` برای تولید مجموعه‌ای از مقادیر قابل استفاده در یک حلقه‌ی :keyword:`async for` است. :pep:`525` را ببینید."

msgid "An asynchronous generator function may contain :keyword:`await` expressions as well as :keyword:`async for`, and :keyword:`async with` statements."
msgstr "یک تابع تولیدگر ناهمگام ممکن است علاوه بر عبارت‌های :keyword:`async for` و دستورهای :keyword:`async with`، شامل عبارت‌های :keyword:`await` نیز باشد."

msgid "asynchronous generator iterator"
msgstr "پیمایش‌گر تولیدگر ناهمگام"

msgid "An object created by an :term:`asynchronous generator function`."
msgstr "شی‌ءای که توسط یک :term:`تابع تولیدگر ناهمگام <asynchronous generator function>` ایجاد می‌شود."

msgid "This is an :term:`asynchronous iterator` which when called using the :meth:`~object.__anext__` method returns an awaitable object which will execute the body of the asynchronous generator function until the next :keyword:`yield` expression."
msgstr "این یک :term:`پیمایش‌گر ناهمگام <asynchronous iterator>` است که هنگام فراخوانی با استفاده از متد :meth:`~object.__anext__`، یک شیء awaitable بازمی‌گرداند که بدنه‌ی تابع تولیدگر ناهمگام را تا عبارت :keyword:`yield` بعدی اجرا خواهد کرد."

msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements).  When the *asynchronous generator iterator* effectively resumes with another awaitable returned by :meth:`~object.__anext__`, it picks up where it left off.  See :pep:`492` and :pep:`525`."
msgstr "هر :keyword:`yield` پردازش را به‌طور موقت متوقف می‌کند و وضعیت اجرا (شامل متغیرهای محلی و دستورهای try در انتظار) را به خاطر می‌سپارد. هنگامی که *پیمایش‌گر تولیدگر ناهمگام* عملاً با یک شیء awaitable دیگر که توسط :meth:`~object.__anext__` بازگردانده شده است ادامه می‌یابد، از همان نقطه‌ای که متوقف شده بود ادامه می‌دهد. :pep:`492` و :pep:`525` را ببینید."

msgid "asynchronous iterable"
msgstr "پیمایش‌پذیر ناهمگام"

msgid "An object, that can be used in an :keyword:`async for` statement. Must return an :term:`asynchronous iterator` from its :meth:`~object.__aiter__` method.  Introduced by :pep:`492`."
msgstr "شی‌ءای که می‌تواند در یک دستور :keyword:`async for` استفاده شود. باید از متد :meth:`~object.__aiter__` خود یک :term:`پیمایش‌گر ناهمگام <asynchronous iterator>` بازگرداند. این قابلیت توسط :pep:`492` معرفی شد."

msgid "asynchronous iterator"
msgstr "پیمایش‌گر ناهمگام"

msgid "An object that implements the :meth:`~object.__aiter__` and :meth:`~object.__anext__` methods.  :meth:`~object.__anext__` must return an :term:`awaitable` object. :keyword:`async for` resolves the awaitables returned by an asynchronous iterator's :meth:`~object.__anext__` method until it raises a :exc:`StopAsyncIteration` exception.  Introduced by :pep:`492`."
msgstr "شی‌ءای که متدهای :meth:`~object.__aiter__` و :meth:`~object.__anext__` را پیاده‌سازی می‌کند. :meth:`~object.__anext__` باید یک شیء :term:`awaitable <awaitable>` بازگرداند. :keyword:`async for` اشیای awaitable بازگردانده‌شده توسط متد :meth:`~object.__anext__` یک پیمایش‌گر ناهمگام را تا زمانی که یک استثنای :exc:`StopAsyncIteration` پرتاب شود، حل می‌کند. این قابلیت توسط :pep:`492` معرفی شد."

msgid "atomic operation"
msgstr "عملیات اتمی"

msgid "An operation that appears to execute as a single, indivisible step: no other thread can observe it half-done, and its effects become visible all at once.  Python does not guarantee that high-level statements are atomic (for example, ``x += 1`` performs multiple bytecode operations and is not atomic).  Atomicity is only guaranteed where explicitly documented.  See also :term:`race condition` and :term:`data race`."
msgstr "عملیاتی که به نظر می‌رسد به‌عنوان یک گام واحد و تقسیم‌ناپذیر اجرا می‌شود: هیچ نخ دیگری نمی‌تواند اجرای ناقص آن را مشاهده کند و اثرات آن یکباره قابل مشاهده می‌شوند. پایتون تضمین نمی‌کند که دستورهای سطح بالا اتمی باشند (برای مثال، ``x += 1`` چندین عملیات بایت‌کد انجام می‌دهد و اتمی نیست). اتمی بودن فقط در مواردی تضمین می‌شود که به‌صراحت مستند شده باشند. همچنین :term:`شرط رقابت <race condition>` و :term:`رقابت داده <data race>` را ببینید."

msgid "attached thread state"
msgstr "وضعیت نخ متصل"

msgid "A :term:`thread state` that is active for the current OS thread."
msgstr "یک :term:`وضعیت نخ اجرایی <thread state>` که برای نخ فعلی سیستم‌عامل فعال است."

msgid "When a :term:`thread state` is attached, the OS thread has access to the full Python C API and can safely invoke the bytecode interpreter."
msgstr "هنگامی که یک :term:`وضعیت نخ اجرایی <thread state>` متصل است، نخ سیستم‌عامل به تمام API زبان C پایتون دسترسی دارد و می‌تواند به‌طور ایمن مفسر بایت‌کد را فراخوانی کند."

msgid "Unless a function explicitly notes otherwise, attempting to call the C API without an attached thread state will result in a fatal error or undefined behavior.  A thread state can be attached and detached explicitly by the user through the C API, or implicitly by the runtime, including during blocking C calls and by the bytecode interpreter in between calls."
msgstr "مگر این‌که یک تابع به‌طور صریح خلاف آن را ذکر کند، تلاش برای فراخوانی API زبان C بدون یک وضعیت نخ متصل، به یک خطای مهلک یا رفتار تعریف‌نشده منجر خواهد شد. یک وضعیت نخ می‌تواند به‌صورت صریح توسط کاربر از طریق API زبان C متصل و جدا شود، یا به‌صورت ضمنی توسط ران‌تایم، از جمله در طول فراخوانی‌های C مسدودکننده و توسط مفسر بایت‌کد در بین فراخوانی‌ها، مدیریت شود."

msgid "On most builds of Python, having an attached thread state implies that the caller holds the :term:`GIL` for the current interpreter, so only one OS thread can have an attached thread state at a given moment. In :term:`free-threaded builds <free-threaded build>` of Python, threads can concurrently hold an attached thread state, allowing for true parallelism of the bytecode interpreter."
msgstr "در بیشتر ساخت‌های پایتون، داشتن یک وضعیت نخ متصل به این معناست که فراخواننده :term:`GIL <GIL>` را برای مفسر فعلی در اختیار دارد، بنابراین در یک لحظه‌ی مشخص فقط یک نخ سیستم‌عامل می‌تواند یک وضعیت نخ متصل داشته باشد. در :term:`ساخت نخ‌آزاد <free-threaded build>` پایتون، نخ‌ها می‌توانند به‌طور همزمان وضعیت نخ متصل داشته باشند، که امکان موازی‌سازی واقعی مفسر بایت‌کد را فراهم می‌کند."

msgid "attribute"
msgstr "ویژگی"

msgid "A value associated with an object which is usually referenced by name using dotted expressions. For example, if an object *o* has an attribute *a* it would be referenced as *o.a*."
msgstr "مقداری مرتبط با یک شیء که معمولاً با استفاده از عبارت‌های نقطه‌ای و با نام به آن ارجاع داده می‌شود. برای مثال، اگر یک شیء *o* دارای یک ویژگی *a* باشد، با *o.a* به آن ارجاع داده خواهد شد."

msgid "It is possible to give an object an attribute whose name is not an identifier as defined by :ref:`identifiers`, for example using :func:`setattr`, if the object allows it. Such an attribute will not be accessible using a dotted expression, and would instead need to be retrieved with :func:`getattr`."
msgstr "اگر شیء اجازه دهد، می‌توان با استفاده از :func:`setattr`، ویژگی‌ای با نامی که یک شناسه مطابق تعریف :ref:`identifiers` نیست به آن اختصاص داد. چنین ویژگی‌ای با استفاده از یک عبارت نقطه‌ای قابل دسترسی نخواهد بود و باید در عوض با :func:`getattr` بازیابی شود."

msgid "awaitable"
msgstr "awaitable"

msgid "An object that can be used in an :keyword:`await` expression.  Can be a :term:`coroutine` or an object with an :meth:`~object.__await__` method. See also :pep:`492`."
msgstr "شیءای که می‌تواند در یک عبارت :keyword:`await` استفاده شود. می‌تواند یک :term:`هم‌روال <coroutine>` یا شی‌ءای با متد :meth:`~object.__await__` باشد. همچنین :pep:`492` را ببینید."

msgid "BDFL"
msgstr "BDFL"

msgid "Benevolent Dictator For Life, a.k.a. `Guido van Rossum <https://gvanrossum.github.io/>`_, Python's creator."
msgstr "Benevolent Dictator For Life،نام دیگر `Guido van Rossum <https://gvanrossum.github.io/>`_، خالق پایتون."

msgid "binary file"
msgstr "پرونده دودویی"

msgid "A :term:`file object` able to read and write :term:`bytes-like objects <bytes-like object>`. Examples of binary files are files opened in binary mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer <sys.stdin>`, :data:`sys.stdout.buffer <sys.stdout>`, and instances of :class:`io.BytesIO` and :class:`gzip.GzipFile`."
msgstr "یک :term:`شیء پرونده <file object>` که می‌تواند :term:`شیء شبه‌بایت <bytes-like object>` را بخواند و بنویسد. نمونه‌هایی از پرونده‌های دودویی، پرونده‌هایی هستند که در حالت دودویی باز شده‌اند (``'rb'``، ``'wb'`` یا ``'rb+'``)، :data:`sys.stdin.buffer <sys.stdin>`، :data:`sys.stdout.buffer <sys.stdout>` و نمونه‌هایی از :class:`io.BytesIO` و :class:`gzip.GzipFile`."

msgid "See also :term:`text file` for a file object able to read and write :class:`str` objects."
msgstr "همچنین :term:`پرونده متنی <text file>` را برای یک شیء پرونده که می‌تواند اشیای :class:`str` را بخواند و بنویسد ببینید."

msgid "borrowed reference"
msgstr "ارجاع قرض‌گرفته‌شده"

msgid "In Python's C API, a borrowed reference is a reference to an object, where the code using the object does not own the reference. It becomes a dangling pointer if the object is destroyed. For example, a garbage collection can remove the last :term:`strong reference` to the object and so destroy it."
msgstr "در API زبان C پایتون، ارجاع قرض‌گرفته‌شده ارجاعی به یک شیء است که در آن کدی که از شیء استفاده می‌کند مالک ارجاع نیست. اگر شیء نابود شود، این ارجاع به یک اشاره‌گر آویزان تبدیل می‌شود. برای مثال، جمع‌آوری زباله می‌تواند آخرین :term:`ارجاع قوی <strong reference>` به شیء را حذف کند و در نتیجه آن را نابود کند."

msgid "Calling :c:func:`Py_INCREF` on the :term:`borrowed reference` is recommended to convert it to a :term:`strong reference` in-place, except when the object cannot be destroyed before the last usage of the borrowed reference. The :c:func:`Py_NewRef` function can be used to create a new :term:`strong reference`."
msgstr "فراخوانی :c:func:`Py_INCREF` روی :term:`ارجاع قرض‌گرفته‌شده <borrowed reference>` توصیه می‌شود تا آن را درجا به یک :term:`ارجاع قوی <strong reference>` تبدیل کند، مگر زمانی که شیء نمی‌تواند پیش از آخرین استفاده از ارجاع قرض‌گرفته‌شده نابود شود. تابع :c:func:`Py_NewRef` می‌تواند برای ایجاد یک :term:`ارجاع قوی <strong reference>` جدید استفاده شود."

msgid "bytes-like object"
msgstr "شیء شبه‌بایت"

msgid "An object that supports the :ref:`bufferobjects` and can export a C-:term:`contiguous` buffer. This includes all :class:`bytes`, :class:`bytearray`, and :class:`array.array` objects, as well as many common :class:`memoryview` objects.  Bytes-like objects can be used for various operations that work with binary data; these include compression, saving to a binary file, and sending over a socket."
msgstr "شی‌ءای که از :ref:`bufferobjects` پشتیبانی می‌کند و می‌تواند یک بافر C-:term:`پیوسته <contiguous>` اکسپورت کند. این شامل همه‌ی اشیای :class:`bytes`، :class:`bytearray` و :class:`array.array` و همچنین بسیاری از اشیای رایج :class:`memoryview` می‌شود. اشیای شبه‌بایت می‌توانند برای عملیات مختلفی که با داده‌های دودویی کار می‌کنند استفاده شوند؛ از جمله فشرده‌سازی، ذخیره در یک پرونده دودویی و ارسال از طریق یک سوکت."

msgid "Some operations need the binary data to be mutable.  The documentation often refers to these as \"read-write bytes-like objects\".  Example mutable buffer objects include :class:`bytearray` and a :class:`memoryview` of a :class:`bytearray`. Other operations require the binary data to be stored in immutable objects (\"read-only bytes-like objects\"); examples of these include :class:`bytes` and a :class:`memoryview` of a :class:`bytes` object."
msgstr "برخی عملیات‌ها نیاز دارند که داده‌های دودویی تغییرپذیر باشند. مستندات اغلب به این موارد با عنوان «اشیای شبه‌بایت خواندن-نوشتن» اشاره می‌کنند. نمونه‌هایی از اشیای بافر تغییرپذیر شامل :class:`bytearray` و یک :class:`memoryview` از یک :class:`bytearray` هستند. عملیات‌های دیگر نیاز دارند که داده‌های دودویی در اشیای تغییرناپذیر ذخیره شوند («اشیای شبه‌بایت فقط‌خواندنی»)؛ نمونه‌هایی از این موارد شامل :class:`bytes` و یک :class:`memoryview` از یک شیء :class:`bytes` هستند."

msgid "bytecode"
msgstr "بایت‌کد"

msgid "Python source code is compiled into bytecode, the internal representation of a Python program in the CPython interpreter.  The bytecode is also cached in ``.pyc`` files so that executing the same file is faster the second time (recompilation from source to bytecode can be avoided).  This \"intermediate language\" is said to run on a :term:`virtual machine` that executes the machine code corresponding to each bytecode. Do note that bytecodes are not expected to work between different Python virtual machines, nor to be stable between Python releases."
msgstr "کد منبع پایتون به بایت‌کد کامپایل می‌شود؛ بایت‌کد نمایش داخلی یک برنامه‌ی پایتون در مفسر CPython است. بایت‌کد همچنین در پرونده‌های ``.pyc`` ذخیره می‌شود تا اجرای همان پرونده در بار دوم سریع‌تر باشد (می‌توان از کامپایل دوباره از منبع به بایت‌کد جلوگیری کرد). گفته می‌شود این «زبان میانی» روی یک :term:`ماشین مجازی <virtual machine>` اجرا می‌شود که کد ماشین متناظر با هر بایت‌کد را اجرا می‌کند. توجه داشته باشید که انتظار نمی‌رود بایت‌کدها بین ماشین‌های مجازی مختلف پایتون کار کنند یا بین نسخه‌های مختلف پایتون پایدار باشند."

msgid "A list of bytecode instructions can be found in the documentation for :ref:`the dis module <bytecodes>`."
msgstr "فهرستی از دستورهای بایت‌کد را می‌توان در مستندات :ref:`the dis module <bytecodes>` یافت."

msgid "callable"
msgstr "فراخوانی‌پذیر"

msgid "A callable is an object that can be called, possibly with a set of arguments (see :term:`argument`), with the following syntax::"
msgstr "یک فراخوانی‌پذیر شی‌ءای است که می‌توان آن را، احتمالاً با مجموعه‌ای از آرگومان‌ها (به :term:`آرگومان <argument>` مراجعه کنید)، با سینتکس زیر فراخوانی کرد::"

msgid "callable(argument1, argument2, argumentN)"
msgstr "callable(argument1, argument2, argumentN)"

msgid "A :term:`function`, and by extension a :term:`method`, is a callable. An instance of a class that implements the :meth:`~object.__call__` method is also a callable."
msgstr "یک :term:`تابع <function>` و به‌تبع آن یک :term:`متد <method>`، یک فراخوانی‌پذیر است. یک نمونه از یک کلاس که متد :meth:`~object.__call__` را پیاده‌سازی می‌کند نیز یک فراخوانی‌پذیر است."

msgid "callback"
msgstr "کال‌بک"

msgid "A subroutine function which is passed as an argument to be executed at some point in the future."
msgstr "یک تابع زیرروال که به‌عنوان آرگومان ارسال می‌شود تا در نقطه‌ای در آینده اجرا شود."

msgid "class"
msgstr "کلاس"

msgid "A template for creating user-defined objects. Class definitions normally contain method definitions which operate on instances of the class."
msgstr "الگویی برای ایجاد اشیای تعریف‌شده توسط کاربر. تعریف‌های کلاس معمولاً شامل تعریف‌های متد هستند که روی نمونه‌های کلاس عمل می‌کنند."

msgid "class variable"
msgstr "متغیر کلاس"

msgid "A variable defined in a class and intended to be modified only at class level (i.e., not in an instance of the class)."
msgstr "متغیری که در یک کلاس تعریف شده است و قرار است فقط در سطح کلاس تغییر داده شود (یعنی نه در یک نمونه از کلاس)."

msgid "closure variable"
msgstr "متغیر بستار"

msgid "A :term:`free variable` referenced from a :term:`nested scope` that is defined in an outer scope rather than being resolved at runtime from the globals or builtin namespaces. May be explicitly defined with the :keyword:`nonlocal` keyword to allow write access, or implicitly defined if the variable is only being read."
msgstr "یک :term:`متغیر آزاد <free variable>` که از یک :term:`محدوده‌ی تودرتو <nested scope>` ارجاع داده می‌شود و در یک محدوده‌ی بیرونی تعریف شده است، به‌جای این‌که در زمان ران‌تایم از فضای نام های سراسری یا توکار حل شود. ممکن است به‌طور صریح با کلیدواژه‌ی :keyword:`nonlocal` تعریف شود تا امکان دسترسی نوشتن فراهم شود، یا اگر متغیر فقط خوانده می‌شود، به‌طور ضمنی تعریف شود."

msgid "For example, in the ``inner`` function in the following code, both ``x`` and ``print`` are :term:`free variables <free variable>`, but only ``x`` is a *closure variable*::"
msgstr "برای مثال، در تابع ``inner`` در کد زیر، هر دو مورد ``x`` و ``print`` :term:`متغیر آزاد <free variable>` هستند، اما فقط ``x`` یک *متغیر بستار* است::"

msgid ""
"def outer():\n"
"    x = 0\n"
"    def inner():\n"
"        nonlocal x\n"
"        x += 1\n"
"        print(x)\n"
"    return inner"
msgstr ""
"def outer():\n"
"    x = 0\n"
"    def inner():\n"
"        nonlocal x\n"
"        x += 1\n"
"        print(x)\n"
"    return inner"

msgid "Due to the :attr:`codeobject.co_freevars` attribute (which, despite its name, only includes the names of closure variables rather than listing all referenced free variables), the more general :term:`free variable` term is sometimes used even when the intended meaning is to refer specifically to closure variables."
msgstr "به‌دلیل ویژگی :attr:`codeobject.co_freevars` (که با وجود نامش، فقط نام‌های متغیرهای بستار را شامل می‌شود و همه‌ی متغیرهای آزاد ارجاع‌داده‌شده را فهرست نمی‌کند)، اصطلاح کلی‌تر :term:`متغیر آزاد <free variable>` گاهی حتی زمانی استفاده می‌شود که معنای مورد نظر به‌طور مشخص اشاره به متغیرهای بستار دارد."

msgid "complex number"
msgstr "عدد مختلط"

msgid "An extension of the familiar real number system in which all numbers are expressed as a sum of a real part and an imaginary part.  Imaginary numbers are real multiples of the imaginary unit (the square root of ``-1``), often written ``i`` in mathematics or ``j`` in engineering.  Python has built-in support for complex numbers, which are written with this latter notation; the imaginary part is written with a ``j`` suffix, e.g., ``3+1j``.  To get access to complex equivalents of the :mod:`math` module, use :mod:`cmath`.  Use of complex numbers is a fairly advanced mathematical feature.  If you're not aware of a need for them, it's almost certain you can safely ignore them."
msgstr "گسترشی از سیستم آشنای اعداد حقیقی که در آن همه‌ی اعداد به‌صورت مجموع یک بخش حقیقی و یک بخش موهومی بیان می‌شوند. اعداد موهومی مضرب‌های حقیقی واحد موهومی (ریشه‌ی دوم ``-1``) هستند که در ریاضیات اغلب با ``i`` و در مهندسی با ``j`` نوشته می‌شود. پایتون پشتیبانی توکار از اعداد مختلط دارد که با این نمادگذاری اخیر نوشته می‌شوند؛ بخش موهومی با پسوند ``j`` نوشته می‌شود، برای مثال ``3+1j``. برای دسترسی به معادل‌های مختلط ماژول :mod:`math`، از :mod:`cmath` استفاده کنید. استفاده از اعداد مختلط یک ویژگی نسبتاً پیشرفته‌ی ریاضی است. اگر از نیاز به آن‌ها آگاه نیستید، تقریباً قطعی است که می‌توانید با خیال راحت آن‌ها را نادیده بگیرید."

msgid "concurrency"
msgstr "همزمانی"

msgid "The ability of a computer program to perform multiple tasks at the same time.  Python provides libraries for writing programs that make use of different forms of concurrency.  :mod:`asyncio` is a library for dealing with asynchronous tasks and coroutines.  :mod:`threading` provides access to operating system threads and :mod:`multiprocessing` to operating system processes. Multi-core processors can execute threads and processes on different CPU cores at the same time (see :term:`parallelism`)."
msgstr "توانایی یک برنامه‌ی کامپیوتری برای انجام چندین کار در یک زمان. پایتون کتابخانه‌هایی برای نوشتن برنامه‌هایی که از شکل‌های مختلف همزمانی استفاده می‌کنند فراهم می‌کند. :mod:`asyncio` کتابخانه‌ای برای کار با وظایف ناهمگام و coroutineها است. :mod:`threading` دسترسی به نخ‌های سیستم‌عامل و :mod:`multiprocessing` دسترسی به پردازه‌های سیستم‌عامل را فراهم می‌کنند. پردازنده‌های چندهسته‌ای می‌توانند نخ‌ها و پردازه‌ها را روی هسته‌های مختلف CPU به‌طور همزمان اجرا کنند (به :term:`موازی‌سازی <parallelism>` مراجعه کنید)."

msgid "concurrent modification"
msgstr "تغییر همزمان"

msgid "When multiple threads modify shared data at the same time.  Concurrent modification without proper synchronization can cause :term:`race conditions <race condition>`, and might also trigger a :term:`data race <data race>`, data corruption, or both."
msgstr "هنگامی که چندین نخ در یک زمان داده‌های اشتراکی را تغییر می‌دهند. تغییر همزمان بدون همگام‌سازی مناسب می‌تواند باعث :term:`شرط رقابت <race condition>` شود و همچنین ممکن است یک :term:`رقابت داده <data race>`، خرابی داده یا هر دو را ایجاد کند."

msgid "context"
msgstr "زمینه"

msgid "This term has different meanings depending on where and how it is used. Some common meanings:"
msgstr "این اصطلاح بسته به محل و نحوه‌ی استفاده، معانی متفاوتی دارد. برخی از معانی رایج:"

msgid "The temporary state or environment established by a :term:`context manager` via a :keyword:`with` statement."
msgstr "وضعیت یا محیط موقتی که توسط یک :term:`مدیر زمینه <context manager>` از طریق یک دستور :keyword:`with` ایجاد می‌شود."

msgid "The collection of key­value bindings associated with a particular :class:`contextvars.Context` object and accessed via :class:`~contextvars.ContextVar` objects.  Also see :term:`context variable`."
msgstr "مجموعه‌ی مقیدسازی‌های کلید-مقدار مرتبط با یک شیء :class:`contextvars.Context` خاص و قابل دسترسی از طریق اشیای :class:`~contextvars.ContextVar`. همچنین :term:`متغیر زمینه <context variable>` را ببینید."

msgid "A :class:`contextvars.Context` object.  Also see :term:`current context`."
msgstr "یک شیء :class:`contextvars.Context`. همچنین :term:`زمینه فعلی <current context>` را ببینید."

msgid "context management protocol"
msgstr "پروتکل مدیریت زمینه"

msgid "The :meth:`~object.__enter__` and :meth:`~object.__exit__` methods called by the :keyword:`with` statement.  See :pep:`343`."
msgstr "متدهای :meth:`~object.__enter__` و :meth:`~object.__exit__` که توسط دستور :keyword:`with` فراخوانی می‌شوند. :pep:`343` را ببینید."

msgid "context manager"
msgstr "مدیر زمینه"

msgid "An object which implements the :term:`context management protocol` and controls the environment seen in a :keyword:`with` statement.  See :pep:`343`."
msgstr "شی‌ءای که :term:`پروتکل مدیریت زمینه <context management protocol>` را پیاده‌سازی می‌کند و محیط مشاهده‌شده در یک دستور :keyword:`with` را کنترل می‌کند. :pep:`343` را ببینید."

msgid "context variable"
msgstr "متغیر زمینه"

msgid "A variable whose value depends on which context is the :term:`current context`.  Values are accessed via :class:`contextvars.ContextVar` objects.  Context variables are primarily used to isolate state between concurrent asynchronous tasks."
msgstr "متغیری که مقدار آن به این بستگی دارد که کدام زمینه :term:`زمینه فعلی <current context>` است. مقادیر از طریق اشیای :class:`contextvars.ContextVar` قابل دسترسی هستند. متغیرهای زمینه عمدتاً برای جداسازی وضعیت بین وظایف ناهمگام همزمان استفاده می‌شوند."

msgid "contiguous"
msgstr "پیوسته"

msgid "A buffer is considered contiguous exactly if it is either *C-contiguous* or *Fortran contiguous*.  Zero-dimensional buffers are C and Fortran contiguous.  In one-dimensional arrays, the items must be laid out in memory next to each other, in order of increasing indexes starting from zero.  In multidimensional C-contiguous arrays, the last index varies the fastest when visiting items in order of memory address.  However, in Fortran contiguous arrays, the first index varies the fastest."
msgstr "یک بافر دقیقاً پیوسته در نظر گرفته می‌شود اگر یا *C-contiguous* یا *Fortran contiguous* باشد. بافرهای صفربعدی هم C و هم Fortran پیوسته هستند. در آرایه‌های یک‌بعدی، آیتم‌ها باید در حافظه در کنار یکدیگر و به‌ترتیب اندیس‌های افزایشی که از صفر شروع می‌شوند قرار گرفته باشند. در آرایه‌های چندبعدی C-contiguous، هنگام بازدید از آیتم‌ها به‌ترتیب آدرس حافظه، آخرین اندیس سریع‌ترین تغییر را دارد. با این حال، در آرایه‌های Fortran contiguous، اولین اندیس سریع‌ترین تغییر را دارد."

msgid "coroutine"
msgstr "هم‌روال"

msgid "Coroutines are a more generalized form of subroutines. Subroutines are entered at one point and exited at another point.  Coroutines can be entered, exited, and resumed at many different points.  They can be implemented with the :keyword:`async def` statement.  See also :pep:`492`."
msgstr "هم‌روال‌ها شکل کلی‌تری از زیرروال‌ها هستند. زیرروال‌ها از یک نقطه وارد و از نقطه‌ای دیگر خارج می‌شوند. هم‌روال‌ها می‌توانند از نقاط مختلفی وارد، خارج و از سر گرفته شوند. آن‌ها می‌توانند با دستور :keyword:`async def` پیاده‌سازی شوند. همچنین :pep:`492` را ببینید."

msgid "coroutine function"
msgstr "تابع هم‌روال"

msgid "A function which returns a :term:`coroutine` object.  A coroutine function may be defined with the :keyword:`async def` statement, and may contain :keyword:`await`, :keyword:`async for`, and :keyword:`async with` keywords.  These were introduced by :pep:`492`."
msgstr "تابعی که یک شیء :term:`هم‌روال <coroutine>` بازمی‌گرداند. یک تابع هم‌روال می‌تواند با دستور :keyword:`async def` تعریف شود و می‌تواند شامل کلیدواژه‌های :keyword:`await`، :keyword:`async for` و :keyword:`async with` باشد. این موارد توسط :pep:`492` معرفی شدند."

msgid "CPython"
msgstr "CPython"

msgid "The canonical implementation of the Python programming language, as distributed on `python.org <https://www.python.org>`_.  The term \"CPython\" is used when necessary to distinguish this implementation from others such as Jython or IronPython."
msgstr "پیاده‌سازی کانونیکال زبان برنامه‌نویسی پایتون، همان‌طور که در `python.org <https://www.python.org>`_ توزیع می‌شود. اصطلاح «CPython» در مواقعی استفاده می‌شود که لازم باشد این پیاده‌سازی از موارد دیگری مانند Jython یا IronPython متمایز شود."

msgid "current context"
msgstr "زمینه فعلی"

msgid "The :term:`context` (:class:`contextvars.Context` object) that is currently used by :class:`~contextvars.ContextVar` objects to access (get or set) the values of :term:`context variables <context variable>`.  Each thread has its own current context.  Frameworks for executing asynchronous tasks (see :mod:`asyncio`) associate each task with a context which becomes the current context whenever the task starts or resumes execution."
msgstr ":term:`زمینه <context>` (:class:`contextvars.Context`) که در حال حاضر توسط اشیای :class:`~contextvars.ContextVar` برای دسترسی (دریافت یا تنظیم) مقادیر :term:`متغیر زمینه <context variable>` استفاده می‌شود. هر نخ، زمینه‌ی فعلی خود را دارد. چارچوب‌های اجرای وظایف ناهمگام (به :mod:`asyncio` مراجعه کنید) هر وظیفه را با یک زمینه مرتبط می‌کنند که هر زمان وظیفه شروع یا ادامه‌ی اجرا می‌دهد، به زمینه‌ی فعلی تبدیل می‌شود."

msgid "cyclic isolate"
msgstr "ایزوله‌ی چرخه‌ای"

msgid "A subgroup of one or more objects that reference each other in a reference cycle, but are not referenced by objects outside the group.  The goal of the :term:`cyclic garbage collector <garbage collection>` is to identify these groups and break the reference cycles so that the memory can be reclaimed."
msgstr "زیرگروهی شامل یک یا چند شیء که در یک چرخه‌ی ارجاع به یکدیگر ارجاع می‌دهند، اما توسط اشیای خارج از گروه ارجاع داده نمی‌شوند. هدف :term:`زباله‌روبی <garbage collection>` شناسایی این گروه‌ها و شکستن چرخه‌های ارجاع است تا حافظه بتواند بازیابی شود."

msgid "data race"
msgstr "رقابت داده"

msgid "A situation where multiple threads access the same memory location concurrently, at least one of the accesses is a write, and the threads do not use any synchronization to control their access.  Data races lead to :term:`non-deterministic` behavior and can cause data corruption. Proper use of :term:`locks <lock>` and other :term:`synchronization primitives <synchronization primitive>` prevents data races.  Note that data races can only happen in native code, but that :term:`native code` might be exposed in a Python API.  See also :term:`race condition` and :term:`thread-safe`."
msgstr "وضعیتی که در آن چندین نخ به یک محل حافظه‌ی یکسان به‌طور همزمان دسترسی دارند، دست‌کم یکی از دسترسی‌ها نوشتن است و نخ‌ها برای کنترل دسترسی خود از هیچ همگام‌سازی‌ای استفاده نمی‌کنند. رقابت‌های داده به رفتار :term:`غیرقطعی <non-deterministic>` منجر می‌شوند و می‌توانند باعث خرابی داده شوند. استفاده‌ی درست از :term:`قفل <lock>` و دیگر :term:`اولیه همگام‌سازی <synchronization primitive>` از رقابت‌های داده جلوگیری می‌کند. توجه داشته باشید که رقابت‌های داده فقط در کد بومی رخ می‌دهند، اما آن :term:`کد بومی <native code>` ممکن است در یک API پایتون در معرض استفاده قرار گرفته باشد. همچنین :term:`شرط رقابت <race condition>` و :term:`ایمن برای نخ‌های اجرایی <thread-safe>` را ببینید."

msgid "deadlock"
msgstr "بن‌بست"

msgid "A situation in which two or more tasks (threads, processes, or coroutines) wait indefinitely for each other to release resources or complete actions, preventing any from making progress.  For example, if thread A holds lock 1 and waits for lock 2, while thread B holds lock 2 and waits for lock 1, both threads will wait indefinitely.  In Python this often arises from acquiring multiple locks in conflicting orders or from circular join/await dependencies.  Deadlocks can be avoided by always acquiring multiple :term:`locks <lock>` in a consistent order.  See also :term:`lock` and :term:`reentrant`."
msgstr "وضعیتی که در آن دو یا چند وظیفه (نخ‌ها، پردازه‌ها یا هم‌روال‌ها) به‌طور نامحدود منتظر می‌مانند تا یکدیگر منابع را آزاد کنند یا اقداماتی را کامل کنند، و در نتیجه هیچ‌کدام نمی‌توانند پیشرفت کنند. برای مثال، اگر نخ A قفل ۱ را در اختیار داشته باشد و منتظر قفل ۲ باشد، در حالی که نخ B قفل ۲ را در اختیار دارد و منتظر قفل ۱ است، هر دو نخ به‌طور نامحدود منتظر خواهند ماند. در پایتون، این وضعیت اغلب از دریافت چندین قفل با ترتیب‌های ناسازگار یا از وابستگی‌های join/await چرخه‌ای ایجاد می‌شود. می‌توان با همیشه دریافت کردن چندین :term:`قفل <lock>` به یک ترتیب ثابت از بن‌بست‌ها جلوگیری کرد. همچنین :term:`قفل <lock>` و :term:`بازورودپذیر <reentrant>` را ببینید."

msgid "decorator"
msgstr "دکوراتور"

msgid "A function returning another function, usually applied as a function transformation using the ``@wrapper`` syntax.  Common examples for decorators are :deco:`classmethod` and :deco:`staticmethod`."
msgstr "تابعی که تابع دیگری را بازمی‌گرداند و معمولاً با استفاده از سینتکس ``@wrapper`` به‌عنوان یک تبدیل تابع اعمال می‌شود. نمونه‌های رایج دکوراتورها :deco:`classmethod` و :deco:`staticmethod` هستند."

msgid "The decorator syntax is merely syntactic sugar, the following two function definitions are semantically equivalent::"
msgstr "سینتکس دکوراتور صرفاً یک قند نحوی (syntactic sugar) است؛ دو تعریف تابع زیر از نظر معنایی معادل هستند::"

msgid ""
"def f(arg):\n"
"    ...\n"
"f = staticmethod(f)\n"
"\n"
"@staticmethod\n"
"def f(arg):\n"
"    ..."
msgstr ""
"def f(arg):\n"
"    ...\n"
"f = staticmethod(f)\n"
"\n"
"@staticmethod\n"
"def f(arg):\n"
"    ..."

msgid "The same concept exists for classes, but is less commonly used there.  See the documentation for :ref:`function definitions <function>` and :ref:`class definitions <class>` for more about decorators."
msgstr "همین مفهوم برای کلاس‌ها نیز وجود دارد، اما استفاده از آن در آنجا کمتر رایج است. برای اطلاعات بیشتر درباره‌ی دکوراتورها، مستندات :ref:`تابع <function>` و :ref:`کلاس <class>` را ببینید."

msgid "descriptor"
msgstr "توصیف‌گر"

msgid "Any object which defines the methods :meth:`~object.__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`. When a class attribute is a descriptor, its special binding behavior is triggered upon attribute lookup.  Normally, using *a.b* to get, set or delete an attribute looks up the object named *b* in the class dictionary for *a*, but if *b* is a descriptor, the respective descriptor method gets called.  Understanding descriptors is a key to a deep understanding of Python because they are the basis for many features including functions, methods, properties, class methods, static methods, and reference to super classes."
msgstr "هر شی‌ءای که متدهای :meth:`~object.__get__`، :meth:`~object.__set__` یا :meth:`~object.__delete__` را تعریف کند. هنگامی که یک ویژگی کلاس یک توصیف‌گر باشد، رفتار اتصال ویژه‌ی آن هنگام جست‌وجوی ویژگی فعال می‌شود. معمولاً استفاده از *a.b* برای دریافت، تنظیم یا حذف یک ویژگی، شیء با نام *b* را در دیکشنری کلاس *a* جست‌وجو می‌کند، اما اگر *b* یک توصیف‌گر باشد، متد مربوط به توصیف‌گر فراخوانی می‌شود. درک توصیف‌گرها کلیدی برای درک عمیق پایتون است، زیرا آن‌ها پایه‌ی بسیاری از قابلیت‌ها از جمله توابع، متدها، ویژگی‌ها، متدهای کلاس، متدهای ایستا و ارجاع به کلاس‌های بالادستی هستند."

msgid "For more information about descriptors' methods, see :ref:`descriptors` or the :ref:`Descriptor How To Guide <descriptorhowto>`."
msgstr "برای اطلاعات بیشتر درباره‌ی متدهای توصیف‌گرها، :ref:`descriptors` یا :ref:`Descriptor How To Guide <descriptorhowto>` را ببینید."

msgid "dictionary"
msgstr "دیکشنری"

msgid "An associative array, where arbitrary keys are mapped to values.  The keys can be any object with :meth:`~object.__hash__` and :meth:`~object.__eq__` methods. Called a hash in Perl."
msgstr "یک آرایه‌ی انجمنی که در آن کلیدهای دلخواه به مقادیر نگاشت می‌شوند. کلیدها می‌توانند هر شیءای باشند که متدهای :meth:`~object.__hash__` و :meth:`~object.__eq__` را داشته باشد. در Perl به آن hash گفته می‌شود."

msgid "dictionary comprehension"
msgstr "درک دیکشنری"

msgid "A compact way to process all or part of the elements in an iterable and return a dictionary with the results. ``results = {n: n ** 2 for n in range(10)}`` generates a dictionary containing key ``n`` mapped to value ``n ** 2``. See :ref:`comprehensions`."
msgstr "روشی فشرده برای پردازش همه یا بخشی از عناصر یک پیمایش‌پذیر و بازگرداندن یک دیکشنری با نتایج. ``results = {n: n ** 2 for n in range(10)}`` یک دیکشنری ایجاد می‌کند که شامل کلید ``n`` نگاشت‌شده به مقدار ``n ** 2`` است. :ref:`comprehensions` را ببینید."

msgid "dictionary view"
msgstr "نمای دیکشنری"

msgid "The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and :meth:`dict.items` are called dictionary views. They provide a dynamic view on the dictionary’s entries, which means that when the dictionary changes, the view reflects these changes. To force the dictionary view to become a full list use ``list(dictview)``.  See :ref:`dict-views`."
msgstr "اشیایی که توسط :meth:`dict.keys`، :meth:`dict.values` و :meth:`dict.items` بازگردانده می‌شوند، نماهای دیکشنری نامیده می‌شوند. آن‌ها نمایی پویا از ورودی‌های دیکشنری فراهم می‌کنند، به این معنا که هنگام تغییر دیکشنری، نما نیز این تغییرات را منعکس می‌کند. برای تبدیل نمای دیکشنری به یک فهرست کامل از ``list(dictview)`` استفاده کنید. :ref:`dict-views` را ببینید."

msgid "docstring"
msgstr "رشته‌ی مستندات"

msgid "A string literal which appears as the first expression in a class, function or module.  While ignored when the suite is executed, it is recognized by the compiler and put into the :attr:`~definition.__doc__` attribute of the enclosing class, function or module.  Since it is available via introspection, it is the canonical place for documentation of the object."
msgstr "یک مقدار رشته‌ای که به‌عنوان اولین عبارت در یک کلاس، تابع یا ماژول ظاهر می‌شود. اگرچه هنگام اجرای بدنه نادیده گرفته می‌شود، توسط کامپایلر شناسایی شده و در ویژگی :attr:`~definition.__doc__` کلاس، تابع یا ماژول دربرگیرنده قرار داده می‌شود. از آنجا که از طریق درون‌نگری در دسترس است، مکان کانونیکال برای مستندسازی شیء محسوب می‌شود."

msgid "duck-typing"
msgstr "نوع‌دهی اردکی"

msgid "A programming style which does not look at an object's type to determine if it has the right interface; instead, the method or attribute is simply called or used (\"If it looks like a duck and quacks like a duck, it must be a duck.\")  By emphasizing interfaces rather than specific types, well-designed code improves its flexibility by allowing polymorphic substitution.  Duck-typing avoids tests using :func:`type` or :func:`isinstance`.  (Note, however, that duck-typing can be complemented with :term:`abstract base classes <abstract base class>`.)  Instead, it typically employs :func:`hasattr` tests or :term:`EAFP` programming."
msgstr "سبک برنامه‌نویسی‌ای که برای تعیین داشتن رابط مناسب توسط یک شیء، به نوع آن نگاه نمی‌کند؛ در عوض، متد یا ویژگی به‌سادگی فراخوانی یا استفاده می‌شود («اگر شبیه اردک است و مانند اردک صدا می‌دهد، پس باید اردک باشد.»). با تأکید بر رابط‌ها به‌جای نوع‌های خاص، کد با طراحی خوب با امکان جایگزینی چندریخت، انعطاف‌پذیری خود را افزایش می‌دهد. نوع‌دهی اردکی از آزمون‌های مبتنی بر :func:`type` یا :func:`isinstance` اجتناب می‌کند. (با این حال، توجه داشته باشید که نوع‌دهی اردکی می‌تواند با :term:`کلاس پایه‌ی انتزاعی <abstract base class>` تکمیل شود.) در عوض، معمولاً از آزمون‌های :func:`hasattr` یا برنامه‌نویسی :term:`EAFP <EAFP>` استفاده می‌کند."

msgid "dunder"
msgstr "داندر"

msgid "An informal short-hand for \"double underscore\", used when talking about a :term:`special method`. For example, ``__init__`` is often pronounced \"dunder init\"."
msgstr "یک شکل کوتاه و غیررسمی برای «دو زیرخط» که هنگام صحبت درباره‌ی یک :term:`متد ویژه <special method>` استفاده می‌شود. برای مثال، ``__init__`` اغلب «داندر اینیت» تلفظ می‌شود."

msgid "EAFP"
msgstr "EAFP"

msgid "Easier to ask for forgiveness than permission.  This common Python coding style assumes the existence of valid keys or attributes and catches exceptions if the assumption proves false.  This clean and fast style is characterized by the presence of many :keyword:`try` and :keyword:`except` statements.  The technique contrasts with the :term:`LBYL` style common to many other languages such as C."
msgstr "آسان‌تر است که درخواست بخشش کنید تا اجازه. این سبک رایج کدنویسی پایتون وجود کلیدها یا ویژگی‌های معتبر را فرض می‌کند و اگر این فرض نادرست باشد، استثناها را دریافت می‌کند. این سبک پاک و سریع با وجود تعداد زیادی دستورهای :keyword:`try` و :keyword:`except` شناخته می‌شود. این روش در تضاد با سبک :term:`LBYL <LBYL>` است که در بسیاری از زبان‌های دیگر مانند C رایج است."

msgid "evaluate function"
msgstr "تابع ارزیابی"

msgid "A function that can be called to evaluate a lazily evaluated attribute of an object, such as the value of type aliases created with the :keyword:`type` statement."
msgstr "تابعی که می‌توان آن را برای ارزیابی یک ویژگی با ارزیابی تنبل یک شیء فراخوانی کرد، مانند مقدار نام‌های مستعار نوع که با دستور :keyword:`type` ایجاد شده‌اند."

msgid "exhausted"
msgstr "به‌پایان‌رسیده"

msgid "An :term:`iterator` that has produced all of its values is said to be :dfn:`exhausted`. Further attempts to get the next value (for example, calls to :func:`next`) raise :exc:`StopIteration` (or :exc:`StopAsyncIteration` in the case of an :term:`asynchronous iterator`)."
msgstr "یک :term:`پیمایش‌گر <iterator>` که تمام مقادیر خود را تولید کرده است، :dfn:`به پایان‌رسیده (exhausted)` نامیده می‌شود. تلاش‌های بیشتر برای دریافت مقدار بعدی (مثلاً فراخوانی‌های :func:`next`) باعث ایجاد :exc:`StopIteration` می‌شوند (یا :exc:`StopAsyncIteration` در صورت :term:`پیمایش‌گر ناهمگام <asynchronous iterator>`)."

msgid "expression"
msgstr "عبارت"

msgid "A piece of syntax which can be evaluated to some value.  In other words, an expression is an accumulation of expression elements like literals, names, attribute access, operators or function calls which all return a value.  Not all language constructs are expressions.  There are also :term:`statement`\\s which cannot be used as expressions, such as :keyword:`while`.  Assignments are also statements, not expressions."
msgstr "یک قطعه سینتکس که می‌تواند به مقداری ارزیابی شود. به عبارت دیگر، عبارت مجموعه‌ای از المان‌های عبارت مانند مقادیر لفظی، نام‌ها، دسترسی به ویژگی، عملگرها یا فراخوانی توابع است که همگی مقداری برمی‌گردانند. هر سازه‌ی زبانی عبارت نیست. همچنین :term:`دستورها <statement>` وجود دارند که نمی‌توان از آن‌ها به عنوان عبارت استفاده کرد، مانند :keyword:`while`. دستورهای انتساب نیز دستور هستند، نه عبارت‌ها."

msgid "extension module"
msgstr "ماژول توسعه‌ای"

msgid "A module written in C or C++, using Python's C API to interact with the core and with user code."
msgstr "ماژول نوشته‌شده به زبان C یا C++ که از API زبان C پایتون برای تعامل با هسته و کد کاربر استفاده می‌کند."

msgid "f-string"
msgstr "اف‌استرینگ"

msgid "f-strings"
msgstr "اف‌استرینگ‌ها"

msgid "String literals prefixed with ``f`` or ``F`` are commonly called \"f-strings\" which is short for :ref:`formatted string literals <f-strings>`.  See also :pep:`498`."
msgstr "رشته‌های لفظی که با ``f`` یا ``F`` پیشوندگذاری شده‌اند، معمولاً «اف‌استرینگ» نامیده می‌شوند که کوتاه‌شده‌ی :ref:`اف‌استرینگ‌ها <f-strings>` است. همچنین :pep:`498` را ببینید."

msgid "file object"
msgstr "شیء پرونده"

msgid "An object exposing a file-oriented API (with methods such as :meth:`!read` or :meth:`!write`) to an underlying resource.  Depending on the way it was created, a file object can mediate access to a real on-disk file or to another type of storage or communication device (for example standard input/output, in-memory buffers, sockets, pipes, etc.).  File objects are also called :dfn:`file-like objects` or :dfn:`streams`."
msgstr "شی‌ءای که یک API فایل‌محور (با متدهایی مانند :meth:`!read` یا :meth:`!write`) برای یک منبع زیربنایی ارائه می‌دهد. بسته به نحوه‌ی ایجاد آن، یک شیء پرونده می‌تواند دسترسی به یک پرونده واقعی روی دیسک یا نوع دیگری از فضای ذخیره‌سازی یا دستگاه ارتباطی را مدیریت کند (برای مثال ورودی/خروجی استاندارد، بافرهای درون‌حافظه‌ای، سوکت‌ها، پایپ‌ها و غیره). اشیای پرونده همچنین با نام‌های :dfn:`file-like objects` یا :dfn:`streams` شناخته می‌شوند."

msgid "There are actually three categories of file objects: raw :term:`binary files <binary file>`, buffered :term:`binary files <binary file>` and :term:`text files <text file>`. Their interfaces are defined in the :mod:`io` module.  The canonical way to create a file object is by using the :func:`open` function."
msgstr "در واقع سه دسته از اشیای پرونده وجود دارد: :term:`پرونده دودویی <binary file>` خام، :term:`پرونده دودویی <binary file>` بافرشده و :term:`پرونده متنی <text file>`. رابط‌های آن‌ها در ماژول :mod:`io` تعریف شده‌اند. روش کانونیکال ایجاد یک شیء پرونده، استفاده از تابع :func:`open` است."

msgid "file-like object"
msgstr "شیء شبه‌پرونده"

msgid "A synonym for :term:`file object`."
msgstr "هم‌معنای :term:`شیء پرونده <file object>`."

msgid "filesystem encoding and error handler"
msgstr "کدگذاری سیستم پرونده و هندلر خطا"

msgid "Encoding and error handler used by Python to decode bytes from the operating system and encode Unicode to the operating system."
msgstr "کدگذاری و هندلر خطایی که پایتون برای کدگشایی بایت‌ها از سیستم‌عامل و کدگذاری یونیکد به سیستم‌عامل استفاده می‌کند."

msgid "The filesystem encoding must guarantee to successfully decode all bytes below 128. If the file system encoding fails to provide this guarantee, API functions can raise :exc:`UnicodeError`."
msgstr "کدگذاری سیستم پرونده باید تضمین کند که همه‌ی بایت‌های کمتر از ۱۲۸ را با موفقیت کدگشایی می‌کند. اگر کدگذاری سیستم پرونده نتواند این تضمین را ارائه دهد، توابع API ممکن است استثنای :exc:`UnicodeError` ایجاد کنند."

msgid "The :func:`sys.getfilesystemencoding` and :func:`sys.getfilesystemencodeerrors` functions can be used to get the filesystem encoding and error handler."
msgstr "از توابع :func:`sys.getfilesystemencoding` و :func:`sys.getfilesystemencodeerrors` می‌توان برای دریافت کدگذاری سیستم پرونده و هندلر خطا استفاده کرد."

msgid "The :term:`filesystem encoding and error handler` are configured at Python startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`."
msgstr ":term:`کدگذاری سیستم پرونده و هندلر خطا <filesystem encoding and error handler>` در هنگام راه‌اندازی پایتون توسط تابع :c:func:`PyConfig_Read` پیکربندی می‌شوند: اعضای :c:member:`~PyConfig.filesystem_encoding` و :c:member:`~PyConfig.filesystem_errors` از :c:type:`PyConfig` را ببینید."

msgid "See also the :term:`locale encoding`."
msgstr "همچنین :term:`کدگذاری locale <locale encoding>` را ببینید."

msgid "finder"
msgstr "یابنده"

msgid "An object that tries to find the :term:`loader` for a module that is being imported."
msgstr "شیءای که تلاش می‌کند :term:`بارگذار <loader>` مربوط به ماژولی را که در حال ایمپورت شدن است پیدا کند."

msgid "There are two types of finder: :term:`meta path finders <meta path finder>` for use with :data:`sys.meta_path`, and :term:`path entry finders <path entry finder>` for use with :data:`sys.path_hooks`."
msgstr "دو نوع یابنده وجود دارد: :term:`یابنده‌ی مسیر فراداده <meta path finder>` برای استفاده با :data:`sys.meta_path` و :term:`یابنده‌ی ورودی مسیر <path entry finder>` برای استفاده با :data:`sys.path_hooks`."

msgid "See :ref:`finders-and-loaders` and :mod:`importlib` for much more detail."
msgstr "برای جزئیات بسیار بیشتر، :ref:`finders-and-loaders` و :mod:`importlib` را ببینید."

msgid "floor division"
msgstr "تقسیم کف"

msgid "Mathematical division that rounds down to nearest integer.  The floor division operator is ``//``.  For example, the expression ``11 // 4`` evaluates to ``2`` in contrast to the ``2.75`` returned by float true division.  Note that ``(-11) // 4`` is ``-3`` because that is ``-2.75`` rounded *downward*. See :pep:`238`."
msgstr "تقسیم ریاضی که به نزدیک‌ترین عدد صحیح پایین گرد می‌شود. عملگر تقسیم کف ``//`` است. برای مثال، عبارت ``11 // 4`` به ``2`` ارزیابی می‌شود، در حالی که تقسیم حقیقی با عدد اعشاری مقدار ``2.75`` را بازمی‌گرداند. توجه داشته باشید که ``(-11) // 4`` برابر ``-3`` است، زیرا ``-2.75`` به سمت *پایین* گرد می‌شود. :pep:`238` را ببینید."

msgid "free threading"
msgstr "نخ‌گذاری آزاد"

msgid "A threading model where multiple threads can run Python bytecode simultaneously within the same interpreter.  This is in contrast to the :term:`global interpreter lock` which allows only one thread to execute Python bytecode at a time.  See :pep:`703`."
msgstr "مدل نخ‌ای که در آن چندین نخ می‌توانند بایت‌کد پایتون را به‌طور همزمان درون همان مفسر اجرا کنند. این در تضاد با :term:`قفل مفسر سراسری <global interpreter lock>` است که اجازه می‌دهد فقط یک نخ در هر زمان بایت‌کد پایتون را اجرا کند. :pep:`703` را ببینید."

msgid "free-threaded build"
msgstr "ساخت نخ‌آزاد"

msgid "A build of :term:`CPython` that supports :term:`free threading`, configured using the :option:`--disable-gil` option before compilation."
msgstr "ساختی از :term:`CPython <CPython>` که از :term:`نخ‌گذاری آزاد <free threading>` پشتیبانی می‌کند و با استفاده از گزینه‌ی :option:`--disable-gil` پیش از کامپایل پیکربندی شده است."

msgid "See :ref:`freethreading-python-howto`."
msgstr ":ref:`freethreading-python-howto` را ببینید."

msgid "free variable"
msgstr "متغیر آزاد"

msgid "Formally, as defined in the :ref:`language execution model <bind_names>`, a free variable is any variable used in a namespace which is not a local variable in that namespace. See :term:`closure variable` for an example. Pragmatically, due to the name of the :attr:`codeobject.co_freevars` attribute, the term is also sometimes used as a synonym for :term:`closure variable`."
msgstr "به‌صورت رسمی، همان‌طور که در :ref:`language execution model <bind_names>` تعریف شده است، یک متغیر آزاد هر متغیری است که در یک فضای نام استفاده می‌شود اما در آن فضای نام یک متغیر محلی نیست. برای نمونه، :term:`متغیر بستار <closure variable>` را ببینید. از نظر عملی، به‌دلیل نام ویژگی :attr:`codeobject.co_freevars`، این اصطلاح گاهی به‌عنوان مترادفی برای :term:`متغیر بستار <closure variable>` نیز استفاده می‌شود."

msgid "function"
msgstr "تابع"

msgid "A series of statements which returns some value to a caller. It can also be passed zero or more :term:`arguments <argument>` which may be used in the execution of the body. See also :term:`parameter`, :term:`method`, and the :ref:`function` section."
msgstr "مجموعه‌ای از دستورها که مقداری را به یک فراخواننده بازمی‌گرداند. همچنین می‌تواند صفر یا چند :term:`آرگومان <argument>` دریافت کند که ممکن است در اجرای بدنه استفاده شوند. همچنین :term:`پارامتر <parameter>`، :term:`متد <method>` و بخش :ref:`تابع <function>` را ببینید."

msgid "function annotation"
msgstr "حاشیه‌گذاری تابع"

msgid "An :term:`annotation` of a function parameter or return value."
msgstr "یک :term:`حاشیه‌گذاری <annotation>` برای پارامتر یک تابع یا مقدار بازگشتی."

msgid "Function annotations are usually used for :term:`type hints <type hint>`: for example, this function is expected to take two :class:`int` arguments and is also expected to have an :class:`int` return value::"
msgstr "حاشیه‌گذاری‌های تابع معمولاً برای :term:`راهنمای نوع <type hint>` استفاده می‌شوند: برای مثال، انتظار می‌رود این تابع دو آرگومان :class:`int` دریافت کند و همچنین یک مقدار بازگشتی :class:`int` داشته باشد::"

msgid ""
"def sum_two_numbers(a: int, b: int) -> int:\n"
"   return a + b"
msgstr ""
"def sum_two_numbers(a: int, b: int) -> int:\n"
"   return a + b"

msgid "Function annotation syntax is explained in section :ref:`function`."
msgstr "سینتکس حاشیه‌گذاری تابع در بخش :ref:`تابع <function>` توضیح داده شده است."

msgid "See :term:`variable annotation` and :pep:`484`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations."
msgstr "به :term:`حاشیه‌نویسی متغیر <variable annotation>` و :pep:`484` مراجعه کنید که این قابلیت را توضیح می‌دهند. همچنین برای بهترین روش‌ها در کار با حاشیه‌گذاری‌ها، :ref:`annotations-howto` را ببینید."

msgid "__future__"
msgstr "__future__"

msgid "A :ref:`future statement <future>`, ``from __future__ import <feature>``, directs the compiler to compile the current module using syntax or semantics that will become standard in a future release of Python. The :mod:`__future__` module documents the possible values of *feature*.  By importing this module and evaluating its variables, you can see when a new feature was first added to the language and when it will (or did) become the default::"
msgstr "یک :ref:`future statement <future>`، یعنی ``from __future__ import <feature>``, به کامپایلر دستور می‌دهد ماژول فعلی را با استفاده از سینتکس یا معناشناسی‌ای کامپایل کند که در یک انتشار آینده‌ی پایتون استاندارد خواهد شد. ماژول :mod:`__future__` مقادیر ممکن *feature* را مستند می‌کند. با ایمپورت این ماژول و ارزیابی متغیرهای آن، می‌توانید ببینید چه زمانی یک ویژگی جدید برای اولین بار به زبان اضافه شده است و چه زمانی به حالت پیش‌فرض تبدیل خواهد شد (یا شده است)::"

msgid ""
">>> import __future__\n"
">>> __future__.division\n"
"_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)"
msgstr ""
">>> import __future__\n"
">>> __future__.division\n"
"_Feature((2, 2, 0, 'alpha', 2), (3, 0, 0, 'alpha', 0), 8192)"

msgid "garbage collection"
msgstr "زباله‌روبی"

msgid "The process of freeing memory when it is not used anymore.  Python performs garbage collection via reference counting and a cyclic garbage collector that is able to detect and break reference cycles.  The garbage collector can be controlled using the :mod:`gc` module."
msgstr "فرایند آزادسازی حافظه هنگامی که دیگر استفاده نمی‌شود. پایتون زباله‌روبی را از طریق شمارش ارجاع‌ها و یک زباله‌روب چرخه‌ای که قادر به شناسایی و شکستن چرخه‌های ارجاع است انجام می‌دهد. زباله‌روب را می‌توان با استفاده از ماژول :mod:`gc` کنترل کرد."

msgid "generator"
msgstr "تولیدگر"

msgid "Informally used to mean either a :term:`generator function` or a :term:`generator iterator`, depending on context.  The formal terms :term:`generator function` and :term:`generator iterator` are uncommon in practice; \"generator\" alone is almost always sufficient."
msgstr "به‌صورت غیررسمی برای اشاره به یک :term:`تابع تولیدگر <generator function>` یا یک :term:`پیمایش‌گر تولیدگر <generator iterator>`، بسته به زمینه، استفاده می‌شود. اصطلاحات رسمی :term:`تابع تولیدگر <generator function>` و :term:`پیمایش‌گر تولیدگر <generator iterator>` در عمل کمتر استفاده می‌شوند؛ «تولیدگر» به‌تنهایی تقریباً همیشه کافی است."

msgid "generator function"
msgstr "تابع تولیدگر"

msgid "A function which returns a :term:`generator` object.  It looks like a normal function except that it contains :keyword:`yield` expressions for producing a series of values usable in a :keyword:`for`\\-loop or that can be retrieved one at a time with the :func:`next` function. See :ref:`yieldexpr`."
msgstr "تابعی که یک شیء :term:`تولیدگر <generator>` بازمی‌گرداند. این تابع شبیه یک تابع معمولی است، با این تفاوت که شامل عبارت‌های :keyword:`yield` برای تولید مجموعه‌ای از مقادیر قابل استفاده در یک حلقه‌ی :keyword:`for` یا قابل بازیابی یکی‌یکی با تابع :func:`next` است. :ref:`yieldexpr` را ببینید."

msgid "generator iterator"
msgstr "پیمایش‌گر تولیدگر"

msgid "An object created by a :term:`generator function` or a :term:`generator expression`."
msgstr "شیءای که توسط یک :term:`تابع تولیدگر <generator function>` یا یک :term:`عبارت تولیدگر <generator expression>` ایجاد می‌شود."

msgid "Each :keyword:`yield` temporarily suspends processing, remembering the execution state (including local variables and pending try-statements). When the *generator iterator* resumes, it picks up where it left off (in contrast to functions which start fresh on every invocation)."
msgstr "هر :keyword:`yield` پردازش را به‌طور موقت متوقف می‌کند و وضعیت اجرا (شامل متغیرهای محلی و دستورهای try در انتظار) را به خاطر می‌سپارد. هنگامی که *پیمایش‌گر تولیدگر* ادامه‌ی اجرا می‌دهد، از همان نقطه‌ای که متوقف شده بود ادامه می‌دهد (برخلاف توابع که در هر فراخوانی از ابتدا شروع می‌شوند)."

msgid "Generator iterators also implement the :meth:`~generator.send` method to send a value into the suspended generator, and the :meth:`~generator.throw` method to raise an exception at the point where the generator was paused.  See :ref:`generator-methods`."
msgstr "پیمایش‌گرهای تولیدگر همچنین متد :meth:`~generator.send` را برای ارسال یک مقدار به تولیدگر متوقف‌شده و متد :meth:`~generator.throw` را برای پرتاب یک استثنا در نقطه‌ای که تولیدگر در آن متوقف شده است، پیاده‌سازی می‌کنند. بخش :ref:`generator-methods` را ببینید."

msgid "generator expression"
msgstr "عبارت تولیدگر"

msgid "An :term:`expression` that returns an :term:`iterator`.  It looks like a normal expression followed by a :keyword:`!for` clause defining a loop variable, range, and an optional :keyword:`!if` clause.  The combined expression generates values for an enclosing function::"
msgstr "یک :term:`عبارت <expression>` که یک :term:`پیمایش‌گر <iterator>` بازمی‌گرداند. این عبارت شبیه یک عبارت معمولی است که پس از آن یک بند :keyword:`!for` برای تعریف متغیر حلقه، محدوده و یک بند اختیاری :keyword:`!if` قرار گرفته است. عبارت ترکیبی، مقادیری را برای یک تابع دربرگیرنده تولید می‌کند::"

msgid ""
">>> sum(i*i for i in range(10))         # sum of squares 0, 1, 4, ... 81\n"
"285"
msgstr ""
">>> sum(i*i for i in range(10))         # sum of squares 0, 1, 4, ... 81\n"
"285"

msgid "generic function"
msgstr "تابع عام"

msgid "A function composed of multiple functions implementing the same operation for different types. Which implementation should be used during a call is determined by the dispatch algorithm."
msgstr "تابعی که از چندین تابع تشکیل شده است که یک عملیات یکسان را برای نوع‌های مختلف پیاده‌سازی می‌کنند. این‌که هنگام یک فراخوانی کدام پیاده‌سازی استفاده شود، توسط الگوریتم ارسال تعیین می‌شود."

msgid "See also the :term:`single dispatch` glossary entry, the :deco:`functools.singledispatch` decorator, and :pep:`443`."
msgstr "همچنین به ورودی واژه‌نامه‌ای :term:`توزیع تک‌گانه <single dispatch>`، دکوراتور :deco:`functools.singledispatch` و :pep:`443` مراجعه کنید."

msgid "generic type"
msgstr "نوع عام"

msgid "A :term:`type` that can be parameterized; typically a :ref:`container class<sequence-types>` such as :class:`list` or :class:`dict`. Used for :term:`type hints <type hint>` and :term:`annotations <annotation>`."
msgstr "یک :term:`نوع <type>` که می‌تواند پارامتری شود؛ معمولاً یک :ref:`container class<sequence-types>` مانند :class:`list` یا :class:`dict`. برای :term:`راهنمای نوع <type hint>` و :term:`حاشیه‌گذاری <annotation>` استفاده می‌شود."

msgid "For more details, see :ref:`generic alias types<types-genericalias>`, :pep:`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` module."
msgstr "برای جزئیات بیشتر، :ref:`generic alias types<types-genericalias>`، :pep:`483`، :pep:`484`، :pep:`585` و ماژول :mod:`typing` را ببینید."

msgid "GIL"
msgstr "GIL"

msgid "See :term:`global interpreter lock`."
msgstr ":term:`قفل مفسر سراسری <global interpreter lock>` را ببینید."

msgid "global interpreter lock"
msgstr "قفل مفسر سراسری"

msgid "The mechanism used by the :term:`CPython` interpreter to assure that only one thread executes Python :term:`bytecode` at a time. This simplifies the CPython implementation by making the object model (including critical built-in types such as :class:`dict`) implicitly safe against concurrent access.  Locking the entire interpreter makes it easier for the interpreter to be multi-threaded, at the expense of much of the parallelism afforded by multi-processor machines."
msgstr "سازوکاری که توسط مفسر :term:`CPython <CPython>` استفاده می‌شود تا تضمین کند در هر زمان فقط یک نخ :term:`بایت‌کد <bytecode>` پایتون را اجرا می‌کند. این کار پیاده‌سازی CPython را ساده‌تر می‌کند، زیرا مدل شیء (شامل نوع‌های توکار مهمی مانند :class:`dict`) به‌طور ضمنی در برابر دسترسی همزمان ایمن می‌شود. قفل کردن کل مفسر باعث می‌شود چندنخی کردن مفسر آسان‌تر شود، اما به قیمت از دست دادن بخش زیادی از موازی‌سازی‌ای که ماشین‌های چندپردازنده‌ای فراهم می‌کنند."

msgid "However, some extension modules, either standard or third-party, are designed so as to release the GIL when doing computationally intensive tasks such as compression or hashing.  Also, the GIL is always released when doing I/O."
msgstr "با این حال، برخی ماژول‌های توسعه‌ای، چه استاندارد و چه شخص ثالث، به‌گونه‌ای طراحی شده‌اند که هنگام انجام وظایف محاسباتی سنگین مانند فشرده‌سازی یا درهم‌سازی، GIL را آزاد کنند. همچنین، GIL همیشه هنگام انجام عملیات ورودی/خروجی آزاد می‌شود."

#, fuzzy
#| msgid "As of Python 3.13, the GIL can be disabled using the :option:`--disable-gil` build configuration. After building Python with this option, code must be run with :option:`-X gil=0 <-X>` or after setting the :envvar:`PYTHON_GIL=0 <PYTHON_GIL>` environment variable. This feature enables improved performance for multi-threaded applications and makes it easier to use multi-core CPUs efficiently. For more details, see :pep:`703`."
msgid "As of Python 3.13, the GIL can be disabled using the :option:`--disable-gil` build configuration. This feature enables improved performance for multi-threaded applications and makes it easier to use multi-core CPUs efficiently. For more details, see :pep:`703`."
msgstr "از پایتون ۳.۱۳، می‌توان GIL را با استفاده از پیکربندی ساخت :option:`--disable-gil` غیرفعال کرد. پس از ساخت پایتون با این گزینه، کد باید با :option:`-X gil=0 <-X>` یا پس از تنظیم متغیر محیطی :envvar:`PYTHON_GIL=0 <PYTHON_GIL>` اجرا شود. این ویژگی عملکرد بهتر برای برنامه‌های چندنخی را فراهم می‌کند و استفاده‌ی مؤثرتر از CPUهای چندهسته‌ای را آسان‌تر می‌سازد. برای جزئیات بیشتر، :pep:`703` را ببینید."

msgid "In prior versions of Python's C API, a function might declare that it requires the GIL to be held in order to use it. This refers to having an :term:`attached thread state`."
msgstr "در نسخه‌های پیشین API زبان C پایتون، یک تابع ممکن بود اعلام کند که برای استفاده از آن، لازم است GIL در اختیار گرفته شده باشد. این موضوع به داشتن یک :term:`وضعیت نخ متصل <attached thread state>` اشاره دارد."

msgid "global state"
msgstr "وضعیت سراسری"

msgid "Data that is accessible throughout a program, such as module-level variables, class variables, or C static variables in :term:`extension modules <extension module>`.  In multi-threaded programs, global state shared between threads typically requires synchronization to avoid :term:`race conditions <race condition>` and :term:`data races <data race>`."
msgstr "داده‌ای که در سراسر یک برنامه قابل دسترسی است، مانند متغیرهای سطح ماژول، متغیرهای کلاس یا متغیرهای ایستای C در :term:`ماژول توسعه‌ای <extension module>`. در برنامه‌های چندنخی، وضعیت سراسری اشتراک‌گذاری‌شده بین نخ‌ها معمولاً برای جلوگیری از :term:`شرط رقابت <race condition>` و :term:`رقابت داده <data race>` به همگام‌سازی نیاز دارد."

msgid "hash-based pyc"
msgstr "pyc مبتنی بر هش"

msgid "A bytecode cache file that uses the hash rather than the last-modified time of the corresponding source file to determine its validity. See :ref:`pyc-invalidation`."
msgstr "یک پرونده نهانگاه بایت‌کد که به‌جای زمان آخرین تغییر پرونده منبع متناظر، از هش آن برای تعیین اعتبار خود استفاده می‌کند. :ref:`pyc-invalidation` را ببینید."

msgid "hashable"
msgstr "قابل درهم‌سازی"

msgid "An object is *hashable* if it has a hash value which never changes during its lifetime (it needs a :meth:`~object.__hash__` method), and can be compared to other objects (it needs an :meth:`~object.__eq__` method). Hashable objects which compare equal must have the same hash value."
msgstr "یک شیء *قابل درهم‌سازی* است اگر دارای یک مقدار هش باشد که در طول عمر آن هرگز تغییر نمی‌کند (به یک متد :meth:`~object.__hash__` نیاز دارد) و بتوان آن را با اشیای دیگر مقایسه کرد (به یک متد :meth:`~object.__eq__` نیاز دارد). اشیای قابل درهم‌سازی که برابر مقایسه می‌شوند باید مقدار هش یکسانی داشته باشند."

msgid "Hashability makes an object usable as a dictionary key and a set member, because these data structures use the hash value internally."
msgstr "قابل درهم‌سازی بودن باعث می‌شود یک شیء به‌عنوان کلید دیکشنری و عضو مجموعه قابل استفاده باشد، زیرا این ساختارهای داده مقدار هش را به‌صورت داخلی استفاده می‌کنند."

msgid "Most of Python's immutable built-in objects are hashable; mutable containers (such as lists or dictionaries) are not; immutable containers (such as tuples and frozensets) are only hashable if their elements are hashable.  Objects which are instances of user-defined classes are hashable by default.  They all compare unequal (except with themselves), and their hash value is derived from their :func:`id`."
msgstr "بیشتر اشیای توکار تغییرناپذیر پایتون قابل درهم‌سازی هستند؛ محفظه‌های تغییرپذیر (مانند فهرست‌ها یا دیکشنری‌ها) قابل درهم‌سازی نیستند؛ محفظه‌های تغییرناپذیر (مانند تاپل‌ها یا frozensetها) فقط در صورتی قابل درهم‌سازی هستند که عناصرشان قابل درهم‌سازی باشند. اشیایی که نمونه‌هایی از کلاس‌های تعریف‌شده توسط کاربر هستند، به‌طور پیش‌فرض قابل درهم‌سازی هستند. همه‌ی آن‌ها نابرابر مقایسه می‌شوند (به‌جز با خودشان) و مقدار هش آن‌ها از :func:`id` آن‌ها مشتق می‌شود."

msgid "IDLE"
msgstr "IDLE"

msgid "An Integrated Development and Learning Environment for Python. :ref:`idle` is a basic editor and interpreter environment which ships with the standard distribution of Python."
msgstr "یک محیط توسعه و یادگیری یکپارچه برای پایتون. :ref:`idle` یک محیط ویرایشگر و مفسر پایه است که همراه با توزیع استاندارد پایتون ارائه می‌شود."

msgid "immortal"
msgstr "نامیرا"

msgid "*Immortal objects* are a CPython implementation detail introduced in :pep:`683`."
msgstr "*اشیای نامیرا* یک جزئیات پیاده‌سازی CPython هستند که در :pep:`683` معرفی شده‌اند."

msgid "If an object is immortal, its :term:`reference count` is never modified, and therefore it is never deallocated while the interpreter is running. For example, :const:`True` and :const:`None` are immortal in CPython."
msgstr "اگر یک شیء نامیرا باشد، :term:`شمارنده‌ی ارجاع <reference count>` آن هرگز تغییر نمی‌کند و بنابراین تا زمانی که مفسر در حال اجرا است، هرگز آزاد نمی‌شود. برای مثال، :const:`True` و :const:`None` در CPython نامیرا هستند."

msgid "Immortal objects can be identified via :func:`sys._is_immortal`, or via :c:func:`PyUnstable_IsImmortal` in the C API."
msgstr "اشیای نامیرا را می‌توان از طریق :func:`sys._is_immortal` یا از طریق :c:func:`PyUnstable_IsImmortal` در API زبان C شناسایی کرد."

msgid "immutable"
msgstr "تغییرناپذیر"

msgid "An object with a fixed value.  Immutable objects include numbers, strings and tuples.  Such an object cannot be altered.  A new object has to be created if a different value has to be stored.  They play an important role in places where a constant hash value is needed, for example as a key in a dictionary.  Immutable objects are inherently :term:`thread-safe` because their state cannot be modified after creation, eliminating concerns about improperly synchronized :term:`concurrent modification`."
msgstr "شیءای با مقدار ثابت. اشیای تغییرناپذیر شامل اعداد، نخ‌ها و تاپل‌ها هستند. چنین شی‌ءای نمی‌تواند تغییر داده شود. اگر لازم باشد مقدار متفاوتی ذخیره شود، باید شیء جدیدی ایجاد شود. آن‌ها در جاهایی که مقدار هش ثابت لازم است، برای مثال به‌عنوان یک کلید در یک دیکشنری، نقش مهمی دارند. اشیای تغییرناپذیر ذاتاً :term:`ایمن برای نخ‌های اجرایی <thread-safe>` هستند، زیرا وضعیت آن‌ها پس از ایجاد قابل تغییر نیست و نگرانی‌ها درباره‌ی :term:`تغییر همزمان <concurrent modification>` که به‌درستی همگام‌سازی نشده است، از بین می‌رود."

msgid "import path"
msgstr "مسیر ایمپورت"

msgid "A list of locations (or :term:`path entries <path entry>`) that are searched by the :term:`path based finder` for modules to import. During import, this list of locations usually comes from :data:`sys.path`, but for subpackages it may also come from the parent package's ``__path__`` attribute."
msgstr "فهرستی از مکان‌ها (یا :term:`ورودی مسیر <path entry>`) که توسط :term:`یابنده‌ی مبتنی بر مسیر <path based finder>` برای ماژول‌های قابل ایمپورت جست‌وجو می‌شود. هنگام ایمپورت، این فهرست از مکان‌ها معمولاً از :data:`sys.path` می‌آید، اما برای زیربسته‌ها ممکن است از ویژگی ``__path__`` بسته‌ی والد نیز به‌دست آید."

msgid "importing"
msgstr "ایمپورت کردن"

msgid "The process by which Python code in one module is made available to Python code in another module."
msgstr "فرایندی که طی آن کد پایتون در یک ماژول برای کد پایتون در ماژولی دیگر در دسترس قرار می‌گیرد."

msgid "importer"
msgstr "ایمپورت‌کننده"

msgid "An object that both finds and loads a module; both a :term:`finder` and :term:`loader` object."
msgstr "شی‌ءای که هم یک ماژول را پیدا می‌کند و هم آن را بارگذاری می‌کند؛ هم یک شیء :term:`یابنده <finder>` و هم یک شیء :term:`بارگذار <loader>`."

msgid "index"
msgstr "اندیس"

msgid "A numeric value that represents the position of an element in a :term:`sequence`."
msgstr "مقداری عددی که موقعیت یک المان را در یک :term:`دنباله <sequence>` نشان می‌دهد."

msgid "In Python, indexing starts at zero. For example, ``things[0]`` names the *first* element of ``things``; ``things[1]`` names the second one."
msgstr "در پایتون، اندیس‌گذاری از صفر شروع می‌شود. برای مثال، ``things[0]`` نخستین المان ``things`` را نام‌گذاری می‌کند؛ ``things[1]`` دومین مورد را نام‌گذاری می‌کند."

msgid "In some contexts, Python allows negative indexes for counting from the end of a sequence, and indexing using :term:`slices <slice>`."
msgstr "در برخی زمینه‌ها، پایتون اجازه می‌دهد از اندیس‌های منفی برای شمارش از انتهای یک دنباله و از اندیس‌گذاری با استفاده از :term:`برش <slice>` استفاده شود."

msgid "See also :term:`subscript`."
msgstr "همچنین :term:`زیرنویس <subscript>` را ببینید."

msgid "interactive"
msgstr "تعاملی"

msgid "Python has an interactive interpreter which means you can enter statements and expressions at the interpreter prompt, immediately execute them and see their results.  Just launch ``python`` with no arguments (possibly by selecting it from your computer's main menu). It is a very powerful way to test out new ideas or inspect modules and packages (remember ``help(x)``). For more on interactive mode, see :ref:`tut-interac`."
msgstr "پایتون یک مفسر تعاملی دارد، یعنی می‌توانید دستورها و عبارت‌ها را در اعلان مفسر وارد کنید، آن‌ها را بلافاصله اجرا کنید و نتایجشان را ببینید. فقط ``python`` را بدون آرگومان اجرا کنید (احتمالاً با انتخاب آن از منوی اصلی رایانه‌ی خود). این روش بسیار قدرتمندی برای آزمایش ایده‌های جدید یا بررسی ماژول‌ها و بسته‌ها است (``help(x)`` را به خاطر داشته باشید). برای اطلاعات بیشتر درباره‌ی حالت تعاملی، :ref:`tut-interac` را ببینید."

msgid "interpreted"
msgstr "تفسیری"

msgid "Python is an interpreted language, as opposed to a compiled one, though the distinction can be blurry because of the presence of the bytecode compiler.  This means that source files can be run directly without explicitly creating an executable which is then run. Interpreted languages typically have a shorter development/debug cycle than compiled ones, though their programs generally also run more slowly.  See also :term:`interactive`."
msgstr "پایتون زبانی تفسیری است، در مقابل زبان‌های کامپایل‌شده، هرچند به‌دلیل وجود کامپایلر بایت‌کد، این تمایز می‌تواند مبهم باشد. این یعنی پرونده‌های منبع را می‌توان بدون ایجاد صریح یک پرونده اجرایی که سپس اجرا شود، مستقیماً اجرا کرد. زبان‌های تفسیری معمولاً چرخه‌ی توسعه/اشکال‌زدایی کوتاه‌تری نسبت به زبان‌های کامپایل‌شده دارند، هرچند برنامه‌های آن‌ها معمولاً کندتر اجرا می‌شوند. همچنین :term:`تعاملی <interactive>` را ببینید."

msgid "interpreter shutdown"
msgstr "خاموشی مفسر"

msgid "When asked to shut down, the Python interpreter enters a special phase where it gradually releases all allocated resources, such as modules and various critical internal structures.  It also makes several calls to the :term:`garbage collector <garbage collection>`. This can trigger the execution of code in user-defined destructors or weakref callbacks. Code executed during the shutdown phase can encounter various exceptions as the resources it relies on may not function anymore (common examples are library modules or the warnings machinery)."
msgstr "هنگامی که از مفسر پایتون خواسته می‌شود خاموش شود، وارد مرحله‌ی ویژه‌ای می‌شود که در آن به‌تدریج همه‌ی منابع تخصیص‌یافته، مانند ماژول‌ها و ساختارهای داخلی مهم مختلف، آزاد می‌شوند. همچنین چندین فراخوانی به :term:`زباله‌روبی <garbage collection>` انجام می‌دهد. این کار می‌تواند اجرای کد در نابودگرهای تعریف‌شده توسط کاربر یا کال‌بک‌های weakref را فعال کند. کدی که در مرحله‌ی خاموشی اجرا می‌شود ممکن است با استثناهای مختلفی روبه‌رو شود، زیرا منابعی که به آن‌ها وابسته است ممکن است دیگر کار نکنند (نمونه‌های رایج شامل ماژول‌های کتابخانه یا سازوکار هشدارها هستند)."

msgid "The main reason for interpreter shutdown is that the ``__main__`` module or the script being run has finished executing."
msgstr "دلیل اصلی خاموشی مفسر این است که ماژول ``__main__`` یا اسکریپتی که در حال اجرا است، اجرای خود را به پایان رسانده است."

msgid "iterable"
msgstr "پیمایش‌پذیر"

msgid "An object capable of returning its members one at a time. Examples of iterables include all sequence types (such as :class:`list`, :class:`str`, and :class:`tuple`) and some non-sequence types like :class:`dict`, :term:`file objects <file object>`, and objects of any classes you define with an :meth:`~object.__iter__` method or with a :meth:`~object.__getitem__` method that implements :term:`sequence` semantics."
msgstr "شیءای که قادر است اعضای خود را یکی‌یکی بازگرداند. نمونه‌هایی از پیمایش‌پذیرها شامل همه‌ی نوع‌های دنباله‌ای (مانند :class:`list`، :class:`str` و :class:`tuple`) و برخی نوع‌های غیرتوالی مانند :class:`dict`، :term:`شیء پرونده <file object>` و اشیای هر کلاسی که شما با متد :meth:`~object.__iter__` یا با متد :meth:`~object.__getitem__` که معناشناسی :term:`دنباله <sequence>` را پیاده‌سازی می‌کند تعریف می‌کنید، هستند."

msgid "Iterables can be used in a :keyword:`for` loop and in many other places where a sequence is needed (:func:`zip`, :func:`map`, ...).  When an iterable object is passed as an argument to the built-in function :func:`iter`, it returns an iterator for the object.  This iterator is good for one pass over the set of values.  When using iterables, it is usually not necessary to call :func:`iter` or deal with iterator objects yourself.  The :keyword:`for` statement does that automatically for you, creating a temporary unnamed variable to hold the iterator for the duration of the loop.  See also :term:`iterator`, :term:`sequence`, and :term:`generator`."
msgstr "پیمایش‌پذیرها را می‌توان در یک حلقه‌ی :keyword:`for` و در بسیاری از مکان‌های دیگری که یک دنباله لازم است (:func:`zip`، :func:`map` و ...) استفاده کرد. هنگامی که یک شیء پیمایش‌پذیر به‌عنوان آرگومان به تابع توکار :func:`iter` داده می‌شود، یک پیمایش‌گر برای آن شیء بازمی‌گرداند. این پیمایش‌گر برای یک بار پیمایش مجموعه‌ی مقادیر مناسب است. هنگام استفاده از پیمایش‌پذیرها، معمولاً لازم نیست خودتان :func:`iter` را فراخوانی کنید یا با اشیای پیمایش‌گر سروکار داشته باشید. دستور :keyword:`for` این کار را به‌طور خودکار برای شما انجام می‌دهد و یک متغیر موقتِ بدون نام ایجاد می‌کند تا در طول حلقه پیمایش‌گر را نگه دارد. همچنین :term:`پیمایش‌گر <iterator>`، :term:`دنباله <sequence>` و :term:`تولیدگر <generator>` را ببینید."

msgid "iterator"
msgstr "پیمایش‌گر"

msgid "An object representing a stream of data.  Repeated calls to the iterator's :meth:`~iterator.__next__` method (or passing it to the built-in function :func:`next`) return successive items in the stream.  When no more data are available a :exc:`StopIteration` exception is raised instead.  At this point, the iterator object is :term:`exhausted` and any further calls to its :meth:`!__next__` method just raise :exc:`StopIteration` again.  Iterators are required to have an :meth:`~iterator.__iter__` method that returns the iterator object itself so every iterator is also iterable and may be used in most places where other iterables are accepted.  One notable exception is code which attempts multiple iteration passes.  A container object (such as a :class:`list`) produces a fresh new iterator each time you pass it to the :func:`iter` function or use it in a :keyword:`for` loop.  Attempting this with an iterator will just return the same exhausted iterator object used in the previous iteration pass, making it appear like an empty container."
msgstr "یک شیء که نمایانگر جریان داده است. فراخوانی‌های مکرر به متد :meth:`~iterator.__next__` پیمایش‌گر (یا پاس دادن آن به تابع توکار :func:`next`) آیتم‌های متوالی در جریان را برمی‌گردانند. وقتی داده بیشتری در دسترس نیست، به جای آن استثنای :exc:`StopIteration` پرتاب می‌شود. در این نقطه، شیء پیمایش‌گر :term:`خالی‌شده <exhausted>` است و هر فراخوانی بیشتر به متد :meth:`!__next__` آن فقط دوباره :exc:`StopIteration` را پرتاب می‌کند. پیمایش‌گرها باید متد :meth:`~iterator.__iter__` داشته باشند که خود شیء پیمایش‌گر را برمی‌گرداند، بنابراین هر پیمایش‌گر همچنین پیمایش‌پذیر است و می‌تواند در اکثر مکان‌هایی که پیمایش‌پذیرهای دیگر پذیرفته می‌شوند، استفاده شود. یک استثنای قابل توجه کدی است که تلاش می‌کند چندین گذر پیمایش انجام دهد. یک شیء ظرف (مانند :class:`list`) هر بار که آن را به تابع :func:`iter` پاس دهید یا در یک حلقه :keyword:`for` از آن استفاده کنید، یک پیمایش‌گر تازه و جدید تولید می‌کند. تلاش برای این کار با یک پیمایش‌گر فقط همان شیء پیمایش‌گر خالی‌شده‌ی استفاده شده در گذر قبلی پیمایش را برمی‌گرداند، که باعث می‌شود مانند یک ظرف خالی به نظر برسد."

msgid "More information can be found in :ref:`typeiter`."
msgstr "اطلاعات بیشتر را می‌توان در :ref:`typeiter` یافت."

msgid "CPython does not consistently apply the requirement that an iterator define :meth:`~iterator.__iter__`. And also please note that :term:`free-threaded <free threading>` CPython does not guarantee :term:`thread-safe` behavior of iterator operations."
msgstr "CPython به‌طور سازگار الزام تعریف متد :meth:`~iterator.__iter__` برای یک پیمایش‌گر را اعمال نمی‌کند. همچنین توجه داشته باشید که CPython :term:`نخ‌گذاری آزاد <free threading>` رفتار :term:`ایمن برای نخ‌های اجرایی <thread-safe>` را برای عملیات پیمایش‌گرها تضمین نمی‌کند."

msgid "key"
msgstr "کلید"

msgid "A value that identifies an entry in a :term:`mapping`. See also :term:`subscript`."
msgstr "مقداری که یک ورودی را در یک :term:`نگاشت <mapping>` شناسایی می‌کند. همچنین :term:`زیرنویس <subscript>` را ببینید."

msgid "key function"
msgstr "تابع کلید"

msgid "A key function or collation function is a callable that returns a value used for sorting or ordering.  For example, :func:`locale.strxfrm` is used to produce a sort key that is aware of locale specific sort conventions."
msgstr "یک تابع کلید یا تابع هم‌ترازی، یک شیء فراخوانی‌پذیر است که مقداری را بازمی‌گرداند که برای مرتب‌سازی یا ترتیب‌دهی استفاده می‌شود. برای مثال، :func:`locale.strxfrm` برای تولید یک کلید مرتب‌سازی که از قراردادهای مرتب‌سازی خاص یک locale آگاه است استفاده می‌شود."

msgid "A number of tools in Python accept key functions to control how elements are ordered or grouped.  They include :func:`min`, :func:`max`, :func:`sorted`, :meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq.nlargest`, and :func:`itertools.groupby`."
msgstr "تعدادی از ابزارهای پایتون، توابع کلید را برای کنترل نحوه‌ی ترتیب‌دهی یا گروه‌بندی المان‌ها می‌پذیرند. این ابزارها شامل :func:`min`، :func:`max`، :func:`sorted`، :meth:`list.sort`، :func:`heapq.merge`، :func:`heapq.nsmallest`، :func:`heapq.nlargest` و :func:`itertools.groupby` هستند."

msgid "There are several ways to create a key function.  For example. the :meth:`str.casefold` method can serve as a key function for case insensitive sorts.  Alternatively, a key function can be built from a :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``.  Also, :func:`operator.attrgetter`, :func:`operator.itemgetter`, and :func:`operator.methodcaller` are three key function constructors.  See the :ref:`Sorting HOW TO <sortinghowto>` for examples of how to create and use key functions."
msgstr "چندین روش برای ایجاد یک تابع کلید وجود دارد. برای مثال، متد :meth:`str.casefold` می‌تواند به‌عنوان یک تابع کلید برای مرتب‌سازی‌های بدون حساسیت به بزرگی و کوچکی حروف استفاده شود. همچنین، یک تابع کلید می‌تواند از یک عبارت :keyword:`lambda` مانند ``lambda r: (r[0], r[2])`` ساخته شود. علاوه بر این، :func:`operator.attrgetter`، :func:`operator.itemgetter` و :func:`operator.methodcaller` سه سازنده‌ی تابع کلید هستند. برای نمونه‌هایی از نحوه‌ی ایجاد و استفاده از توابع کلید، :ref:`Sorting HOW TO <sortinghowto>` را ببینید."

msgid "keyword argument"
msgstr "آرگومان کلیدواژه‌ای"

msgid "See :term:`argument`."
msgstr ":term:`آرگومان <argument>` را ببینید."

msgid "lambda"
msgstr "lambda"

msgid "An anonymous inline function consisting of a single :term:`expression` which is evaluated when the function is called.  The syntax to create a lambda function is ``lambda [parameters]: expression``"
msgstr "یک تابع درون‌خطی بی‌نام که از یک :term:`عبارت <expression>` واحد تشکیل شده است و هنگام فراخوانی تابع ارزیابی می‌شود. سینتکس ایجاد یک تابع lambda به‌صورت ``lambda [parameters]: expression`` است"

msgid "LBYL"
msgstr "LBYL"

msgid "Look before you leap.  This coding style explicitly tests for pre-conditions before making calls or lookups.  This style contrasts with the :term:`EAFP` approach and is characterized by the presence of many :keyword:`if` statements."
msgstr "پیش از جهش نگاه کنید (Look Before You Leap). این سبک کدنویسی پیش‌شرط‌ها را پیش از انجام فراخوانی‌ها یا جست‌وجوها به‌طور صریح آزمایش می‌کند. این سبک در تضاد با رویکرد :term:`EAFP <EAFP>` است و با وجود تعداد زیادی دستور :keyword:`if` شناخته می‌شود."

msgid "In a multi-threaded environment, the LBYL approach can risk introducing a :term:`race condition` between \"the looking\" and \"the leaping\".  For example, the code, ``if key in mapping: return mapping[key]`` can fail if another thread removes *key* from *mapping* after the test, but before the lookup. This issue can be solved with :term:`locks <lock>` or by using the :term:`EAFP` approach.  See also :term:`thread-safe`."
msgstr "در یک محیط چندنخی، رویکرد LBYL می‌تواند خطر ایجاد یک :term:`شرط رقابت <race condition>` بین «نگاه کردن» و «جهش کردن» را به همراه داشته باشد. برای مثال، کد ``if key in mapping: return mapping[key]`` ممکن است شکست بخورد اگر نخ‌ای دیگر پس از آزمون، اما پیش از جست‌وجو، *key* را از *mapping* حذف کند. این مشکل را می‌توان با :term:`قفل <lock>` یا با استفاده از رویکرد :term:`EAFP <EAFP>` حل کرد. همچنین :term:`ایمن برای نخ‌های اجرایی <thread-safe>` را ببینید."

msgid "lexical analyzer"
msgstr "تحلیلگر واژگانی"

msgid "Formal name for the *tokenizer*; see :term:`token`."
msgstr "نام رسمی برای *tokenizer*؛ :term:`توکن <token>` را ببینید."

msgid "list"
msgstr "فهرست"

msgid "A built-in Python :term:`sequence`.  Despite its name it is more akin to an array in other languages than to a linked list since access to elements is *O*\\ (1).  See :ref:`time-complexity`."
msgstr "یک :term:`دنباله <sequence>` درون‌ساخته‌ی پایتون است. با وجود نامِ آن، این بیشتر شبیه به یک آرایه در سایر زبان‌هاست تا به یک فهرست پیوندی، چون دسترسی به المان‌ها *O*\\ (1) است. ببینید :ref:`time-complexity`."

msgid "list comprehension"
msgstr "درک فهرستی"

msgid "A compact way to process all or part of the elements in a sequence and return a list with the results.  ``result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0]`` generates a list of strings containing even hex numbers (0x..) in the range from 0 to 255. The :keyword:`if` clause is optional.  If omitted, all elements in ``range(256)`` are processed."
msgstr "روشی فشرده برای پردازش همه یا بخشی از المان‌های یک دنباله و بازگرداندن یک فهرست با نتایج. ``result = ['{:#04x}'.format(x) for x in range(256) if x % 2 == 0]`` فهرستی از نخ‌ها شامل اعداد مبنای شانزده زوج (0x..) در محدوده‌ی ۰ تا ۲۵۵ تولید می‌کند. بند :keyword:`if` اختیاری است. اگر حذف شود، همه‌ی المان‌های ``range(256)`` پردازش می‌شوند."

msgid "lock"
msgstr "قفل"

msgid "A :term:`synchronization primitive` that allows only one thread at a time to access a shared resource.  A thread must acquire a lock before accessing the protected resource and release it afterward.  If a thread attempts to acquire a lock that is already held by another thread, it will block until the lock becomes available.  Python's :mod:`threading` module provides :class:`~threading.Lock` (a basic lock) and :class:`~threading.RLock` (a :term:`reentrant` lock).  Locks are used to prevent :term:`race conditions <race condition>` and ensure :term:`thread-safe` access to shared data.  Alternative design patterns to locks exist such as queues, producer/consumer patterns, and thread-local state. See also :term:`deadlock`, and :term:`reentrant`."
msgstr "یک :term:`اولیه همگام‌سازی <synchronization primitive>` که در هر زمان فقط به یک نخ اجازه‌ی دسترسی به یک منبع اشتراکی را می‌دهد. یک نخ باید پیش از دسترسی به منبع محافظت‌شده، یک قفل را به‌دست آورد و پس از آن آن را آزاد کند. اگر یک نخ تلاش کند قفلی را به‌دست آورد که پیش‌تر توسط نخ‌ای دیگر در اختیار گرفته شده است، تا زمانی که قفل در دسترس قرار گیرد مسدود می‌شود. ماژول :mod:`threading` پایتون، :class:`~threading.Lock` (یک قفل پایه) و :class:`~threading.RLock` (یک قفل :term:`بازورودپذیر <reentrant>`) را فراهم می‌کند. قفل‌ها برای جلوگیری از :term:`شرط رقابت <race condition>` و تضمین دسترسی :term:`ایمن برای نخ‌های اجرایی <thread-safe>` به داده‌های اشتراکی استفاده می‌شوند. الگوهای طراحی جایگزین برای قفل‌ها وجود دارند، مانند صف‌ها، الگوهای تولیدکننده/مصرف‌کننده و وضعیت محلی نخ. همچنین :term:`بن‌بست <deadlock>` و :term:`بازورودپذیر <reentrant>` را ببینید."

msgid "lock-free"
msgstr "بدون قفل"

msgid "An operation that does not acquire any :term:`lock` and uses atomic CPU instructions to ensure correctness. Lock-free operations can execute concurrently without blocking each other and cannot be blocked by operations that hold locks. In :term:`free-threaded <free threading>` Python, built-in types like :class:`dict` and :class:`list` provide lock-free read operations, which means other threads may observe intermediate states during multi-step modifications even when those modifications hold the :term:`per-object lock`."
msgstr "عملیاتی که هیچ :term:`قفل <lock>`\\ ای به‌دست نمی‌آورد و برای تضمین درستی از دستورهای اتمی CPU استفاده می‌کند. عملیات‌های بدون قفل می‌توانند به‌طور همزمان و بدون مسدود کردن یکدیگر اجرا شوند و نمی‌توانند توسط عملیات‌هایی که قفل‌ها را در اختیار دارند مسدود شوند. در پایتون :term:`نخ‌گذاری آزاد <free threading>`، نوع‌های توکار مانند :class:`dict` و :class:`list` عملیات‌های خواندن بدون قفل ارائه می‌کنند، یعنی نخ‌های دیگر ممکن است در طول تغییرات چندمرحله‌ای، حتی زمانی که آن تغییرات :term:`قفلِ هر شیء <per-object lock>` را نگه داشته‌اند، وضعیت‌های میانی را مشاهده کنند."

msgid "loader"
msgstr "بارگذار"

msgid "An object that loads a module. It must define the :meth:`!exec_module` and :meth:`!create_module` methods to implement the :class:`~importlib.abc.Loader` interface. A loader is typically returned by a :term:`finder`. See also:"
msgstr "شیءای که یک ماژول را بارگذاری می‌کند. برای پیاده‌سازی رابط :class:`~importlib.abc.Loader` باید متدهای :meth:`!exec_module` و :meth:`!create_module` را تعریف کند. یک بارگذار معمولاً توسط یک :term:`یابنده <finder>` بازگردانده می‌شود. همچنین ببینید:"

msgid ":ref:`finders-and-loaders`"
msgstr ":ref:`finders-and-loaders`"

msgid ":class:`importlib.abc.Loader`"
msgstr ":class:`importlib.abc.Loader`"

msgid ":pep:`302`"
msgstr ":pep:`302`"

msgid "locale encoding"
msgstr "کدگذاری locale"

msgid "On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:`locale.setlocale(locale.LC_CTYPE, new_locale) <locale.setlocale>`."
msgstr "در یونیکس، این همان کدگذاری locale LC_CTYPE است. می‌توان آن را با :func:`locale.setlocale(locale.LC_CTYPE, new_locale) <locale.setlocale>` تنظیم کرد."

msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)."
msgstr "در ویندوز، این همان صفحه‌ی کد ANSI است (برای مثال ``\"cp1252\"``)."

msgid "On Android and VxWorks, Python uses ``\"utf-8\"`` as the locale encoding."
msgstr "در Android و VxWorks، پایتون از ``\"utf-8\"`` به‌عنوان کدگذاری locale استفاده می‌کند."

msgid ":func:`locale.getencoding` can be used to get the locale encoding."
msgstr "از :func:`locale.getencoding` می‌توان برای دریافت کدگذاری locale استفاده کرد."

msgid "See also the :term:`filesystem encoding and error handler`."
msgstr "همچنین :term:`کدگذاری سیستم پرونده و هندلر خطا <filesystem encoding and error handler>` را ببینید."

msgid "magic method"
msgstr "متد جادویی"

msgid "An informal synonym for :term:`special method`."
msgstr "یک مترادف غیررسمی برای :term:`متد ویژه <special method>`."

msgid "mapping"
msgstr "نگاشت"

msgid "A container object that supports arbitrary key lookups and implements the methods specified in the :class:`collections.abc.Mapping` or :class:`collections.abc.MutableMapping` :ref:`abstract base classes <collections-abstract-base-classes>`.  Examples include :class:`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict` and :class:`collections.Counter`."
msgstr "یک شیء ظرفی که از جست‌وجوی کلیدهای دلخواه پشتیبانی می‌کند و متدهای مشخص‌شده در :class:`collections.abc.Mapping` یا :class:`collections.abc.MutableMapping` :ref:`abstract base classes <collections-abstract-base-classes>` را پیاده‌سازی می‌کند. نمونه‌ها شامل :class:`dict`، :class:`collections.defaultdict`، :class:`collections.OrderedDict` و :class:`collections.Counter` هستند."

msgid "meta path finder"
msgstr "یابنده‌ی مسیر فراداده"

msgid "A :term:`finder` returned by a search of :data:`sys.meta_path`.  Meta path finders are related to, but different from :term:`path entry finders <path entry finder>`."
msgstr "یک :term:`یابنده <finder>` که از جست‌وجوی :data:`sys.meta_path` بازگردانده می‌شود. یابنده‌های مسیر فراداده با :term:`یابنده‌ی ورودی مسیر <path entry finder>` مرتبط هستند، اما با آن‌ها تفاوت دارند."

msgid "See :class:`importlib.abc.MetaPathFinder` for the methods that meta path finders implement."
msgstr "برای متدهایی که یابنده‌های مسیر فراداده پیاده‌سازی می‌کنند، :class:`importlib.abc.MetaPathFinder` را ببینید."

msgid "metaclass"
msgstr "فراکلاس"

msgid "The class of a class.  Class definitions create a class name, a class dictionary, and a list of base classes.  The metaclass is responsible for taking those three arguments and creating the class.  Most object oriented programming languages provide a default implementation.  What makes Python special is that it is possible to create custom metaclasses.  Most users never need this tool, but when the need arises, metaclasses can provide powerful, elegant solutions.  They have been used for logging attribute access, adding thread-safety, tracking object creation, implementing singletons, and many other tasks."
msgstr "کلاس یک کلاس. تعریف‌های کلاس یک نام کلاس، یک دیکشنری کلاس و یک فهرست از کلاس‌های پایه ایجاد می‌کنند. فراکلاس مسئول دریافت این سه آرگومان و ایجاد کلاس است. بیشتر زبان‌های برنامه‌نویسی شیءگرا یک پیاده‌سازی پیش‌فرض ارائه می‌کنند. چیزی که پایتون را ویژه می‌کند این است که امکان ایجاد فراکلاس‌های سفارشی وجود دارد. بیشتر کاربران هرگز به این ابزار نیاز پیدا نمی‌کنند، اما هنگامی که نیاز به آن پیش بیاید، فراکلاس‌ها می‌توانند راه‌حل‌های قدرتمند و ظریفی ارائه دهند. از آن‌ها برای ثبت دسترسی به ویژگی‌ها، افزودن ایمنی نخ‌ای، پیگیری ایجاد شیء، پیاده‌سازی تک‌نمونه‌ها و بسیاری کارهای دیگر استفاده شده است."

msgid "More information can be found in :ref:`metaclasses`."
msgstr "اطلاعات بیشتر را می‌توان در :ref:`metaclasses` یافت."

msgid "method"
msgstr "متد"

msgid "A function which is defined inside a class body.  If called as an attribute of an instance of that class, the method will get the instance object as its first :term:`argument` (which is usually called ``self``). See :term:`function` and :term:`nested scope`."
msgstr "تابعی که درون بدنه‌ی یک کلاس تعریف شده است. اگر به‌عنوان یک ویژگی از یک نمونه‌ی آن کلاس فراخوانی شود، متد شیء نمونه را به‌عنوان نخستین :term:`آرگومان <argument>` خود دریافت می‌کند (که معمولاً ``self`` نامیده می‌شود). :term:`تابع <function>` و :term:`محدوده‌ی تودرتو <nested scope>` را ببینید."

msgid "method resolution order"
msgstr "ترتیب حل متد"

msgid "Method Resolution Order is the order in which base classes are searched for a member during lookup. See :ref:`python_2.3_mro` for details of the algorithm used by the Python interpreter since the 2.3 release."
msgstr "ترتیب حل متد، ترتیبی است که در آن کلاس‌های پایه هنگام جست‌وجوی یک عضو بررسی می‌شوند. برای جزئیات الگوریتمی که مفسر پایتون از انتشار ۲.۳ به بعد استفاده می‌کند، :ref:`python_2.3_mro` را ببینید."

msgid "module"
msgstr "ماژول"

msgid "An object that serves as an organizational unit of Python code.  Modules have a namespace containing arbitrary Python objects.  Modules are loaded into Python by the process of :term:`importing`."
msgstr "شیءای که به‌عنوان واحد سازمان‌دهی کد پایتون عمل می‌کند. ماژول‌ها یک فضای نام دارند که شامل اشیای دلخواه پایتون است. ماژول‌ها از طریق فرایند :term:`ایمپورت کردن <importing>` در پایتون بارگذاری می‌شوند."

msgid "See also :term:`package`."
msgstr "همچنین :term:`بسته <package>` را ببینید."

msgid "module spec"
msgstr "مشخصات ماژول"

msgid "A namespace containing the import-related information used to load a module. An instance of :class:`importlib.machinery.ModuleSpec`."
msgstr "فضای نامی که شامل اطلاعات مرتبط با ایمپورت است و برای بارگذاری یک ماژول استفاده می‌شود. یک نمونه از :class:`importlib.machinery.ModuleSpec`."

msgid "See also :ref:`module-specs`."
msgstr "همچنین :ref:`module-specs` را ببینید."

msgid "MRO"
msgstr "MRO"

msgid "See :term:`method resolution order`."
msgstr ":term:`ترتیب حل متد <method resolution order>` را ببینید."

msgid "mutable"
msgstr "تغییرپذیر"

msgid "An :term:`object` with state that is allowed to change during the course of the program.  In multi-threaded programs, mutable objects that are shared between threads require careful synchronization to avoid :term:`race conditions <race condition>`.  See also :term:`immutable`, :term:`thread-safe`, and :term:`concurrent modification`."
msgstr "یک :term:`شیء <object>` که وضعیت آن در طول اجرای برنامه اجازه‌ی تغییر دارد. در برنامه‌های چندنخی، اشیای تغییرپذیری که بین نخ‌ها اشتراک‌گذاری می‌شوند، برای جلوگیری از :term:`شرط رقابت <race condition>` به همگام‌سازی دقیق نیاز دارند. همچنین :term:`تغییرناپذیر <immutable>`، :term:`ایمن برای نخ‌های اجرایی <thread-safe>` و :term:`تغییر همزمان <concurrent modification>` را ببینید."

msgid "named tuple"
msgstr "تاپل نام‌دار"

msgid "The term \"named tuple\" applies to any type or class that inherits from tuple and whose indexable elements are also accessible using named attributes.  The type or class may have other features as well."
msgstr "اصطلاح «تاپل نام‌دار» برای هر نوع یا کلاسی به‌کار می‌رود که از tuple ارث‌بری می‌کند و المان‌های قابل دسترسی با اندیس آن، با استفاده از ویژگی‌های نام‌دار نیز قابل دسترسی هستند. این نوع یا کلاس ممکن است ویژگی‌های دیگری نیز داشته باشد."

msgid "Several built-in types are named tuples, including the values returned by :func:`time.localtime` and :func:`os.stat`.  Another example is :data:`sys.float_info`::"
msgstr "چندین نوع توکار، تاپل نام‌دار هستند، از جمله مقادیری که توسط :func:`time.localtime` و :func:`os.stat` بازگردانده می‌شوند. نمونه‌ی دیگر :data:`sys.float_info` است::"

msgid ""
">>> sys.float_info[1]                   # indexed access\n"
"1024\n"
">>> sys.float_info.max_exp              # named field access\n"
"1024\n"
">>> isinstance(sys.float_info, tuple)   # kind of tuple\n"
"True"
msgstr ""
">>> sys.float_info[1]                   # indexed access\n"
"1024\n"
">>> sys.float_info.max_exp              # named field access\n"
"1024\n"
">>> isinstance(sys.float_info, tuple)   # kind of tuple\n"
"True"

msgid "Some named tuples are built-in types (such as the above examples). Alternatively, a named tuple can be created from a regular class definition that inherits from :class:`tuple` and that defines named fields.  Such a class can be written by hand, or it can be created by inheriting :class:`typing.NamedTuple`, or with the factory function :func:`collections.namedtuple`.  The latter techniques also add some extra methods that may not be found in hand-written or built-in named tuples."
msgstr "برخی تاپل‌های نام‌دار، نوع‌های توکار هستند (مانند نمونه‌های بالا). روش دیگر، ایجاد یک تاپل نام‌دار از طریق یک تعریف کلاس معمولی است که از :class:`tuple` ارث‌بری می‌کند و فیلدهای نام‌دار را تعریف می‌کند. چنین کلاسی را می‌توان به‌صورت دستی نوشت، یا با ارث‌بری از :class:`typing.NamedTuple`، یا با تابع کارخانه‌ی :func:`collections.namedtuple` ایجاد کرد. دو روش اخیر همچنین چند متد اضافی اضافه می‌کنند که ممکن است در تاپل‌های نام‌دار دست‌نویس یا توکار وجود نداشته باشند."

msgid "namespace"
msgstr "فضای نام"

msgid "The place where a variable is stored.  Namespaces are implemented as dictionaries.  There are the local, global and built-in namespaces as well as nested namespaces in objects (in methods).  Namespaces support modularity by preventing naming conflicts.  For instance, the functions :func:`builtins.open <.open>` and :func:`os.open` are distinguished by their namespaces.  Namespaces also aid readability and maintainability by making it clear which module implements a function.  For instance, writing :func:`random.seed` or :func:`itertools.islice` makes it clear that those functions are implemented by the :mod:`random` and :mod:`itertools` modules, respectively."
msgstr "محلی که یک متغیر در آن ذخیره می‌شود. فضای نامها به‌صورت دیکشنری پیاده‌سازی می‌شوند. فضای نام های محلی، سراسری و توکار، همچنین فضای نام های تودرتو در اشیا (در متدها) وجود دارند. فضای نامها با جلوگیری از تداخل نام‌ها، پیمانه‌ای بودن را پشتیبانی می‌کنند. برای نمونه، توابع :func:`builtins.open <.open>` و :func:`os.open` با استفاده از فضای نام های خود از یکدیگر متمایز می‌شوند. فضای نامها همچنین با مشخص کردن اینکه کدام ماژول یک تابع را پیاده‌سازی می‌کند، به خوانایی و نگه‌داری‌پذیری کمک می‌کنند. برای نمونه، نوشتن :func:`random.seed` یا :func:`itertools.islice` مشخص می‌کند که این توابع به‌ترتیب توسط ماژول‌های :mod:`random` و :mod:`itertools` پیاده‌سازی شده‌اند."

msgid "namespace package"
msgstr "بسته‌ی فضای نام"

msgid "A :term:`package` which serves only as a container for subpackages. Namespace packages may have no physical representation, and specifically are not like a :term:`regular package` because they have no ``__init__.py`` file."
msgstr "یک :term:`بسته <package>` که فقط به‌عنوان ظرفی برای زیربسته‌ها عمل می‌کند. بسته‌های فضای نام ممکن است نمایش فیزیکی نداشته باشند و به‌طور مشخص مانند یک :term:`بسته‌ی معمولی <regular package>` نیستند، زیرا پرونده ``__init__.py`` ندارند."

msgid "Namespace packages allow several individually installable packages to have a common parent package. Otherwise, it is recommended to use a :term:`regular package`."
msgstr "بسته‌های فضای نام به چندین بسته‌ی قابل نصب مستقل اجازه می‌دهند که یک بسته‌ی والد مشترک داشته باشند. در غیر این صورت، توصیه می‌شود از یک :term:`بسته‌ی معمولی <regular package>` استفاده کنید."

msgid "For more information, see :pep:`420` and :ref:`reference-namespace-package`."
msgstr "برای اطلاعات بیشتر، :pep:`420` و :ref:`reference-namespace-package` را ببینید."

msgid "See also :term:`module`."
msgstr "همچنین :term:`ماژول <module>` را ببینید."

msgid "native code"
msgstr "کد بومی"

msgid "Code that is compiled to machine instructions and runs directly on the processor, as opposed to code that is interpreted or runs in a virtual machine.  In the context of Python, native code typically refers to C, C++, Rust or Fortran code in :term:`extension modules <extension module>` that can be called from Python.  See also :term:`extension module`."
msgstr "کدی که به دستورهای ماشین کامپایل شده و مستقیماً روی پردازنده اجرا می‌شود، برخلاف کدی که تفسیر می‌شود یا در یک ماشین مجازی اجرا می‌شود. در زمینه‌ی پایتون، کد بومی معمولاً به کد C، C++، Rust یا Fortran در :term:`ماژول توسعه‌ای <extension module>` اشاره دارد که می‌توانند از پایتون فراخوانی شوند. همچنین :term:`ماژول توسعه‌ای <extension module>` را ببینید."

msgid "nested scope"
msgstr "محدوده‌ی تودرتو"

msgid "The ability to refer to a variable in an enclosing definition.  For instance, a function defined inside another function can refer to variables in the outer function.  Note that nested scopes by default work only for reference and not for assignment.  Local variables both read and write in the innermost scope.  Likewise, global variables read and write to the global namespace.  The :keyword:`nonlocal` allows writing to outer scopes."
msgstr "توانایی ارجاع به یک متغیر در یک تعریف دربرگیرنده. برای مثال، تابعی که داخل تابع دیگری تعریف شده است می‌تواند به متغیرهای تابع بیرونی دسترسی داشته باشد. توجه کنید که محدوده‌های تودرتو به‌صورت پیش‌فرض فقط برای ارجاع دادن و نه برای انتساب کار می‌کنند. متغیرهای محلی هم در نزدیک‌ترین محدوده خوانده و نوشته می‌شوند. به همین ترتیب، متغیرهای سراسری از فضای نام سراسری خوانده و در آن نوشته می‌شوند. کلیدواژه‌ی :keyword:`nonlocal` امکان نوشتن در محدوده‌های بیرونی را فراهم می‌کند."

msgid "new-style class"
msgstr "کلاس سبک جدید"

msgid "Old name for the flavor of classes now used for all class objects.  In earlier Python versions, only new-style classes could use Python's newer, versatile features like :attr:`~object.__slots__`, descriptors, properties, :meth:`~object.__getattribute__`, class methods, and static methods."
msgstr "نام قدیمی برای گونه‌ای از کلاس‌ها که اکنون برای همه‌ی اشیای کلاس استفاده می‌شود. در نسخه‌های قدیمی‌تر پایتون، فقط کلاس‌های سبک جدید می‌توانستند از قابلیت‌های جدیدتر و انعطاف‌پذیر پایتون مانند :attr:`~object.__slots__`، توصیف‌گرها، ویژگی‌ها، :meth:`~object.__getattribute__`، متدهای کلاس و متدهای ایستا استفاده کنند."

msgid "non-deterministic"
msgstr "غیرقطعی"

msgid "Behavior where the outcome of a program can vary between executions with the same inputs.  In multi-threaded programs, non-deterministic behavior often results from :term:`race conditions <race condition>` where the relative timing or interleaving of threads affects the result. Proper synchronization using :term:`locks <lock>` and other :term:`synchronization primitives <synchronization primitive>` helps ensure deterministic behavior."
msgstr "رفتاری که در آن نتیجه‌ی یک برنامه می‌تواند بین اجراهای مختلف با ورودی‌های یکسان متفاوت باشد. در برنامه‌های چندنخی، رفتار غیرقطعی اغلب از :term:`شرط رقابت <race condition>` ناشی می‌شود که در آن زمان‌بندی نسبی یا درهم‌تنیدگی نخ‌ها بر نتیجه تأثیر می‌گذارد. همگام‌سازی مناسب با استفاده از :term:`قفل <lock>` و دیگر :term:`اولیه همگام‌سازی <synchronization primitive>` به تضمین رفتار قطعی کمک می‌کند."

msgid "object"
msgstr "شیء"

msgid "Any data with state (attributes or value) and defined behavior (methods).  Also the ultimate base class of any :term:`new-style class`."
msgstr "هر داده‌ای با وضعیت (ویژگی‌ها یا مقدار) و رفتار تعریف‌شده (متدها). همچنین کلاس پایه‌ی نهایی هر :term:`کلاس سبک جدید <new-style class>`."

msgid "optimized scope"
msgstr "محدوده‌ی بهینه‌شده"

msgid "A scope where target local variable names are reliably known to the compiler when the code is compiled, allowing optimization of read and write access to these names. The local namespaces for functions, generators, coroutines, comprehensions, and generator expressions are optimized in this fashion. Note: most interpreter optimizations are applied to all scopes, only those relying on a known set of local and nonlocal variable names are restricted to optimized scopes."
msgstr "محدوده‌ای که در آن نام‌های متغیرهای محلی هدف هنگام کامپایل کد به‌طور قابل اطمینانی برای کامپایلر شناخته شده‌اند و امکان بهینه‌سازی دسترسی خواندن و نوشتن به این نام‌ها فراهم می‌شود. فضای نام های محلی برای توابع، تولیدگرها، هم‌روال‌ها، درک‌ها و عبارت‌های تولیدگر به این روش بهینه می‌شوند. توجه کنید: بیشتر بهینه‌سازی‌های مفسر روی همه‌ی محدوده‌ها اعمال می‌شوند؛ تنها بهینه‌سازی‌هایی که به مجموعه‌ی شناخته‌شده‌ای از نام‌های متغیرهای محلی و غیرمحلی وابسته هستند، به محدوده‌های بهینه‌شده محدود می‌شوند."

msgid "optional module"
msgstr "ماژول اختیاری"

msgid "An :term:`extension module` that is part of the :term:`standard library`, but may be absent in some builds of :term:`CPython`, usually due to missing third-party libraries or because the module is not available for a given platform."
msgstr "یک :term:`ماژول توسعه‌ای <extension module>` که بخشی از :term:`کتابخانه‌ی استاندارد <standard library>` است، اما ممکن است در برخی ساخت‌های :term:`CPython <CPython>` وجود نداشته باشد؛ معمولاً به دلیل نبود کتابخانه‌های شخص ثالث یا در دسترس نبودن ماژول برای یک سکوی مشخص."

msgid "See :ref:`optional-module-requirements` for a list of optional modules that require third-party libraries."
msgstr "برای فهرستی از ماژول‌های اختیاری که به کتابخانه‌های شخص ثالث نیاز دارند، :ref:`optional-module-requirements` را ببینید."

msgid "package"
msgstr "بسته"

msgid "A Python :term:`module` which can contain submodules or recursively, subpackages.  Technically, a package is a Python module with a ``__path__`` attribute."
msgstr "یک :term:`ماژول <module>` پایتون که می‌تواند شامل زیرماژول‌ها یا به‌صورت بازگشتی، زیربسته‌ها باشد. از نظر فنی، یک بسته یک ماژول پایتون با ویژگی ``__path__`` است."

msgid "See also :term:`regular package` and :term:`namespace package`."
msgstr "همچنین :term:`بسته‌ی معمولی <regular package>` و :term:`بسته‌ی فضای نام <namespace package>` را ببینید."

msgid "parallelism"
msgstr "موازی‌سازی"

msgid "Executing multiple operations at the same time (e.g. on multiple CPU cores).  In Python builds with the :term:`global interpreter lock (GIL) <global interpreter lock>`, only one thread runs Python bytecode at a time, so taking advantage of multiple CPU cores typically involves multiple processes (e.g. :mod:`multiprocessing`) or native extensions that release the GIL. In :term:`free-threaded <free threading>` Python, multiple Python threads can run Python code simultaneously on different cores."
msgstr "اجرای چندین عملیات در یک زمان (برای مثال روی چند هسته‌ی CPU). در ساخت‌های پایتون با :term:`قفل مفسر سراسری <global interpreter lock>`، تنها یک نخ در هر لحظه بایت‌کد پایتون را اجرا می‌کند، بنابراین بهره‌گیری از چند هسته‌ی CPU معمولاً شامل چند فرایند (برای مثال :mod:`multiprocessing`) یا افزونه‌های بومی است که GIL را آزاد می‌کنند. در پایتون :term:`نخ‌گذاری آزاد <free threading>`، چندین نخ پایتون می‌توانند به‌طور همزمان کد پایتون را روی هسته‌های مختلف اجرا کنند."

msgid "parameter"
msgstr "پارامتر"

msgid "A named entity in a :term:`function` (or method) definition that specifies an :term:`argument` (or in some cases, arguments) that the function can accept.  There are five kinds of parameter:"
msgstr "یک موجودیت نام‌گذاری‌شده در تعریف یک :term:`تابع <function>` (یا متد) که یک :term:`آرگومان <argument>` (یا در برخی موارد، آرگومان‌ها) را مشخص می‌کند که تابع می‌تواند بپذیرد. پنج نوع پارامتر وجود دارد:"

msgid ":dfn:`positional-or-keyword`: specifies an argument that can be passed either :term:`positionally <argument>` or as a :term:`keyword argument <argument>`.  This is the default kind of parameter, for example *foo* and *bar* in the following::"
msgstr ":dfn:`positional-or-keyword`: آرگومانی را مشخص می‌کند که می‌تواند به‌صورت :term:`آرگومان جایگاهی <argument>` یا به‌عنوان یک :term:`آرگومان کلیدواژه‌ای <argument>` ارسال شود. این نوع پیش‌فرض پارامتر است، برای مثال *foo* و *bar* در موارد زیر::"

msgid "def func(foo, bar=None): ..."
msgstr "def func(foo, bar=None): ..."

msgid ":dfn:`positional-only`: specifies an argument that can be supplied only by position. Positional-only parameters can be defined by including a ``/`` character in the parameter list of the function definition after them, for example *posonly1* and *posonly2* in the following::"
msgstr ":dfn:`positional-only`: آرگومانی را مشخص می‌کند که فقط می‌تواند بر اساس جایگاه ارائه شود. پارامترهای فقط-جایگاهی را می‌توان با قرار دادن یک نویسه‌ی ``/`` در فهرست پارامترهای تعریف تابع پس از آن‌ها تعریف کرد، برای مثال *posonly1* و *posonly2* در موارد زیر::"

msgid "def func(posonly1, posonly2, /, positional_or_keyword): ..."
msgstr "def func(posonly1, posonly2, /, positional_or_keyword): ..."

msgid ":dfn:`keyword-only`: specifies an argument that can be supplied only by keyword.  Keyword-only parameters can be defined by including a single var-positional parameter or bare ``*`` in the parameter list of the function definition before them, for example *kw_only1* and *kw_only2* in the following::"
msgstr ":dfn:`keyword-only`: آرگومانی را مشخص می‌کند که فقط می‌تواند با کلیدواژه ارسال شود. پارامترهای فقط کلیدواژه‌ای را می‌توان با قرار دادن یک پارامتر var-positional یا ``*`` بدون نام در فهرست پارامترهای تعریف تابع پیش از آن‌ها تعریف کرد، برای مثال *kw_only1* و *kw_only2* در موارد زیر::"

msgid "def func(arg, *, kw_only1, kw_only2): ..."
msgstr "def func(arg, *, kw_only1, kw_only2): ..."

msgid ":dfn:`var-positional`: specifies that an arbitrary sequence of positional arguments can be provided (in addition to any positional arguments already accepted by other parameters).  Such a parameter can be defined by prepending the parameter name with ``*``, for example *args* in the following::"
msgstr ":dfn:`var-positional`: مشخص می‌کند که یک دنباله‌ی دلخواه از آرگومان‌های جایگاهی می‌تواند ارائه شود (علاوه بر هر آرگومان جایگاهی که پیش‌تر توسط پارامترهای دیگر پذیرفته شده است). چنین پارامتری را می‌توان با افزودن ``*`` به ابتدای نام پارامتر تعریف کرد، برای مثال *args* در موارد زیر::"

msgid "def func(*args, **kwargs): ..."
msgstr "def func(*args, **kwargs): ..."

msgid ":dfn:`var-keyword`: specifies that arbitrarily many keyword arguments can be provided (in addition to any keyword arguments already accepted by other parameters).  Such a parameter can be defined by prepending the parameter name with ``**``, for example *kwargs* in the example above."
msgstr ":dfn:`var-keyword`: مشخص می‌کند که تعداد دلخواهی از آرگومان‌های کلیدواژه‌ای می‌تواند ارائه شود (علاوه بر هر آرگومان کلیدواژه‌ای که پیش‌تر توسط پارامترهای دیگر پذیرفته شده است). چنین پارامتری را می‌توان با افزودن ``**`` به ابتدای نام پارامتر تعریف کرد، برای مثال *kwargs* در مثال بالا."

msgid "Parameters can specify both optional and required arguments, as well as default values for some optional arguments."
msgstr "پارامترها می‌توانند هم آرگومان‌های اختیاری و ضروری، و هم مقدارهای پیش‌فرض برای برخی آرگومان‌های اختیاری را مشخص کنند."

msgid "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the difference between arguments and parameters <faq-argument-vs-parameter>`, the :class:`inspect.Parameter` class, the :ref:`function` section, and :pep:`362`."
msgstr "همچنین مدخل واژه‌نامه‌ی :term:`آرگومان <argument>`، پرسش متداول درباره‌ی :ref:`تفاوت بین آرگومان‌ها و پارامترها <faq-argument-vs-parameter>`، کلاس :class:`inspect.Parameter`، بخش :ref:`تابع <function>` و :pep:`362` را ببینید."

msgid "per-object lock"
msgstr "قفلِ هر شیء"

msgid "A :term:`lock` associated with an individual object instance rather than a global lock shared across all objects. In :term:`free-threaded <free threading>` Python, built-in types like :class:`dict` and :class:`list` use per-object locks to allow concurrent operations on different objects while serializing operations on the same object. Operations that hold the per-object lock prevent other locking operations on the same object from proceeding, but do not block :term:`lock-free` operations."
msgstr "یک :term:`قفل <lock>` مرتبط با یک نمونه‌ی شیء منفرد، به‌جای یک قفل سراسری که بین همه‌ی اشیا اشتراک‌گذاری شده باشد. در پایتون :term:`نخ‌گذاری آزاد <free threading>`، نوع‌های توکار مانند :class:`dict` و :class:`list` از قفل‌های هر شیء استفاده می‌کنند تا امکان عملیات همزمان روی اشیای مختلف را فراهم کنند، در حالی که عملیات روی همان شیء را به‌صورت ترتیبی اجرا می‌کنند. عملیات‌هایی که قفل هر شیء را نگه می‌دارند، از ادامه‌ی دیگر عملیات‌های قفل‌کننده روی همان شیء جلوگیری می‌کنند، اما عملیات‌های :term:`بدون قفل <lock-free>` را مسدود نمی‌کنند."

msgid "path entry"
msgstr "ورودی مسیر"

msgid "A single location on the :term:`import path` which the :term:`path based finder` consults to find modules for importing."
msgstr "یک مکان منفرد در :term:`ایمپورت مسیر <import path>` که :term:`یابنده‌ی مبتنی بر مسیر <path based finder>` برای یافتن ماژول‌ها جهت ایمپورت بررسی می‌کند."

msgid "path entry finder"
msgstr "یابنده‌ی ورودی مسیر"

msgid "A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. a :term:`path entry hook`) which knows how to locate modules given a :term:`path entry`."
msgstr "یک :term:`یابنده <finder>` که توسط یک فراخوانی‌پذیر در :data:`sys.path_hooks` (یعنی یک :term:`قلاب ورودی مسیر <path entry hook>`) بازگردانده می‌شود و می‌داند چگونه با داشتن یک :term:`ورودی مسیر <path entry>`، ماژول‌ها را پیدا کند."

msgid "See :class:`importlib.abc.PathEntryFinder` for the methods that path entry finders implement."
msgstr "برای متدهایی که یابنده‌های ورودی مسیر پیاده‌سازی می‌کنند، :class:`importlib.abc.PathEntryFinder` را ببینید."

msgid "path entry hook"
msgstr "قلاب ورودی مسیر"

msgid "A callable on the :data:`sys.path_hooks` list which returns a :term:`path entry finder` if it knows how to find modules on a specific :term:`path entry`."
msgstr "یک فراخوانی‌پذیر در فهرست :data:`sys.path_hooks` که اگر بداند چگونه ماژول‌ها را در یک :term:`ورودی مسیر <path entry>` مشخص پیدا کند، یک :term:`یابنده‌ی ورودی مسیر <path entry finder>` بازمی‌گرداند."

msgid "path based finder"
msgstr "یابنده‌ی مبتنی بر مسیر"

msgid "One of the default :term:`meta path finders <meta path finder>` which searches an :term:`import path` for modules."
msgstr "یکی از :term:`یابنده‌ی مسیر فراداده <meta path finder>` پیش‌فرض که یک :term:`ایمپورت مسیر <import path>` را برای یافتن ماژول‌ها جست‌وجو می‌کند."

msgid "path-like object"
msgstr "شیء شبه‌مسیر"

msgid "An object representing a file system path. A path-like object is either a :class:`str` or :class:`bytes` object representing a path, or an object implementing the :class:`os.PathLike` protocol. An object that supports the :class:`os.PathLike` protocol can be converted to a :class:`str` or :class:`bytes` file system path by calling the :func:`os.fspath` function; :func:`os.fsdecode` and :func:`os.fsencode` can be used to guarantee a :class:`str` or :class:`bytes` result instead, respectively. Introduced by :pep:`519`."
msgstr "شی‌ءای که یک مسیر سامانه‌ی پرونده را نمایش می‌دهد. یک شیء شبه‌مسیر یا یک شیء :class:`str` یا :class:`bytes` است که یک مسیر را نمایش می‌دهد، یا شی‌ءای است که پروتکل :class:`os.PathLike` را پیاده‌سازی می‌کند. شی‌ءای که از پروتکل :class:`os.PathLike` پشتیبانی می‌کند، می‌تواند با فراخوانی تابع :func:`os.fspath` به یک مسیر سامانه‌ی پرونده :class:`str` یا :class:`bytes` تبدیل شود؛ :func:`os.fsdecode` و :func:`os.fsencode` می‌توانند به‌ترتیب برای تضمین نتیجه‌ی :class:`str` یا :class:`bytes` استفاده شوند. معرفی‌شده در :pep:`519`."

msgid "PEP"
msgstr "PEP"

msgid "Python Enhancement Proposal. A PEP is a design document providing information to the Python community, or describing a new feature for Python or its processes or environment. PEPs should provide a concise technical specification and a rationale for proposed features."
msgstr "پیشنهاد بهبود پایتون. یک PEP یک سند طراحی است که اطلاعاتی را برای کامیونیتی پایتون ارائه می‌کند، یا یک ویژگی جدید برای پایتون، فرایندهای آن یا محیط آن را توصیف می‌کند. PEPها باید یک مشخصات فنی مختصر و یک منطق برای ویژگی‌های پیشنهادی ارائه کنند."

msgid "PEPs are intended to be the primary mechanisms for proposing major new features, for collecting community input on an issue, and for documenting the design decisions that have gone into Python. The PEP author is responsible for building consensus within the community and documenting dissenting opinions."
msgstr "PEP ها برای این طراحی شده‌اند که سازوکارهای اصلی پیشنهاد ویژگی‌های بزرگ جدید، جمع‌آوری نظرهای کامیونیتی درباره‌ی یک موضوع و مستندسازی تصمیم‌های طراحی گرفته‌شده برای پایتون باشند. نویسنده‌ی PEP مسئول ایجاد توافق در کامیونیتی و مستندسازی دیدگاه‌های مخالف است."

msgid "See :pep:`1`."
msgstr ":pep:`1` را ببینید."

msgid "portion"
msgstr "بخش"

msgid "A set of files in a single directory (possibly stored in a zip file) that contribute to a namespace package, as defined in :pep:`420`."
msgstr "مجموعه‌ای از پرونده‌ها در یک پوشه‌ی واحد (که ممکن است در یک پرونده zip ذخیره شده باشند) که در یک بسته‌ی فضای نام، همان‌طور که در :pep:`420` تعریف شده است، مشارکت می‌کنند."

msgid "positional argument"
msgstr "آرگومان جایگاهی"

msgid "provisional API"
msgstr "API موقت"

msgid "A provisional API is one which has been deliberately excluded from the standard library's backwards compatibility guarantees.  While major changes to such interfaces are not expected, as long as they are marked provisional, backwards incompatible changes (up to and including removal of the interface) may occur if deemed necessary by core developers.  Such changes will not be made gratuitously -- they will occur only if serious fundamental flaws are uncovered that were missed prior to the inclusion of the API."
msgstr "یک API موقت، رابطی است که به‌طور عمدی از تضمین‌های سازگاری روبه‌عقب کتابخانه‌ی استاندارد خارج شده است. با اینکه تغییرات بزرگ در چنین رابط‌هایی انتظار نمی‌رود، تا زمانی که موقت علامت‌گذاری شده باشند، اگر توسعه‌دهندگان اصلی آن را ضروری بدانند، تغییرات ناسازگار با نسخه‌های پیشین (تا حذف کامل رابط نیز) ممکن است رخ دهد. چنین تغییراتی بدون دلیل انجام نخواهند شد؛ آن‌ها تنها در صورتی رخ می‌دهند که نقص‌های بنیادی و جدی‌ای کشف شوند که پیش از اضافه شدن API از آن‌ها چشم‌پوشی شده بود."

msgid "Even for provisional APIs, backwards incompatible changes are seen as a \"solution of last resort\" - every attempt will still be made to find a backwards compatible resolution to any identified problems."
msgstr "حتی برای APIهای موقت، تغییرات ناسازگار با نسخه‌های پیشین به‌عنوان «راه‌حل آخر» در نظر گرفته می‌شوند؛ همچنان هر تلاشی برای یافتن راه‌حلی سازگار با نسخه‌های پیشین برای مشکلات شناسایی‌شده انجام خواهد شد."

msgid "This process allows the standard library to continue to evolve over time, without locking in problematic design errors for extended periods of time.  See :pep:`411` for more details."
msgstr "این فرایند به کتابخانه‌ی استاندارد اجازه می‌دهد در طول زمان به تکامل خود ادامه دهد، بدون اینکه خطاهای طراحی مشکل‌ساز را برای دوره‌های طولانی تثبیت کند. برای جزئیات بیشتر، :pep:`411` را ببینید."

msgid "provisional package"
msgstr "بسته‌ی موقت"

msgid "See :term:`provisional API`."
msgstr ":term:`API موقت <provisional API>` را ببینید."

msgid "Python 3000"
msgstr "پایتون ۳۰۰۰"

msgid "Nickname for the Python 3.x release line (coined long ago when the release of version 3 was something in the distant future.)  This is also abbreviated \"Py3k\"."
msgstr "نام مستعار برای خط انتشار Python ۳.x (که مدت‌ها پیش، زمانی که انتشار نسخه‌ی ۳ چیزی در آینده‌ی دور بود، ساخته شد.) این عبارت همچنین به‌صورت «Py3k» کوتاه می‌شود."

msgid "Pythonic"
msgstr "پایتونی"

msgid "An idea or piece of code which closely follows the most common idioms of the Python language, rather than implementing code using concepts common to other languages.  For example, a common idiom in Python is to loop over all elements of an iterable using a :keyword:`for` statement.  Many other languages don't have this type of construct, so people unfamiliar with Python sometimes use a numerical counter instead::"
msgstr "ایده یا بخشی از کد که به‌جای پیاده‌سازی با مفاهیم رایج در زبان‌های دیگر، به‌طور نزدیک از شیوه‌های رایج زبان پایتون پیروی می‌کند. برای مثال، یک شیوه‌ی رایج در پایتون این است که با استفاده از دستور :keyword:`for` روی همه‌ی المان‌های یک پیمایش‌پذیر حلقه زده شود. بسیاری از زبان‌های دیگر چنین ساختاری ندارند، بنابراین افرادی که با پایتون آشنا نیستند گاهی به‌جای آن از یک شمارنده‌ی عددی استفاده می‌کنند::"

msgid ""
"for i in range(len(food)):\n"
"    print(food[i])"
msgstr ""
"for i in range(len(food)):\n"
"    print(food[i])"

msgid "As opposed to the cleaner, Pythonic method::"
msgstr "در مقابل، روش تمیزتر و پایتونی::"

msgid ""
"for piece in food:\n"
"    print(piece)"
msgstr ""
"for piece in food:\n"
"    print(piece)"

msgid "qualified name"
msgstr "نام کامل"

msgid "A dotted name showing the \"path\" from a module's global scope to a class, function or method defined in that module, as defined in :pep:`3155`.  For top-level functions and classes, the qualified name is the same as the object's name::"
msgstr "نامی نقطه‌گذاری‌شده که «مسیر» از محدوده‌ی سراسری یک ماژول تا یک کلاس، تابع یا متد تعریف‌شده در آن ماژول را نشان می‌دهد، همان‌طور که در :pep:`3155` تعریف شده است. برای توابع و کلاس‌های سطح بالا، نام کامل همان نام شیء است::"

msgid ""
">>> class C:\n"
"...     class D:\n"
"...         def meth(self):\n"
"...             pass\n"
"...\n"
">>> C.__qualname__\n"
"'C'\n"
">>> C.D.__qualname__\n"
"'C.D'\n"
">>> C.D.meth.__qualname__\n"
"'C.D.meth'"
msgstr ""
">>> class C:\n"
"...     class D:\n"
"...         def meth(self):\n"
"...             pass\n"
"...\n"
">>> C.__qualname__\n"
"'C'\n"
">>> C.D.__qualname__\n"
"'C.D'\n"
">>> C.D.meth.__qualname__\n"
"'C.D.meth'"

msgid "When used to refer to modules, the *fully qualified name* means the entire dotted path to the module, including any parent packages, e.g. ``email.mime.text``::"
msgstr "هنگامی که برای اشاره به ماژول‌ها استفاده می‌شود، *نام کامل* به معنای کل مسیر نقطه‌گذاری‌شده به ماژول است که شامل هر بسته‌ی والد نیز می‌شود، برای مثال ``email.mime.text``::"

msgid ""
">>> import email.mime.text\n"
">>> email.mime.text.__name__\n"
"'email.mime.text'"
msgstr ""
">>> import email.mime.text\n"
">>> email.mime.text.__name__\n"
"'email.mime.text'"

msgid "race condition"
msgstr "شرط رقابت"

msgid "A condition of a program where the behavior depends on the relative timing or ordering of events, particularly in multi-threaded programs.  Race conditions can lead to :term:`non-deterministic` behavior and bugs that are difficult to reproduce.  A :term:`data race` is a specific type of race condition involving unsynchronized access to shared memory.  The :term:`LBYL` coding style is particularly susceptible to race conditions in multi-threaded code.  Using :term:`locks <lock>` and other :term:`synchronization primitives <synchronization primitive>` helps prevent race conditions."
msgstr "شرایطی در یک برنامه که در آن رفتار به زمان‌بندی نسبی یا ترتیب رویدادها وابسته است، به‌ویژه در برنامه‌های چندنخی. شرایط رقابت می‌توانند به رفتار :term:`غیرقطعی <non-deterministic>` و خطاهایی منجر شوند که بازتولید آن‌ها دشوار است. یک :term:`رقابت داده <data race>` نوع خاصی از شرط رقابت است که شامل دسترسی بدون همگام‌سازی به حافظه‌ی اشتراکی می‌شود. سبک کدنویسی :term:`LBYL <LBYL>` در کد چندنخی به‌طور ویژه در برابر شرایط رقابت آسیب‌پذیر است. استفاده از :term:`قفل <lock>` و دیگر :term:`اولیه‌های همگام‌سازی <synchronization primitive>` به جلوگیری از شرایط رقابت کمک می‌کند."

msgid "reference count"
msgstr "شمارنده‌ی ارجاع"

msgid "The number of references to an object.  When the reference count of an object drops to zero, it is deallocated.  Some objects are :term:`immortal` and have reference counts that are never modified, and therefore the objects are never deallocated.  Reference counting is generally not visible to Python code, but it is a key element of the :term:`CPython` implementation.  Programmers can call the :func:`sys.getrefcount` function to return the reference count for a particular object."
msgstr "تعداد ارجاع‌ها به یک شیء. هنگامی که تعداد ارجاع‌های یک شیء به صفر کاهش یابد، آن شیء از حافظه آزاد می‌شود. برخی اشیاء :term:`نامیرا <immortal>` هستند و تعداد ارجاع‌های آن‌ها هرگز تغییر نمی‌کند و بنابراین این اشیاء هرگز از حافظه آزاد نمی‌شوند. شمارش ارجاع‌ها عموماً برای کد پایتون قابل مشاهده نیست، اما یکی از عناصر کلیدی پیاده‌سازی :term:`CPython <CPython>` است. برنامه‌نویسان می‌توانند تابع :func:`sys.getrefcount` را فراخوانی کنند تا تعداد ارجاع‌های یک شیء خاص را برگرداند."

msgid "In :term:`CPython`, reference counts are not considered to be stable or well-defined values; the number of references to an object, and how that number is affected by Python code, may be different between versions."
msgstr "در :term:`CPython <CPython>`، تعداد ارجاع‌ها مقادیر پایدار یا به‌خوبی تعریف‌شده‌ای در نظر گرفته نمی‌شوند؛ تعداد ارجاع‌ها به یک شیء و نحوه تأثیرپذیری این تعداد از کد پایتون ممکن است بین نسخه‌ها متفاوت باشد."

msgid "regular package"
msgstr "بسته‌ی معمولی"

msgid "A traditional :term:`package`, such as a directory containing an ``__init__.py`` file."
msgstr "یک :term:`بسته <package>` سنتی، مانند پوشه‌ای که شامل یک پرونده ``__init__.py`` است."

msgid "See also :term:`namespace package`."
msgstr "همچنین :term:`بسته‌ی فضای نام <namespace package>` را ببینید."

msgid "reentrant"
msgstr "بازورودپذیر"

msgid "A property of a function or :term:`lock` that allows it to be called or acquired multiple times by the same thread without causing errors or a :term:`deadlock`."
msgstr "ویژگی یک تابع یا :term:`قفل <lock>` که به آن اجازه می‌دهد بدون ایجاد خطا یا یک :term:`بن‌بست <deadlock>`، چندین بار توسط یک نخ اجرایی یکسان فراخوانی یا دریافت شود."

msgid "For functions, reentrancy means the function can be safely called again before a previous invocation has completed, which is important when functions may be called recursively or from signal handlers. Thread-unsafe functions may be :term:`non-deterministic` if they're called reentrantly in a multithreaded program."
msgstr "در مورد توابع، بازورودپذیری به این معناست که می‌توان تابع را پیش از کامل‌شدن یک فراخوانی قبلی، دوباره با ایمنی فراخوانی کرد؛ این موضوع زمانی اهمیت دارد که توابع ممکن است به‌صورت بازگشتی یا از درون دستگردان‌های سیگنال فراخوانی شوند. توابع ناایمن برای نخ‌های اجرایی ممکن است در صورتی که در یک برنامه‌ی چندنخی به‌صورت بازورودپذیر فراخوانی شوند، :term:`غیرقطعی <non-deterministic>` باشند."

msgid "For locks, Python's :class:`threading.RLock` (reentrant lock) is reentrant, meaning a thread that already holds the lock can acquire it again without blocking.  In contrast, :class:`threading.Lock` is not reentrant - attempting to acquire it twice from the same thread will cause a deadlock."
msgstr "در مورد قفل‌ها، :class:`threading.RLock` پایتون (قفل بازورودپذیر) بازورودپذیر است؛ یعنی نخ اجرایی‌ای که از پیش قفل را در اختیار دارد، می‌تواند دوباره آن را دریافت کند، بدون آنکه مسدود شود. در مقابل، :class:`threading.Lock` بازورودپذیر نیست؛ تلاش برای دریافت آن دو بار از همان نخ اجرایی باعث یک بن‌بست می‌شود."

msgid "See also :term:`lock` and :term:`deadlock`."
msgstr "همچنین :term:`قفل <lock>` و :term:`بن‌بست <deadlock>` را ببینید."

msgid "REPL"
msgstr "REPL"

msgid "An acronym for the \"read–eval–print loop\", another name for the :term:`interactive` interpreter shell."
msgstr "سرواژه‌ی «read–eval–print loop» و نام دیگری برای پوسته‌ی مفسر :term:`تعاملی <interactive>` است."

msgid "__slots__"
msgstr "__slots__"

msgid "A declaration inside a class that saves memory by pre-declaring space for instance attributes and eliminating instance dictionaries.  Though popular, the technique is somewhat tricky to get right and is best reserved for rare cases where there are large numbers of instances in a memory-critical application."
msgstr "یک اعلان درون یک کلاس که با پیش‌اعلام فضای موردنیاز برای ویژگی‌های نمونه و حذف دیکشنری‌های نمونه، در حافظه صرفه‌جویی می‌کند. با وجود محبوبیت این روش، پیاده‌سازی درست آن تا حدی دشوار است و بهتر است آن را به موارد نادری محدود کنید که تعداد نمونه‌ها زیاد است و برنامه از نظر حافظه حساس است."

msgid "sequence"
msgstr "دنباله"

msgid "An :term:`iterable` which supports efficient element access using integer indices via the :meth:`~object.__getitem__` special method and defines a :meth:`~object.__len__` method that returns the length of the sequence. Some built-in sequence types are :class:`list`, :class:`str`, :class:`tuple`, and :class:`bytes`. Note that :class:`dict` also supports :meth:`~object.__getitem__` and :meth:`!__len__`, but is considered a mapping rather than a sequence because the lookups use arbitrary :term:`hashable` keys rather than integers."
msgstr "یک :term:`پیمایش‌پذیر <iterable>` که از دسترسی کارآمد به المان‌ها با استفاده از اندیس‌های عدد صحیح از طریق متد ویژه‌ی :meth:`~object.__getitem__` پشتیبانی می‌کند و متد :meth:`~object.__len__` را تعریف می‌کند که طول دنباله را برمی‌گرداند. برخی از انواع دنباله‌ی توکار عبارت‌اند از :class:`list`، :class:`str`، :class:`tuple` و :class:`bytes`. توجه کنید که :class:`dict` نیز از :meth:`~object.__getitem__` و :meth:`!__len__` پشتیبانی می‌کند، اما به‌جای دنباله، نگاشت در نظر گرفته می‌شود، زیرا جست‌وجوها از کلیدهای :term:`قابل درهم‌سازی <hashable>` دلخواه به‌جای اعداد صحیح استفاده می‌کنند."

msgid "The :class:`collections.abc.Sequence` abstract base class defines a much richer interface that goes beyond just :meth:`~object.__getitem__` and :meth:`~object.__len__`, adding :meth:`~sequence.count`, :meth:`~sequence.index`, :meth:`~object.__contains__`, and :meth:`~object.__reversed__`. Types that implement this expanded interface can be registered explicitly using :func:`~abc.ABCMeta.register`. For more documentation on sequence methods generally, see :ref:`Common Sequence Operations <typesseq-common>`."
msgstr "کلاس پایه‌ی انتزاعی :class:`collections.abc.Sequence` رابط بسیار غنی‌تری را تعریف می‌کند که فراتر از صرفاً :meth:`~object.__getitem__` و :meth:`~object.__len__` است و :meth:`~sequence.count`، :meth:`~sequence.index`، :meth:`~object.__contains__` و :meth:`~object.__reversed__` را نیز اضافه می‌کند. نوع‌هایی که این رابط گسترش‌یافته را پیاده‌سازی می‌کنند، می‌توانند به‌طور صریح با استفاده از :func:`~abc.ABCMeta.register` ثبت شوند. برای مستندات بیشتر درباره‌ی متدهای دنباله به‌طور کلی، :ref:`Common Sequence Operations <typesseq-common>` را ببینید."

msgid "set comprehension"
msgstr "درک مجموعه‌ای"

msgid "A compact way to process all or part of the elements in an iterable and return a set with the results. ``results = {c for c in 'abracadabra' if c not in 'abc'}`` generates the set of strings ``{'r', 'd'}``.  See :ref:`comprehensions`."
msgstr "روشی فشرده برای پردازش همه یا بخشی از المان‌های یک پیمایش‌پذیر و بازگرداندن یک مجموعه با نتایج. ``results = {c for c in 'abracadabra' if c not in 'abc'}`` مجموعه‌ای از رشته‌ها به‌شکل ``{'r', 'd'}`` تولید می‌کند. :ref:`comprehensions` را ببینید."

msgid "single dispatch"
msgstr "توزیع تک‌گانه"

msgid "A form of :term:`generic function` dispatch where the implementation is chosen based on the type of a single argument."
msgstr "نوعی توزیع :term:`تابع عام <generic function>` که در آن پیاده‌سازی بر اساس نوع یک آرگومان واحد انتخاب می‌شود."

msgid "slice"
msgstr "برش"

msgid "An object of type :class:`slice`, used to describe a portion of a :term:`sequence`. A slice object is created when using the :ref:`slicing <slicings>` form of :ref:`subscript notation <subscriptions>`, with colons inside square brackets, such as in ``variable_name[1:3:5]``."
msgstr "یک شیء از نوع :class:`slice` که برای توصیف بخشی از یک :term:`دنباله <sequence>` استفاده می‌شود. یک شیء برش هنگام استفاده از شکل :ref:`slicing <slicings>` در :ref:`نمادگذاری زیرنویسی <subscriptions>`، با دو نقطه درون کروشه‌ها، مانند ``variable_name[1:3:5]``، ایجاد می‌شود."

msgid "soft deprecated"
msgstr "منسوخ‌سازی نرم"

msgid "A soft deprecated API should not be used in new code, but it is safe for already existing code to use it. The API remains documented and tested, but will not be enhanced further."
msgstr "از یک API که به‌صورت منسوخ‌سازی نرم علامت‌گذاری شده است نباید در کد جدید استفاده شود، اما استفاده از آن در کدهای موجود ایمن است. این API همچنان مستندسازی و آزمایش می‌شود، اما دیگر بهبود داده نخواهد شد."

msgid "Soft deprecation, unlike normal deprecation, does not plan on removing the API and will not emit warnings."
msgstr "منسوخ‌سازی نرم، برخلاف منسوخ‌سازی معمولی، قصد حذف API را ندارد و هیچ هشداری نیز ایجاد نمی‌کند."

msgid "See `PEP 387: Soft Deprecation <https://peps.python.org/pep-0387/#soft-deprecation>`_."
msgstr "`PEP 387: Soft Deprecation <https://peps.python.org/pep-0387/#soft-deprecation>`_ را نیز ببینید."

msgid "special method"
msgstr "متد ویژه"

msgid "A method that is called implicitly by Python to execute a certain operation on a type, such as addition.  Such methods have names starting and ending with double underscores.  Special methods are documented in :ref:`specialnames`."
msgstr "متدی که به‌طور ضمنی توسط پایتون فراخوانی می‌شود تا عملیاتی خاص را روی یک نوع، مانند جمع، اجرا کند. نام این متدها با دو زیرخط آغاز و با دو زیرخط پایان می‌یابد. متدهای ویژه در :ref:`specialnames` مستند شده‌اند."

msgid "standard library"
msgstr "کتابخانه‌ی استاندارد"

msgid "The collection of :term:`packages <package>`, :term:`modules <module>` and :term:`extension modules <extension module>` distributed as a part of the official Python interpreter package.  The exact membership of the collection may vary based on platform, available system libraries, or other criteria.  Documentation can be found at :ref:`library-index`."
msgstr "مجموعه‌ای از :term:`بسته <package>`، :term:`ماژول <module>` و :term:`ماژول افزونه <extension module>` که به‌عنوان بخشی از بسته‌ی رسمی مفسر پایتون توزیع می‌شوند. اعضای دقیق این مجموعه ممکن است بر اساس سکو، کتابخانه‌های سیستمی موجود یا معیارهای دیگر متفاوت باشند. مستندات آن را می‌توانید در :ref:`library-index` پیدا کنید."

msgid "See also :data:`sys.stdlib_module_names` for a list of all possible standard library module names."
msgstr "همچنین :data:`sys.stdlib_module_names` را برای فهرستی از همه‌ی نام‌های ممکن ماژول‌های کتابخانه‌ی استاندارد ببینید."

msgid "statement"
msgstr "دستور"

msgid "A statement is part of a suite (a \"block\" of code).  A statement is either an :term:`expression` or one of several constructs with a keyword, such as :keyword:`if`, :keyword:`while` or :keyword:`for`."
msgstr "دستور بخشی از یک بدنه (یک «بلوک» کد) است. یک دستور یا یک :term:`عبارت <expression>` است یا یکی از چند ساختار دارای کلیدواژه، مانند :keyword:`if`، :keyword:`while` یا :keyword:`for`."

msgid "static type checker"
msgstr "بررسی‌گر نوع ایستا"

msgid "An external tool that reads Python code and analyzes it, looking for issues such as incorrect types. See also :term:`type hints <type hint>` and the :mod:`typing` module."
msgstr "یک ابزار خارجی که کد پایتون را می‌خواند و آن را تحلیل می‌کند و به‌دنبال مشکلاتی مانند نوع‌های نادرست می‌گردد. همچنین :term:`راهنمای نوع <type hint>` و ماژول :mod:`typing` را ببینید."

msgid "stdlib"
msgstr "stdlib"

msgid "An abbreviation of :term:`standard library`."
msgstr "شکل کوتاه‌شده‌ی :term:`کتابخانه‌ی استاندارد <standard library>`."

msgid "steal"
msgstr "دزدیدن"

msgid "In Python's C API, \"*stealing*\" an argument means that ownership of the argument is transferred to the called function. The caller must not use that reference after the call. Generally, functions that \"steal\" an argument do so even if they fail."
msgstr "در C API پایتون، «دزدیدن» یک آرگومان به این معناست که مالکیت آرگومان به تابع فراخوانی‌شده منتقل می‌شود. فراخواننده نباید پس از فراخوانی از آن ارجاع استفاده کند. به‌طور کلی، توابعی که یک آرگومان را «می‌دزدند»، این کار را حتی در صورت شکست نیز انجام می‌دهند."

msgid "See :ref:`api-refcountdetails` for a full explanation."
msgstr "برای توضیح کامل، بخش :ref:`api-refcountdetails` را ببینید."

msgid "strong reference"
msgstr "ارجاع قوی"

msgid "In Python's C API, a strong reference is a reference to an object which is owned by the code holding the reference.  The strong reference is taken by calling :c:func:`Py_INCREF` when the reference is created and released with :c:func:`Py_DECREF` when the reference is deleted."
msgstr "در API زبان C پایتون، ارجاع قوی ارجاعی به یک شیء است که کدی که ارجاع را در اختیار دارد، مالک آن است. ارجاع قوی هنگام ایجاد ارجاع با فراخوانی :c:func:`Py_INCREF` گرفته می‌شود و هنگام حذف ارجاع با :c:func:`Py_DECREF` آزاد می‌شود."

msgid "The :c:func:`Py_NewRef` function can be used to create a strong reference to an object. Usually, the :c:func:`Py_DECREF` function must be called on the strong reference before exiting the scope of the strong reference, to avoid leaking one reference."
msgstr "از تابع :c:func:`Py_NewRef` می‌توان برای ایجاد یک ارجاع قوی به یک شیء استفاده کرد. معمولاً باید تابع :c:func:`Py_DECREF` پیش از خروج از محدوده‌ی ارجاع قوی، روی آن فراخوانی شود تا از نشت یک ارجاع جلوگیری شود."

msgid "See also :term:`borrowed reference`."
msgstr "همچنین :term:`ارجاع قرض‌گرفته‌شده <borrowed reference>` را ببینید."

msgid "subscript"
msgstr "زیرنویس"

msgid "The expression in square brackets of a :ref:`subscription expression <subscriptions>`, for example, the ``3`` in ``items[3]``. Usually used to select an element of a container. Also called a :term:`key` when subscripting a :term:`mapping`, or an :term:`index` when subscripting a :term:`sequence`."
msgstr "عبارت درون کروشه‌های یک :ref:`نمادگذاری زیرنویسی <subscriptions>`، برای مثال ``3`` در ``items[3]``. معمولاً برای انتخاب یک المان از یک ظرف استفاده می‌شود. هنگام زیرنویس‌گذاری یک :term:`نگاشت <mapping>`، به آن :term:`کلید <key>` نیز گفته می‌شود و هنگام زیرنویس‌گذاری یک :term:`دنباله <sequence>`، به آن :term:`اندیس <index>` گفته می‌شود."

msgid "synchronization primitive"
msgstr "اولیه همگام‌سازی"

msgid "A basic building block for coordinating (synchronizing) the execution of multiple threads to ensure :term:`thread-safe` access to shared resources. Python's :mod:`threading` module provides several synchronization primitives including :class:`~threading.Lock`, :class:`~threading.RLock`, :class:`~threading.Semaphore`, :class:`~threading.Condition`, :class:`~threading.Event`, and :class:`~threading.Barrier`.  Additionally, the :mod:`queue` module provides multi-producer, multi-consumer queues that are especially useful in multithreaded programs. These primitives help prevent :term:`race conditions <race condition>` and coordinate thread execution.  See also :term:`lock`."
msgstr "یک سازه‌ی پایه برای هماهنگ‌سازی اجرای چند نخ اجرایی، با هدف اطمینان از دسترسی :term:`ایمن برای نخ‌های اجرایی <thread-safe>` به منابع مشترک. ماژول :mod:`threading` پایتون چندین اولیه‌ی همگام‌سازی، از جمله :class:`~threading.Lock`، :class:`~threading.RLock`، :class:`~threading.Semaphore`، :class:`~threading.Condition`، :class:`~threading.Event` و :class:`~threading.Barrier` را فراهم می‌کند. افزون بر این، ماژول :mod:`queue` صف‌های چندتولیدکننده، چندمصرف‌کننده‌ای را فراهم می‌کند که به‌ویژه در برنامه‌های چندنخی مفید هستند. این اولیه‌ها به جلوگیری از :term:`شرط رقابت <race condition>` و هماهنگ‌سازی اجرای نخ‌های اجرایی کمک می‌کنند. همچنین :term:`قفل <lock>` را ببینید."

msgid "t-string"
msgstr "تی‌استرینگ"

msgid "t-strings"
msgstr "تی‌استرینگ‌ها"

msgid "String literals prefixed with ``t`` or ``T`` are commonly called \"t-strings\" which is short for :ref:`template string literals <t-strings>`."
msgstr "مقادیر لفظی رشته‌ای که با ``t`` یا ``T`` پیشوندگذاری شده‌اند، معمولاً «t-string» نامیده می‌شوند که شکل کوتاه‌شده‌ی :ref:`تی‌استرینگ‌ها <t-strings>` است."

msgid "text encoding"
msgstr "کدگذاری متن"

msgid "A string in Python is a sequence of Unicode code points (in range ``U+0000``--``U+10FFFF``). To store or transfer a string, it needs to be serialized as a sequence of bytes."
msgstr "یک رشته در پایتون دنباله‌ای از نقاط کد یونیکد است (در محدوده‌ی ``U+0000``--``U+10FFFF``). برای ذخیره یا انتقال یک رشته، لازم است آن را به‌صورت دنباله‌ای از بایت‌ها سریال‌سازی کرد."

msgid "Serializing a string into a sequence of bytes is known as \"encoding\", and recreating the string from the sequence of bytes is known as \"decoding\"."
msgstr "سریال‌سازی یک رشته به‌صورت دنباله‌ای از بایت‌ها «کدگذاری» نامیده می‌شود و بازسازی رشته از دنباله‌ی بایت‌ها «کدگشایی» نام دارد."

msgid "There are a variety of different text serialization :ref:`codecs <standard-encodings>`, which are collectively referred to as \"text encodings\"."
msgstr "انواع مختلفی از :ref:`codecs <standard-encodings>` برای سریال‌سازی متن وجود دارند که در مجموع «کدگذاری‌های متن» نامیده می‌شوند."

msgid "text file"
msgstr "پرونده متنی"

msgid "A :term:`file object` able to read and write :class:`str` objects. Often, a text file actually accesses a byte-oriented datastream and handles the :term:`text encoding` automatically. Examples of text files are files opened in text mode (``'r'`` or ``'w'``), :data:`sys.stdin`, :data:`sys.stdout`, and instances of :class:`io.StringIO`."
msgstr "یک :term:`شیء پرونده <file object>` که می‌تواند اشیای :class:`str` را بخواند و بنویسد. یک پرونده متنی اغلب در واقع به یک جریان داده‌ی بایت‌محور دسترسی دارد و :term:`کدگذاری متن <text encoding>` را به‌طور خودکار مدیریت می‌کند. نمونه‌هایی از پرونده‌های متنی، پرونده‌هایی هستند که در حالت متنی باز شده‌اند (``'r'`` یا ``'w'``)، :data:`sys.stdin`، :data:`sys.stdout` و نمونه‌های :class:`io.StringIO`."

msgid "See also :term:`binary file` for a file object able to read and write :term:`bytes-like objects <bytes-like object>`."
msgstr "همچنین برای یک شیء پرونده که می‌تواند :term:`شیء شبه‌بایت <bytes-like object>` را بخواند و بنویسد، :term:`پرونده دودویی <binary file>` را ببینید."

msgid "thread state"
msgstr "وضعیت نخ اجرایی"

msgid "The information used by the :term:`CPython` runtime to run in an OS thread. For example, this includes the current exception, if any, and the state of the bytecode interpreter."
msgstr "اطلاعاتی که :term:`CPython <CPython>` ران‌تایم برای اجرا در یک نخ اجرایی سیستم‌عامل استفاده می‌کند. برای مثال، این اطلاعات شامل استثنای فعلی، در صورت وجود، و وضعیت مفسر بایت‌کد است."

msgid "Each thread state is bound to a single OS thread, but threads may have many thread states available.  At most, one of them may be :term:`attached <attached thread state>` at once."
msgstr "هر وضعیت نخ اجرایی به یک نخ اجرایی سیستم‌عامل واحد وابسته است، اما نخ‌های اجرایی ممکن است وضعیت‌های نخ اجرایی متعددی در دسترس داشته باشند. در هر لحظه حداکثر یکی از آن‌ها می‌تواند :term:`وضعیت نخ متصل <attached thread state>` باشد."

msgid "An :term:`attached thread state` is required to call most of Python's C API, unless a function explicitly documents otherwise. The bytecode interpreter only runs under an attached thread state."
msgstr "برای فراخوانی بیشتر API زبان C پایتون، یک :term:`وضعیت نخ متصل <attached thread state>` لازم است، مگر اینکه تابعی صراحتاً خلاف آن را مستند کرده باشد. مفسر بایت‌کد فقط در یک وضعیت نخ اجرایی پیوست‌شده اجرا می‌شود."

msgid "Each thread state belongs to a single interpreter, but each interpreter may have many thread states, including multiple for the same OS thread. Thread states from multiple interpreters may be bound to the same thread, but only one can be :term:`attached <attached thread state>` in that thread at any given moment."
msgstr "هر وضعیت نخ اجرایی به یک مفسر واحد تعلق دارد، اما هر مفسر ممکن است وضعیت‌های نخ اجرایی متعددی داشته باشد، از جمله چند وضعیت برای یک نخ اجرایی سیستم‌عامل یکسان. وضعیت‌های نخ اجرایی از مفسرهای متعدد ممکن است به یک نخ اجرایی یکسان وابسته باشند، اما در هر لحظه فقط یکی از آن‌ها می‌تواند در آن نخ اجرایی :term:`وضعیت نخ متصل <attached thread state>` باشد."

msgid "See :ref:`Thread State and the Global Interpreter Lock <threads>` for more information."
msgstr "برای اطلاعات بیشتر، :ref:`Thread State and the Global Interpreter Lock <threads>` را ببینید."

msgid "thread-safe"
msgstr "ایمن برای نخ‌های اجرایی"

msgid "A module, function, or class that behaves correctly when used by multiple threads concurrently.  Thread-safe code uses appropriate :term:`synchronization primitives <synchronization primitive>` like :term:`locks <lock>` to protect shared mutable state, or is designed to avoid shared mutable state entirely.  In the :term:`free-threaded <free threading>` build, built-in types like :class:`dict`, :class:`list`, and :class:`set` use internal locking to make many operations thread-safe, although thread safety is not necessarily guaranteed.  Code that is not thread-safe may experience :term:`race conditions <race condition>` and :term:`data races <data race>` when used in multi-threaded programs."
msgstr "یک ماژول، تابع یا کلاس که هنگام استفاده‌ی همزمان توسط چند نخ اجرایی، به‌درستی رفتار می‌کند. کد ایمن برای نخ‌های اجرایی از :term:`اولیه همگام‌سازی <synchronization primitive>` مناسب، مانند :term:`قفل <lock>`، برای محافظت از وضعیت تغییرپذیر مشترک استفاده می‌کند یا به‌گونه‌ای طراحی شده است که به‌طور کامل از وضعیت تغییرپذیر مشترک اجتناب کند. در ساخت :term:`نخ‌گذاری آزاد <free threading>`، نوع‌های توکار مانند :class:`dict`، :class:`list` و :class:`set` از قفل‌گذاری داخلی برای ایمن‌کردن بسیاری از عملیات در برابر اجرای همزمان نخ‌های اجرایی استفاده می‌کنند، هرچند ایمنی در برابر نخ‌های اجرایی لزوماً تضمین‌شده نیست. کدی که برای نخ‌های اجرایی ایمن نیست، هنگام استفاده در برنامه‌های چندنخی ممکن است دچار :term:`شرط رقابت <race condition>` و :term:`رقابت داده <data race>` شود."

msgid "token"
msgstr "توکن"

msgid "A small unit of source code, generated by the :ref:`lexical analyzer <lexical>` (also called the *tokenizer*). Names, numbers, strings, operators, newlines and similar are represented by tokens."
msgstr "واحد کوچکی از کد منبع که توسط :ref:`lexical analyzer <lexical>` (که *tokenizer* نیز نامیده می‌شود) تولید می‌شود. نام‌ها، اعداد، رشته‌ها، عملگرها، نویسه‌های خط جدید و موارد مشابه به‌صورت توکن نمایش داده می‌شوند."

msgid "The :mod:`tokenize` module exposes Python's lexical analyzer. The :mod:`token` module contains information on the various types of tokens."
msgstr "ماژول :mod:`tokenize` تحلیل‌گر واژگانی پایتون را در دسترس قرار می‌دهد. ماژول :mod:`token` حاوی اطلاعاتی درباره‌ی انواع مختلف توکن‌ها است."

msgid "triple-quoted string"
msgstr "رشته‌ی سه‌نقل‌قولی"

msgid "A string which is bound by three instances of either a quotation mark (\") or an apostrophe (').  While they don't provide any functionality not available with single-quoted strings, they are useful for a number of reasons.  They allow you to include unescaped single and double quotes within a string and they can span multiple lines without the use of the continuation character, making them especially useful when writing docstrings."
msgstr "رشته‌ای که با سه نمونه از یکی از علامت‌های نقل‌قول (\") یا آپاستروف (') محصور شده است. با اینکه این رشته‌ها قابلیت جدیدی فراتر از رشته‌های تک‌نقل‌قولی فراهم نمی‌کنند، به دلایل متعددی مفید هستند. آن‌ها به شما اجازه می‌دهند علامت‌های نقل‌قول تکی و دوتایی را بدون خنثی‌سازی درون یک رشته قرار دهید و می‌توانند بدون استفاده از نویسه‌ی ادامه‌ی خط، چندین خط را دربر بگیرند؛ بنابراین هنگام نوشتن رشته مستندات به‌ویژه مفید هستند."

msgid "type"
msgstr "نوع"

msgid "The type of a Python object determines what kind of object it is; every object has a type.  An object's type is accessible as its :attr:`~object.__class__` attribute or can be retrieved with ``type(obj)``."
msgstr "نوع یک شیء پایتون تعیین می‌کند که آن شیء از چه نوعی است؛ هر شیء یک نوع دارد. نوع یک شیء به‌عنوان ویژگی :attr:`~object.__class__` آن در دسترس است یا می‌توان آن را با ``type(obj)`` به‌دست آورد."

msgid "type alias"
msgstr "نام مستعار نوع"

msgid "A synonym for a type, created by assigning the type to an identifier."
msgstr "مترادفی برای یک نوع که با نسبت‌دادن نوع به یک شناسه ایجاد می‌شود."

msgid "Type aliases are useful for simplifying :term:`type hints <type hint>`. For example::"
msgstr "نام‌های مستعار نوع برای ساده‌سازی :term:`راهنمای نوع <type hint>` مفید هستند. برای مثال::"

msgid ""
"def remove_gray_shades(\n"
"        colors: list[tuple[int, int, int]]) -> list[tuple[int, int, int]]:\n"
"    pass"
msgstr ""
"def remove_gray_shades(\n"
"        colors: list[tuple[int, int, int]]) -> list[tuple[int, int, int]]:\n"
"    pass"

msgid "could be made more readable like this::"
msgstr "می‌توانست به این شکل خواناتر شود::"

msgid ""
"Color = tuple[int, int, int]\n"
"\n"
"def remove_gray_shades(colors: list[Color]) -> list[Color]:\n"
"    pass"
msgstr ""
"Color = tuple[int, int, int]\n"
"\n"
"def remove_gray_shades(colors: list[Color]) -> list[Color]:\n"
"    pass"

msgid "See :mod:`typing` and :pep:`484`, which describe this functionality."
msgstr "برای توضیح این قابلیت، :mod:`typing` و :pep:`484` را ببینید."

msgid "type hint"
msgstr "راهنمای نوع"

msgid "An :term:`annotation` that specifies the expected type for a variable, a class attribute, or a function parameter or return value."
msgstr "یک :term:`حاشیه‌گذاری <annotation>` که نوع مورد انتظار برای یک متغیر، یک ویژگی کلاس، یا یک پارامتر یا مقدار بازگشتی تابع را مشخص می‌کند."

msgid "Type hints are optional and are not enforced by Python but they are useful to :term:`static type checkers <static type checker>`. They can also aid IDEs with code completion and refactoring."
msgstr "راهنماهای نوع اختیاری هستند و پایتون آن‌ها را اعمال نمی‌کند، اما برای :term:`بررسی‌گر نوع ایستا <static type checker>` مفید هستند. آن‌ها همچنین می‌توانند به IDEها در تکمیل کد و بازآرایی کد کمک کنند."

msgid "Type hints of global variables, class attributes, and functions, but not local variables, can be accessed using :func:`typing.get_type_hints`."
msgstr "راهنماهای نوع متغیرهای سراسری، ویژگی‌های کلاس و توابع، اما نه متغیرهای محلی، با استفاده از :func:`typing.get_type_hints` قابل دسترسی هستند."

msgid "universal newlines"
msgstr "سطرهای جدید همگانی"

msgid "A manner of interpreting text streams in which all of the following are recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the Windows convention ``'\\r\\n'``, and the old Macintosh convention ``'\\r'``.  See :pep:`278` and :pep:`3116`, as well as :func:`bytes.splitlines` for an additional use."
msgstr "روشی برای تفسیر جریان‌های متنی که در آن همه‌ی موارد زیر به‌عنوان پایان یک خط شناخته می‌شوند: قرارداد پایان خط یونیکس ``'\\n'``، قرارداد ویندوز ``'\\r\\n'`` و قرارداد قدیمی مکینتاش ``'\\r'``. همچنین :pep:`278` و :pep:`3116` و نیز :func:`bytes.splitlines` را برای کاربردی دیگر ببینید."

msgid "variable annotation"
msgstr "حاشیه‌نویسی متغیر"

msgid "An :term:`annotation` of a variable or a class attribute."
msgstr "یک :term:`حاشیه‌گذاری <annotation>` برای یک متغیر یا یک ویژگی کلاس."

msgid "When annotating a variable or a class attribute, assignment is optional::"
msgstr "هنگام حاشیه‌نویسی یک متغیر یا یک ویژگی کلاس، انتساب اختیاری است::"

msgid ""
"class C:\n"
"    field: 'annotation'"
msgstr ""
"class C:\n"
"    field: 'annotation'"

msgid "Variable annotations are usually used for :term:`type hints <type hint>`: for example this variable is expected to take :class:`int` values::"
msgstr "حاشیه‌نویسی‌های متغیر معمولاً برای :term:`راهنمای نوع <type hint>` استفاده می‌شوند؛ برای مثال، انتظار می‌رود این متغیر مقادیر :class:`int` را بپذیرد::"

msgid "count: int = 0"
msgstr "count: int = 0"

msgid "Variable annotation syntax is explained in section :ref:`annassign`."
msgstr "سینتکس حاشیه‌نویسی متغیر در بخش :ref:`annassign` توضیح داده شده است."

msgid "See :term:`function annotation`, :pep:`484` and :pep:`526`, which describe this functionality. Also see :ref:`annotations-howto` for best practices on working with annotations."
msgstr "همچنین :term:`حاشیه‌گذاری تابع <function annotation>`، :pep:`484` و :pep:`526` را که این قابلیت را توصیف می‌کنند، ببینید. برای بهترین روش‌های کار با حاشیه‌نویسی‌ها نیز :ref:`annotations-howto` را ببینید."

msgid "virtual environment"
msgstr "محیط مجازی"

msgid "A cooperatively isolated runtime environment that allows Python users and applications to install and upgrade Python distribution packages without interfering with the behaviour of other Python applications running on the same system."
msgstr "یک محیط ران‌تایم ایزوله‌شده‌ی مشارکتی که به کاربران و برنامه‌های پایتون اجازه می‌دهد بسته‌های توزیعی پایتون را بدون تداخل با رفتار سایر برنامه‌های پایتونی در حال اجرا روی همان سیستم، نصب و ارتقا دهند."

msgid "See also :mod:`venv`."
msgstr "همچنین :mod:`venv` را ببینید."

msgid "virtual machine"
msgstr "ماشین مجازی"

msgid "A computer defined entirely in software.  Python's virtual machine executes the :term:`bytecode` emitted by the bytecode compiler."
msgstr "یک رایانه که به‌طور کامل در نرم‌افزار تعریف شده است. ماشین مجازی پایتون :term:`بایت‌کد <bytecode>` تولیدشده توسط کامپایلر بایت‌کد را اجرا می‌کند."

msgid "walrus operator"
msgstr "عملگر والروس"

msgid "A light-hearted way to refer to the :ref:`assignment expression <assignment-expressions>` operator ``:=`` because it looks a bit like a walrus if you turn your head."
msgstr "روشی شوخ‌طبعانه برای اشاره به عملگر :ref:`assignment expression <assignment-expressions>` یعنی ``:=``، زیرا اگر سرتان را کمی کج کنید، ظاهر آن تا حدی شبیه یک والروس است."

msgid "Zen of Python"
msgstr "ذن پایتون"

msgid "Listing of Python design principles and philosophies that are helpful in understanding and using the language.  The listing can be found by typing \"``import this``\" at the interactive prompt."
msgstr "فهرستی از اصول و فلسفه‌های طراحی پایتون که برای درک و استفاده از این زبان مفید هستند. این فهرست با واردکردن «``import this``» در اعلان تعاملی قابل مشاهده است."

msgid "..."
msgstr "..."

msgid "ellipsis literal"
msgstr "لفظی سه‌نقطه"

msgid "C-contiguous"
msgstr "پیوسته در C"

msgid "Fortran contiguous"
msgstr "پیوسته در Fortran"

msgid "magic"
msgstr "جادو"

msgid "special"
msgstr "ویژه"

#~ msgid "Usually refers to an asynchronous generator function, but may refer to an *asynchronous generator iterator* in some contexts.  In cases where the intended meaning isn't clear, using the full terms avoids ambiguity."
#~ msgstr "معمولاً به یک تابع تولیدگر ناهمگام اشاره دارد، اما در برخی زمینه‌ها ممکن است به یک *پیمایش‌گر تولیدگر ناهمگام* اشاره کند. در مواردی که معنای مورد نظر واضح نیست، استفاده از اصطلاحات کامل از ابهام جلوگیری می‌کند."

#~ msgid "Usually refers to a generator function, but may refer to a *generator iterator* in some contexts.  In cases where the intended meaning isn't clear, using the full terms avoids ambiguity."
#~ msgstr "معمولاً به یک تابع تولیدگر اشاره دارد، اما در برخی زمینه‌ها ممکن است به یک *پیمایش‌گر تولیدگر* اشاره کند. در مواردی که معنای مورد نظر واضح نیست، استفاده از اصطلاحات کامل از ابهام جلوگیری می‌کند."