From 2209279b063585751d0c64385155ae356c50bfcf Mon Sep 17 00:00:00 2001 From: Sepehr Rasouli Date: Wed, 16 Sep 2026 16:59:45 +0330 Subject: [PATCH 1/2] Fix issues after syncing with upstream --- c-api/code.po | 3 +-- howto/curses.po | 1 - howto/pyporting.po | 1 - library/abc.po | 4 +--- library/asyncio-exceptions.po | 1 - library/email.message.po | 3 +-- library/functools.po | 7 ++----- library/mailbox.po | 1 - library/optparse.po | 3 +-- library/sqlite3.po | 3 +-- library/struct.po | 6 ++---- library/tkinter.po | 2 -- library/types.po | 2 -- library/typing.po | 2 -- reference/datamodel.po | 10 ++-------- reference/expressions.po | 3 +-- whatsnew/2.4.po | 3 +-- whatsnew/3.13.po | 4 +--- whatsnew/3.14.po | 1 - whatsnew/3.9.po | 20 +++++++++----------- 20 files changed, 23 insertions(+), 57 deletions(-) diff --git a/c-api/code.po b/c-api/code.po index 07415765..611067f1 100644 --- a/c-api/code.po +++ b/c-api/code.po @@ -101,9 +101,8 @@ msgstr "معادل کد پایتون ``getattr(co, 'co_varnames')`` است. یک msgid "Equivalent to the Python code ``getattr(co, 'co_cellvars')``. Returns a new reference to a :c:type:`PyTupleObject` containing the names of the local variables that are referenced by nested functions. On error, ``NULL`` is returned and an exception is raised." msgstr "معادل کد پایتونِ ``getattr(co, 'co_cellvars')`` است. یک ارجاع جدید به :c:type:`PyTupleObject` حاوی نام متغیرهای محلی‌ای که توابع تودرتو به آن‌ها ارجاع می‌دهند، برمی‌گرداند. در صورت خطا، ``NULL`` برگردانده می‌شود و یک استثنا مطرح می‌شود." -#, fuzzy msgid "Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new reference to a :c:type:`PyTupleObject` containing the names of the :term:`free (closure) variables `. On error, ``NULL`` is returned and an exception is raised." -msgstr "معادل کد پایتونِ `getattr(co, 'co_freevars')` است. یک ارجاع جدید به :c:type:`PyTupleObject` برمی‌گرداند که نام‌های :term:`متغیرهای آزاد (بستار) ` را در بر می‌گیرد. در صورت خطا، `NULL` برگردانده می‌شود و یک استثنا مطرح می‌شود." +msgstr "معادل کد پایتونِ ``getattr(co, 'co_freevars')`` است. یک ارجاع جدید به :c:type:`PyTupleObject` برمی‌گرداند که نام‌های :term:`متغیرهای آزاد (بستار) ` را در بر می‌گیرد. در صورت خطا، ``NULL`` برگردانده می‌شود و یک استثنا پرتاب می‌شود." msgid "Register *callback* as a code object watcher for the current interpreter. Return an ID which may be passed to :c:func:`PyCode_ClearWatcher`. In case of error (e.g. no more watcher IDs available), return ``-1`` and set an exception." msgstr "*callback* را به‌عنوان دیده‌بان (watcher) شیء کد برای مفسر فعلی ثبت می‌کند. شناسه‌ای برمی‌گرداند که می‌توان آن را به :c:func:`PyCode_ClearWatcher` ارسال کرد. در صورت بروز خطا (مثلاً وقتی دیگر هیچ شناسه‌ی دیده‌بانی در دسترس نیست)، مقدار ``-1`` را برمی‌گرداند و یک استثنا تنظیم می‌کند." diff --git a/howto/curses.po b/howto/curses.po index 2f41b661..df6aae91 100644 --- a/howto/curses.po +++ b/howto/curses.po @@ -524,7 +524,6 @@ msgstr "`صفحه‌ی man مربوط به ncurses `_" msgstr "`پرسش‌های متداول ncurses `_" -#, fuzzy msgid "`\"Use curses... don't swear\" `_: video of a PyCon 2013 talk on controlling terminals using curses or Urwid." msgstr "`\"Use curses... don't swear\" `_: ویدیویی از یک سخنرانی PyCon ۲۰۱۳ در مورد کنترل پایانه‌ها با استفاده از curses یا Urwid." diff --git a/howto/pyporting.po b/howto/pyporting.po index a298478f..4e7ba13a 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -58,7 +58,6 @@ msgstr "`راهنمای Fedora `_" msgid "`PyCon 2020 tutorial `_" msgstr "`آموزش PyCon 2020 `_" -#, fuzzy msgid "`Guide by DigitalOcean `_" msgstr "راهنمای `DigitalOcean `_" diff --git a/library/abc.po b/library/abc.po index dd23b4f5..2ddef849 100644 --- a/library/abc.po +++ b/library/abc.po @@ -70,7 +70,6 @@ msgstr "" msgid "Metaclass for defining Abstract Base Classes (ABCs)." msgstr "فراکلاس برای تعریف کلاس‌های پایه انتزاعی (ABCها)." -#, fuzzy msgid "Use this metaclass to create an ABC. An ABC can be subclassed directly, and then acts as a mix-in class. You can also register unrelated concrete classes (even built-in classes) and unrelated ABCs as \"virtual subclasses\" -- these and their descendants will be considered subclasses of the registering ABC by the built-in :func:`issubclass` function, but the registering ABC won't show up in their MRO (Method Resolution Order) nor will method implementations defined by the registering ABC be callable (not even via :func:`super`). [#]_" msgstr "از این فراکلاس برای ایجاد یک ABC استفاده کنید. یک ABC به‌طور مستقیم قابل زیرکلاس‌بندی است و سپس به‌عنوان یک کلاس میکس‌این عمل می‌کند. همچنین می‌توانید کلاس‌های عینی غیرمرتبط (حتی کلاس‌های توکار) و ABCهای غیرمرتبط را به‌عنوان «زیرکلاس‌های مجازی» ثبت کنید — این کلاس‌ها و زیرکلاس‌های مشتق‌شده از آن‌ها از دید تابع توکار :func:`issubclass` زیرکلاس‌های ABC ثبت‌کننده محسوب خواهند شد، اما ABC ثبت‌کننده در MRO (ترتیب حل متد) آن‌ها ظاهر نخواهد شد و پیاده‌سازی‌های متد تعریف‌شده توسط ABC ثبت‌کننده فراخوانی‌پذیر نخواهند بود (حتی از طریق :func:`super` نیز). [#]_" @@ -80,7 +79,6 @@ msgstr "کلاس‌هایی که با فراکلاس :class:`!ABCMeta` ایجا msgid "Register *subclass* as a \"virtual subclass\" of this ABC. For example::" msgstr "*subclass* را به‌عنوان یک «زیرکلاس مجازی» از این ABC ثبت کنید. برای مثال::" -#, fuzzy msgid "" "from abc import ABC\n" "\n" @@ -97,7 +95,7 @@ msgstr "" "class MyABC(ABC):\n" " pass\n" "\n" -"MyABC.register\n" +"MyABC.register(tuple)\n" "\n" "assert issubclass(tuple, MyABC)\n" "assert isinstance((), MyABC)" diff --git a/library/asyncio-exceptions.po b/library/asyncio-exceptions.po index dd888830..81fc4758 100644 --- a/library/asyncio-exceptions.po +++ b/library/asyncio-exceptions.po @@ -59,7 +59,6 @@ msgstr "زیرکلاسی از :exc:`RuntimeError`." msgid "The requested read operation did not complete fully." msgstr "عملیات خواندن درخواست‌شده به‌طور کامل انجام نشد." -#, fuzzy msgid "Raised by the :ref:`asyncio stream APIs`." msgstr "توسط :ref:`APIهای جریان asyncio ` پرتاب می‌شود." diff --git a/library/email.message.po b/library/email.message.po index 78c6dfa9..4a741c96 100644 --- a/library/email.message.po +++ b/library/email.message.po @@ -258,9 +258,8 @@ msgstr "is_attachment اکنون برای هماهنگی با :meth:`~email.mess msgid "Return the lowercased value (without parameters) of the message's :mailheader:`Content-Disposition` header if it has one, or ``None``. The possible values for this method are *inline*, *attachment* or ``None`` if the message follows :rfc:`2183`." msgstr "اگر پیام سرآیند :mailheader:`Content-Disposition` داشته باشد، مقدار با حروف کوچک آن (بدون پارامترها) را برمی‌گرداند؛ در غیر این صورت ``None`` را برمی‌گرداند. اگر پیام از :rfc:`2183` پیروی کند، مقادیر ممکن برای این متد *inline*، *attachment* یا ``None`` هستند." -#, fuzzy msgid "The following methods relate to interrogating and manipulating the content (payload) of the message." -msgstr "متدهای زیر به بررسی و دستکاری محتوای پیام مربوط می‌شوند." +msgstr "متدهای زیر به بررسی و دستکاری محتوای (payload) پیام مربوط می‌شوند." msgid "The :meth:`walk` method is an all-purpose generator which can be used to iterate over all the parts and subparts of a message object tree, in depth-first traversal order. You will typically use :meth:`walk` as the iterator in a ``for`` loop; each iteration returns the next subpart." msgstr "متد :meth:`walk` یک تولیدگر همه‌منظوره است که می‌توان از آن برای تکرار روی تمام بخش‌ها و زیربخش‌های درخت شیء پیام، به ترتیب پیمایش عمق‌اول استفاده کرد. شما معمولاً از :meth:`walk` به‌عنوان پیمایش‌گر در یک حلقه ``for`` استفاده می‌کنید؛ هر تکرار، زیربخش بعدی را برمی‌گرداند." diff --git a/library/functools.po b/library/functools.po index 2c62af63..ac25028e 100644 --- a/library/functools.po +++ b/library/functools.po @@ -315,7 +315,6 @@ msgstr "بازگرداندن ``NotImplemented`` از تابع مقایسه‌ی msgid "A singleton object used as a sentinel to reserve a place for positional arguments when calling :func:`partial` and :func:`partialmethod`." msgstr "شیء یگانه‌ای که به‌عنوان نشانگر (sentinel) برای رزرو جایگاهی برای آرگومان‌های جایگاهی هنگام فراخوانی :func:`partial` و :func:`partialmethod` استفاده می‌شود." -#, fuzzy msgid "Return a new :ref:`partial object` which when called will behave like *func* called with the positional arguments *args* and keyword arguments *keywords*. If more arguments are supplied to the call, they are appended to *args*. If additional keyword arguments are supplied, they extend and override *keywords*. Roughly equivalent to::" msgstr "یک :ref:`شیء partial ` جدید برمی‌گرداند که هنگام فراخوانی، مانند *func* فراخوانی‌شده با آرگومان‌های جایگاهی *args* و آرگومان‌های کلیدواژه‌ای *keywords* رفتار می‌کند. اگر آرگومان‌های بیشتری در فراخوانی ارائه شوند، به *args* افزوده می‌شوند. اگر آرگومان‌های کلیدواژه‌ای اضافی ارائه شوند، *keywords* را گسترش می‌دهند و بازنویسی می‌کنند. تقریباً معادل است با::" @@ -408,9 +407,8 @@ msgstr "یک توصیف‌گر :class:`partialmethod` جدید برمی‌گرد msgid "*func* must be a :term:`descriptor` or a callable (objects which are both, like normal functions, are handled as descriptors)." msgstr "*func* باید یک :term:`توصیف‌گر ` یا فراخوانی‌پذیر باشد (اشیایی که هر دو هستند، مانند توابع معمولی، به‌عنوان توصیف‌گر در نظر گرفته می‌شوند)." -#, fuzzy msgid "When *func* is a descriptor (such as a normal Python function, :func:`classmethod`, :func:`staticmethod`, :func:`~abc.abstractmethod` or another instance of :class:`partialmethod`), calls to ``__get__`` are delegated to the underlying descriptor, and an appropriate :ref:`partial object` returned as the result." -msgstr "هنگامی که *func* یک توصیف‌گر باشد (مانند یک تابع معمولی پایتون، :func:`classmethod`، :func:`staticmethod`، :func:`~abc.abstractmethod` یا نمونه‌ای دیگر از :class:`partialmethod`)، فراخوانی‌های ``__get__`` به توصیف‌گری زیربنایی محول می‌شوند و یک :ref:`شیء partial ` مناسب به‌عنوان نتیجه برگردانده می‌شود." +msgstr "هنگامی که *func* یک توصیف‌گر باشد (مانند یک تابع معمولی پایتون، :func:`classmethod`، :func:`staticmethod`، :func:`~abc.abstractmethod` یا نمونه‌ای دیگر از :class:`partialmethod`)، فراخوانی‌های متد ``__get__`` به توصیف‌گر زیرین محول می‌شوند و یک :ref:`شیء partial ` مناسب به‌عنوان نتیجه برگردانده می‌شود." msgid "When *func* is a non-descriptor callable, an appropriate bound method is created dynamically. This behaves like a normal Python function when used as a method: the *self* argument will be inserted as the first positional argument, even before the *args* and *keywords* supplied to the :class:`partialmethod` constructor." msgstr "هنگامی که *func* یک شیء فراخوانی‌پذیر غیرتوصیف‌گر باشد، یک متد مقید مناسب به‌صورت پویا ایجاد می‌شود. این متد هنگامی که به‌عنوان یک متد استفاده شود، مانند یک تابع معمولی پایتون رفتار می‌کند: آرگومان *self* به‌عنوان اولین آرگومان جایگاهی درج می‌شود، حتی پیش از *args* و *keywords* ارائه‌شده به سازنده‌ی :class:`partialmethod`." @@ -613,9 +611,8 @@ msgstr "" msgid "At runtime the function will dispatch on an instance of a list regardless of the type contained within the list i.e. ``[1,2,3]`` will be dispatched the same as ``[\"foo\", \"bar\", \"baz\"]``. The annotation provided in this example is for static type checkers only and has no runtime impact." msgstr "در ران‌تایم، تابع بر اساس یک نمونه از فهرست اعزام می‌شود، صرف‌نظر از نوع موجود در فهرست؛ یعنی ``[1,2,3]`` همانند ``[\"foo\", \"bar\", \"baz\"]`` اعزام می‌شود. حاشیه‌نویسی ارائه‌شده در این مثال فقط برای بررسی‌کننده‌های نوع ایستا است و هیچ تأثیری در ران‌تایم ندارد." -#, fuzzy msgid "To enable registering :term:`lambdas` and pre-existing functions, the :func:`~singledispatch.register` attribute can also be used in a functional form::" -msgstr "برای امکان‌پذیر کردن ثبت :term:`لامبداها ` و توابع از پیش موجود، همچنین می‌توان از ویژگی :func:`~singledispatch.register` به‌شکل تابعی استفاده کرد::" +msgstr "برای فراهم کردن امکان ثبت :term:`لامبداها ` و توابع از پیش موجود، همچنین می‌توان از ویژگی :func:`~singledispatch.register` به‌شکل تابعی استفاده کرد::" msgid "" ">>> def nothing(arg, verbose=False):\n" diff --git a/library/mailbox.po b/library/mailbox.po index 94a14560..ee15f95b 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -293,7 +293,6 @@ msgstr "نمونه‌های :class:`!Maildir` هیچ پرونده بازی را msgid "Depending upon the host platform, it may not be possible to modify or remove the underlying message while the returned file remains open." msgstr "بسته به پلتفرم میزبان، ممکن است در حالی که پرونده برگردانده‌شده باز باقی می‌ماند، تغییر یا حذف پیام زیربنایی امکان‌پذیر نباشد." -#, fuzzy msgid "`maildir man page from Courier `_" msgstr "صفحه راهنمای maildir از `Courier `_" diff --git a/library/optparse.po b/library/optparse.po index 413b7ec3..f18b406f 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -1648,9 +1648,8 @@ msgstr "parser = OptionParser(..., conflict_handler=handler)" msgid "or with a separate call::" msgstr "یا با یک فراخوانی جداگانه::" -#, fuzzy msgid "parser.set_conflict_handler(handler)" -msgstr "parser.set_conflict_handler" +msgstr "parser.set_conflict_handler(handler)" msgid "The available conflict handlers are:" msgstr "مدیرهای تعارض (conflict handlers) موجود عبارتند از:" diff --git a/library/sqlite3.po b/library/sqlite3.po index 617b6de8..90da107e 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -1408,9 +1408,8 @@ msgstr "پشتیبانی از اسلایس افزوده شد." msgid "Blob objects" msgstr "اشیای Blob" -#, fuzzy msgid "A :class:`Blob` instance is a :term:`file-like object` that can read and write data in an SQLite :abbr:`BLOB (Binary Large OBject)`. Call :func:`len(blob) ` to get the size (number of bytes) of the blob. Use indices and :term:`slices ` for direct access to the blob data." -msgstr "یک نمونه از :class:`Blob` یک :term:`شیء شبه‌پرونده ` است که می‌تواند داده‌ها را در یک :abbr:`BLOB (Binary Large OBject)` در SQLite بخواند و بنویسد. برای دریافت اندازه‌ی blob (تعداد بایت‌ها)، :func:`len ` را فراخوانی کنید. برای دسترسی مستقیم به داده‌های blob، از اندیس‌ها و :term:`اسلایس‌ها ` استفاده کنید." +msgstr "یک نمونه از :class:`Blob` یک :term:`شیء شبه‌پرونده ` است که می‌تواند داده‌ها را در یک :abbr:`BLOB (Binary Large OBject)` مربوط به SQLite بخواند و بنویسد. برای دریافت اندازه‌ی blob (یعنی تعداد بایت‌های آن)، :func:`len(blob) ` را فراخوانی کنید. برای دسترسی مستقیم به داده‌های blob، از اندیس‌ها و :term:`اسلایس‌ها ` استفاده کنید." msgid "Use the :class:`Blob` as a :term:`context manager` to ensure that the blob handle is closed after use." msgstr "از :class:`Blob` به‌عنوان یک :term:`context manager` استفاده کنید تا اطمینان حاصل شود که دسته‌ی blob پس از استفاده بسته می‌شود." diff --git a/library/struct.po b/library/struct.po index 55f727eb..9cedfff3 100644 --- a/library/struct.po +++ b/library/struct.po @@ -74,9 +74,8 @@ msgstr "اندازه‌ی ساختار (و بنابراین اندازه‌ی ش msgid "Format Strings" msgstr "رشته‌های قالب" -#, fuzzy msgid "Format strings describe the data layout when packing and unpacking data. They are built up from :ref:`format characters`, which specify the type of data being packed/unpacked. In addition, special characters control the :ref:`byte order, size and alignment`. Each format string consists of an optional prefix character which describes the overall properties of the data and one or more format characters which describe the actual data values and padding." -msgstr "رشته‌های قالب، چیدمان داده‌ها را هنگام بسته‌بندی و واگشایی داده توصیف می‌کنند. آن‌ها از :ref:`نویسه‌های قالب ` تشکیل شده‌اند که نوع داده‌های در حال بسته‌بندی/واگشایی را مشخص می‌کنند. افزون بر این، نویسه‌های ویژه :ref:`ترتیب بایت، اندازه و ترازبندی ` را کنترل می‌کنند. هر رشته قالب شامل یک نویسه پیشوند اختیاری است که ویژگی‌های کلی داده‌ها را توصیف می‌کند و یک یا چند نویسه قالب که مقادیر واقعی داده و فضای پرکننده را توصیف می‌کنند." +msgstr "رشته‌های قالب، چیدمان داده‌ها را هنگام بسته‌بندی و واگشایی داده توصیف می‌کنند. آن‌ها از :ref:`نویسه‌های قالب ` تشکیل شده‌اند که نوع داده‌هایی را که بسته‌بندی/واگشایی می‌شوند مشخص می‌کنند. افزون بر این، نویسه‌های ویژه :ref:`ترتیب بایت، اندازه و ترازبندی ` را کنترل می‌کنند. هر رشته‌ی قالب شامل یک نویسه‌ی پیشوندی اختیاری است که ویژگی‌های کلی داده‌ها را توصیف می‌کند و یک یا چند نویسه‌ی قالب که مقادیر واقعی داده و فضای پرکننده را توصیف می‌کنند." msgid "Byte Order, Size, and Alignment" msgstr "ترتیب بایت، اندازه و هم‌ترازی" @@ -586,9 +585,8 @@ msgstr "سریال‌سازی شیء پایتون." msgid "Applications" msgstr "برنامه‌های کاربردی" -#, fuzzy msgid "Two main applications for the :mod:`!struct` module exist, data interchange between Python and C code within an application or another application compiled using the same compiler (:ref:`native formats`), and data interchange between applications using agreed upon data layout (:ref:`standard formats`). Generally speaking, the format strings constructed for these two domains are distinct." -msgstr "دو کاربرد اصلی برای ماژول :mod:`!struct` وجود دارد: تبادل داده بین کد پایتون و C درون یک برنامه یا برنامه‌ای دیگر که با همان کامپایلر کامپایل شده است (:ref:`قالب‌های بومی `)، و تبادل داده بین برنامه‌هایی که از چیدمان داده‌ی توافق‌شده استفاده می‌کنند (:ref:`قالب‌های استاندارد `). به‌طور کلی، رشته‌های قالب ساخته‌شده برای این دو حوزه از هم متمایز هستند." +msgstr "دو کاربرد اصلی برای ماژول :mod:`!struct` وجود دارند: تبادل داده بین کد پایتون و C در یک برنامه یا برنامه‌ای دیگر که با همان کامپایلر کامپایل شده است (:ref:`قالب‌های بومی `)، و تبادل داده بین برنامه‌هایی که از چیدمان داده‌ی مورد توافق استفاده می‌کنند (:ref:`قالب‌های استاندارد `). به‌طور کلی، رشته‌های قالب ساخته‌شده برای این دو حوزه با یکدیگر تفاوت دارند." msgid "Native Formats" msgstr "قالب‌های بومی" diff --git a/library/tkinter.po b/library/tkinter.po index 69408bae..5897de71 100644 --- a/library/tkinter.po +++ b/library/tkinter.po @@ -88,7 +88,6 @@ msgstr "`Tkinter مدرن برای توسعه‌دهندگان پرمشغله پ msgid "By Mark Roseman. (ISBN 978-1999149567)" msgstr "اثر مارک رزمن. (ISBN 978-1999149567)" -#, fuzzy msgid "`Python GUI programming with Tkinter `_" msgstr "برنامه‌نویسی GUI پایتون با `Tkinter `_" @@ -1719,7 +1718,6 @@ msgstr "ویژگی‌های در دسترس بسته به پلتفرم متفا msgid "*alpha*" msgstr "*alpha*" -#, fuzzy msgid "The window's opacity, from ``0.0`` (fully transparent) to ``1.0`` (opaque). Where transparency is unsupported the value stays at ``1.0``." msgstr "کدری پنجره، از ``0.0`` (کاملاً شفاف) تا ``1.0`` (کدر). هر جا شفافیت پشتیبانی نشود، مقدار روی ``1.0`` باقی می‌ماند." diff --git a/library/types.po b/library/types.po index 3649f21d..25f34e6c 100644 --- a/library/types.po +++ b/library/types.po @@ -256,7 +256,6 @@ msgstr "" msgid "This type can now be subclassed." msgstr "اکنون می‌توان این نوع را زیرکلاس‌سازی کرد." -#, fuzzy msgid ":ref:`Generic Alias Types`" msgstr ":ref:`انواع نام‌های مستعار عام `" @@ -269,7 +268,6 @@ msgstr ":pep:`585` - راهنمای نوع برای عام‌ها در مجمو msgid "Introducing the :class:`!types.GenericAlias` class" msgstr "معرفی کلاس :class:`!types.GenericAlias`" -#, fuzzy msgid "The type of :ref:`union type expressions`." msgstr "نوع :ref:`عبارت‌های نوع union `." diff --git a/library/typing.po b/library/typing.po index 2a62dcde..57c5d7f3 100644 --- a/library/typing.po +++ b/library/typing.po @@ -1560,7 +1560,6 @@ msgstr "شما نمی‌توانید ``Union[X][Y]`` را بنویسید." msgid "Don't remove explicit subclasses from unions at runtime." msgstr "زیرکلاس‌های صریح را در ران‌تایم از اجتماع‌ها (unions) حذف نکنید." -#, fuzzy msgid "Unions can now be written as ``X | Y``. See :ref:`union type expressions`." msgstr "اکنون می‌توان اجتماع‌ها را به‌صورت ``X | Y`` نوشت. :ref:`عبارات نوع اجتماع‌ای ` را ببینید." @@ -1590,7 +1589,6 @@ msgstr "" "def foo(arg: Optional[int] = None) -> None:\n" " ..." -#, fuzzy msgid "Optional can now be written as ``X | None``. See :ref:`union type expressions`." msgstr "اکنون می‌توان Optional را به‌صورت ``X | None`` نوشت. به :ref:`عبارات نوع اجتماعی (union) ` مراجعه کنید." diff --git a/reference/datamodel.po b/reference/datamodel.po index b06fe42e..ff8103c1 100644 --- a/reference/datamodel.po +++ b/reference/datamodel.po @@ -1670,9 +1670,8 @@ msgstr "شامل مشخصاتی برای سفارشی‌سازی رفتار :fun msgid "Emulating generic types" msgstr "شبیه‌سازی انواع عام" -#, fuzzy msgid "When using :term:`type annotations`, it is often useful to *parameterize* a :term:`generic type` using Python's square-brackets notation. For example, the annotation ``list[int]`` might be used to signify a :class:`list` in which all the elements are of type :class:`int`." -msgstr "هنگام استفاده از :term:`حاشیه‌نویسی‌های نوع `، اغلب مفید است که یک :term:`نوع عام ` را با استفاده از نماد کروشه‌های مربع پایتون *پارامتری کنید*. برای مثال، ممکن است از حاشیه‌نویسی ``list[int]`` برای نشان دادن یک :class:`list` استفاده شود که در آن همه‌ی عناصر از نوع :class:`int` هستند." +msgstr "هنگام استفاده از :term:`حاشیه‌نویسی‌های نوع `، اغلب مفید است که یک :term:`نوع عام ` را با استفاده از نماد کروشه‌ای پایتون *پارامتری کنید*. برای مثال، ممکن است از حاشیه‌نویسی ``list[int]`` برای نشان دادن یک :class:`list` استفاده شود که در آن همه‌ی عناصر از نوع :class:`int` هستند." msgid ":pep:`484` - Type Hints" msgstr ":pep:`484` - راهنماهای نوع" @@ -1680,14 +1679,12 @@ msgstr ":pep:`484` - راهنماهای نوع" msgid "Introducing Python's framework for type annotations" msgstr "آشنایی با چارچوب پایتون برای حاشیه‌نویسی‌های نوع" -#, fuzzy msgid ":ref:`Generic Alias Types`" msgstr ":ref:`انواع نام مستعار عام `" msgid "Documentation for objects representing parameterized generic classes" msgstr "مستندات اشیایی که کلاس‌های عام پارامتریزه را نشان می‌دهند" -#, fuzzy msgid ":ref:`Generics`, :ref:`user-defined generics` and :class:`typing.Generic`" msgstr ":ref:`عام‌ها `، :ref:`عام‌های تعریف‌شده توسط کاربر ` و :class:`typing.Generic`" @@ -1706,7 +1703,6 @@ msgstr "هنگامی که روی یک کلاس تعریف شود، ``__class_get msgid "The purpose of *__class_getitem__*" msgstr "هدف از *__class_getitem__*" -#, fuzzy msgid "The purpose of :meth:`~object.__class_getitem__` is to allow runtime parameterization of standard-library generic classes in order to more easily apply :term:`type hints` to these classes." msgstr "هدف از :meth:`~object.__class_getitem__` این است که امکان پارامتری‌سازی کلاس‌های عام کتابخانه استاندارد در ران‌تایم فراهم شود، تا بتوان :term:`راهنماهای نوع ` را آسان‌تر به این کلاس‌ها اعمال کرد." @@ -1775,7 +1771,6 @@ msgstr "" msgid "In Python, all classes are themselves instances of other classes. The class of a class is known as that class's :term:`metaclass`, and most classes have the :class:`type` class as their metaclass. :class:`type` does not define :meth:`~object.__getitem__`, meaning that expressions such as ``list[int]``, ``dict[str, float]`` and ``tuple[str, bytes]`` all result in :meth:`~object.__class_getitem__` being called::" msgstr "در پایتون، همه‌ی کلاس‌ها خود نمونه‌هایی از کلاس‌های دیگر هستند. کلاسِ یک کلاس به عنوان :term:`فراکلاس ` آن کلاس شناخته می‌شود، و بیشتر کلاس‌ها کلاس :class:`type` را به عنوان فراکلاس خود دارند. :class:`type` متد :meth:`~object.__getitem__` را تعریف نمی‌کند، به این معنا که عبارت‌هایی مانند ``list[int]``، ``dict[str, float]`` و ``tuple[str, bytes]`` همگی منجر به فراخوانی :meth:`~object.__class_getitem__` می‌شوند::" -#, fuzzy msgid "" ">>> # list has class \"type\" as its metaclass, like most classes:\n" ">>> type(list)\n" @@ -1792,7 +1787,7 @@ msgstr "" ">>> # list has class \"type\" as its metaclass, like most classes:\n" ">>> type(list)\n" "\n" -">>> type(dict) == type(list) == type == type(str) == type(bytes)\n" +">>> type(dict) == type(list) == type(tuple) == type(str) == type(bytes)\n" "True\n" ">>> # \"list[int]\" calls \"list.__class_getitem__(int)\"\n" ">>> list[int]\n" @@ -1842,7 +1837,6 @@ msgstr "" msgid ":pep:`560` - Core Support for typing module and generic types" msgstr ":pep:`560` - پشتیبانی هسته‌ای از ماژول typing و انواع عام" -#, fuzzy msgid "Introducing :meth:`~object.__class_getitem__`, and outlining when a :ref:`subscription` results in ``__class_getitem__()`` being called instead of :meth:`~object.__getitem__`" msgstr "معرفی :meth:`~object.__class_getitem__` و شرح اینکه چه زمانی یک :ref:`زیرنویسی ` منجر به فراخوانی ``__class_getitem__()`` به‌جای :meth:`~object.__getitem__` می‌شود" diff --git a/reference/expressions.po b/reference/expressions.po index ec7a743f..418593af 100644 --- a/reference/expressions.po +++ b/reference/expressions.po @@ -1139,9 +1139,8 @@ msgstr "عملگر ``@`` (at) برای ضرب ماتریسی در نظر گرف msgid "This operation can be customized using the special :meth:`~object.__matmul__` and :meth:`~object.__rmatmul__` methods." msgstr "این عملیات را می‌توان با استفاده از متدهای ویژه :meth:`~object.__matmul__` و :meth:`~object.__rmatmul__` سفارشی‌سازی کرد." -#, fuzzy msgid "The ``/`` (division) and ``//`` (floor division) operators yield the quotient of their arguments. The numeric arguments are first :ref:`converted to a common type `. Division of integers yields a float, while floor division of integers results in an integer; the result is that of mathematical division with the 'floor' function applied to the result. Division by zero raises the :exc:`ZeroDivisionError` exception." -msgstr "عملگرهای ``/`` (تقسیم) و ``//`` (تقسیم کف) خارج‌قسمت آرگومان‌های خود را برمی‌گردانند. آرگومان‌های عددی ابتدا :ref:`به یک نوع مشترک تبدیل می‌شوند `. تقسیم اعداد صحیح یک مقدار شناور برمی‌گرداند، در حالی که تقسیم کف اعداد صحیح یک عدد صحیح برمی‌گرداند؛ این نتیجه، حاصل تقسیم ریاضی است که تابع 'floor' بر آن اعمال شده باشد. تقسیم بر صفر استثنای :exc:`ZeroDivisionError` را پرتاب می‌کند." +msgstr "عملگرهای ``/`` (تقسیم) و ``//`` (تقسیم کف) خارج‌قسمت آرگومان‌های خود را برمی‌گردانند. آرگومان‌های عددی ابتدا :ref:`به یک نوع مشترک تبدیل می‌شوند `. تقسیم اعداد صحیح یک مقدار شناور برمی‌گرداند، در حالی که تقسیم کفِ اعداد صحیح یک عدد صحیح نتیجه می‌دهد؛ نتیجه، حاصل تقسیم ریاضی است که تابع 'floor' بر آن اعمال شده است. تقسیم بر صفر استثنای :exc:`ZeroDivisionError` را پرتاب می‌کند." msgid "The division operation can be customized using the special :meth:`~object.__truediv__` and :meth:`~object.__rtruediv__` methods. The floor division operation can be customized using the special :meth:`~object.__floordiv__` and :meth:`~object.__rfloordiv__` methods." msgstr "عملیات تقسیم را می‌توان با استفاده از متدهای ویژه :meth:`~object.__truediv__` و :meth:`~object.__rtruediv__` سفارشی‌سازی کرد. عملیات تقسیم کف را می‌توان با استفاده از متدهای ویژه :meth:`~object.__floordiv__` و :meth:`~object.__rfloordiv__` سفارشی‌سازی کرد." diff --git a/whatsnew/2.4.po b/whatsnew/2.4.po index 4f73a8da..79497141 100644 --- a/whatsnew/2.4.po +++ b/whatsnew/2.4.po @@ -1370,9 +1370,8 @@ msgstr "ماژول :mod:`re` نیز به لطف حجم عظیمی از کار گ msgid "The :mod:`signal` module now performs tighter error-checking on the parameters to the :func:`signal.signal` function. For example, you can't set a handler on the :const:`~signal.SIGKILL` signal; previous versions of Python would quietly accept this, but 2.4 will raise a :exc:`RuntimeError` exception." msgstr "ماژول :mod:`signal` اکنون بررسی خطای سخت‌گیرانه‌تری روی پارامترهای تابع :func:`signal.signal` انجام می‌دهد. برای مثال، نمی‌توانید روی سیگنال :const:`~signal.SIGKILL` هندلری تنظیم کنید؛ نسخه‌های قبلی پایتون این را بی‌سروصدا می‌پذیرفتند، اما 2.4 استثنای :exc:`RuntimeError` پرتاب می‌کند." -#, fuzzy msgid "Two new functions were added to the :mod:`socket` module. :func:`~socket.socketpair` returns a pair of connected sockets and ``getservbyport(port)`` looks up the service name for a given port number. (Contributed by Dave Cole and Barry Warsaw.)" -msgstr "دو تابع جدید به ماژول :mod:`socket` اضافه شد. :func:`~socket.socketpair` یک جفت سوکت متصل را برمی‌گرداند و ``getservbyport`` نام سرویس مربوط به یک شماره پورت مشخص را جستجو می‌کند. (مشارکت‌شده توسط Dave Cole و Barry Warsaw.)" +msgstr "دو تابع جدید به ماژول :mod:`socket` اضافه شدند. :func:`~socket.socketpair` یک جفت سوکت متصل را برمی‌گرداند و ``getservbyport(port)`` نام سرویس مربوط به یک شماره پورت مشخص را جستجو می‌کند. (با مشارکت Dave Cole و Barry Warsaw.)" msgid "The :func:`!sys.exitfunc` function has been deprecated. Code should be using the existing :mod:`atexit` module, which correctly handles calling multiple exit functions. Eventually :func:`!sys.exitfunc` will become a purely internal interface, accessed only by :mod:`atexit`." msgstr "تابع :func:`!sys.exitfunc` منسوخ شده است. کد باید از ماژول موجود :mod:`atexit` استفاده کند که فراخوانی چندین تابع خروج را به‌درستی مدیریت می‌کند. در نهایت :func:`!sys.exitfunc` به رابطی صرفاً داخلی تبدیل خواهد شد که تنها :mod:`atexit` به آن دسترسی خواهد داشت." diff --git a/whatsnew/3.13.po b/whatsnew/3.13.po index 65ee6c63..821ee40b 100644 --- a/whatsnew/3.13.po +++ b/whatsnew/3.13.po @@ -321,13 +321,11 @@ msgstr ":pep:`703` \"Making the Global Interpreter Lock Optional in CPython\" ش msgid "`Porting Extension Modules to Support Free-Threading `_: A community-maintained porting guide for extension authors." msgstr "`پورت‌کردن ماژول‌های توسعه‌ای برای پشتیبانی از نخ‌بندی آزاد `_: یک راهنمای پورت‌کردن نگهداری‌شده توسط کامیونیتی برای نویسندگان ماژول‌های توسعه‌ای." -#, fuzzy msgid "An experimental just-in-time (JIT) compiler" msgstr "یک کامپایلر آزمایشی در لحظه" -#, fuzzy msgid "When CPython is configured and built using the :option:`!--enable-experimental-jit` option, a just-in-time (JIT) compiler is added which may speed up some Python programs. On Windows, use ``PCbuild/build.bat --experimental-jit`` to enable the JIT or ``--experimental-jit-interpreter`` to enable the Tier 2 interpreter. Build requirements and further supporting information `are contained at`__ :file:`Tools/jit/README.md`." -msgstr "وقتی سی‌پایتون با استفاده از گزینه‌ی :option:`!--enable-experimental-jit` پیکربندی و ساخته شود، کامپایلری در لحظه افزوده می‌شود که ممکن است سرعت برخی برنامه‌های پایتون را افزایش دهد. در ویندوز، برای فعال‌سازی JIT از ``PCbuild/build.bat --experimental-jit`` استفاده کنید یا برای فعال‌سازی مفسر سطح ۲ (Tier 2) از ``--experimental-jit-interpreter`` استفاده کنید. نیازمندی‌های ساخت و اطلاعات پشتیبان بیشتر در :file:`Tools/jit/README.md` `آمده‌اند`__." +msgstr "وقتی سی‌پایتون با استفاده از گزینه‌ی :option:`!--enable-experimental-jit` پیکربندی و ساخته شود، کامپایلری در لحظه افزوده می‌شود که ممکن است سرعت برخی برنامه‌های پایتون را افزایش دهد. در ویندوز، برای فعال‌سازی JIT از ``PCbuild/build.bat --experimental-jit`` استفاده کنید یا برای فعال‌سازی مفسر سطح ۲ (Tier 2) از ``--experimental-jit-interpreter`` استفاده کنید. نیازمندی‌های ساخت و اطلاعات پشتیبان بیشتر `در`__ :file:`Tools/jit/README.md` آمده‌اند." msgid "The :option:`!--enable-experimental-jit` option takes these (optional) values, defaulting to ``yes`` if :option:`!--enable-experimental-jit` is present without the optional value." msgstr "گزینه‌ی :option:`!--enable-experimental-jit` این مقادیر (اختیاری) را می‌پذیرد و اگر :option:`!--enable-experimental-jit` بدون مقدار اختیاری ذکر شود، مقدار پیش‌فرض ``yes`` است." diff --git a/whatsnew/3.14.po b/whatsnew/3.14.po index 4ee374af..267779bd 100644 --- a/whatsnew/3.14.po +++ b/whatsnew/3.14.po @@ -3433,7 +3433,6 @@ msgstr "`پذیرش PEP 779 `__" msgid "Binary releases for the experimental just-in-time compiler" msgstr "نسخه‌های دودویی برای کامپایلر آزمایشی در لحظه" -#, fuzzy msgid "The official macOS and Windows release binaries now include an *experimental* just-in-time (JIT) compiler. Although it is **not** recommended for production use, it can be tested by setting :envvar:`PYTHON_JIT=1 ` as an environment variable. Downstream source builds and redistributors can use the :option:`--enable-experimental-jit=yes-off` configuration option for similar behavior." msgstr "پرونده‌های دودویی انتشار رسمی macOS و Windows اکنون شامل یک کامپایلر *آزمایشی* در لحظه هستند. اگرچه استفاده از آن در محیط عملیاتی توصیه **نمی‌شود**، می‌توان آن را با تنظیم :envvar:`PYTHON_JIT=1 ` به‌عنوان یک متغیر محیطی آزمایش کرد. ساخت‌های پایین‌دستی از کد منبع و بازتوزیع‌کنندگان می‌توانند از گزینه‌ی پیکربندی :option:`--enable-experimental-jit=yes-off` برای رفتاری مشابه استفاده کنند." diff --git a/whatsnew/3.9.po b/whatsnew/3.9.po index 757d10bc..edbd9fa6 100644 --- a/whatsnew/3.9.po +++ b/whatsnew/3.9.po @@ -712,10 +712,10 @@ msgid "" "Timing loop:\n" " loop_overhead 0.5 0.6 0.4 0.3 0.3 0.3" msgstr "" -"نسخه پایتون 3.4 3.5 3.6 3.7 3.8 3.9\n" +"Python version 3.4 3.5 3.6 3.7 3.8 3.9\n" "-------------- --- --- --- --- --- ---\n" "\n" -"دسترسی خواندن متغیر و ویژگی:\n" +"Variable and attribute read access:\n" " read_local 7.1 7.1 5.4 5.1 3.9 3.9\n" " read_nonlocal 7.1 8.1 5.8 5.4 4.4 4.5\n" " read_global 15.5 19.0 14.3 13.6 7.6 7.8\n" @@ -727,7 +727,7 @@ msgstr "" " read_namedtuple 73.8 57.5 45.0 46.8 18.4 18.7\n" " read_boundmethod 37.6 37.9 29.6 26.9 27.7 41.1\n" "\n" -"دسترسی نوشتن متغیر و ویژگی:\n" +"Variable and attribute write access:\n" " write_local 8.7 9.3 5.5 5.3 4.3 4.3\n" " write_nonlocal 10.5 11.1 5.6 5.5 4.7 4.8\n" " write_global 19.7 21.2 18.0 18.0 15.8 16.7\n" @@ -735,24 +735,24 @@ msgstr "" " write_instancevar 44.6 45.8 40.0 38.9 35.5 37.4\n" " write_instancevar_slots 35.6 36.1 27.3 26.6 25.7 25.8\n" "\n" -"دسترسی خواندن ساختار داده:\n" +"Data structure read access:\n" " read_list 24.2 24.5 20.8 20.8 19.0 19.5\n" " read_deque 24.7 25.5 20.2 20.6 19.8 20.2\n" " read_dict 24.3 25.7 22.3 23.0 21.0 22.4\n" " read_strdict 22.6 24.3 19.5 21.2 18.9 21.5\n" "\n" -"دسترسی نوشتن ساختار داده:\n" +"Data structure write access:\n" " write_list 27.1 28.5 22.5 21.6 20.0 20.0\n" " write_deque 28.7 30.1 22.7 21.8 23.5 21.7\n" " write_dict 31.4 33.3 29.3 29.2 24.7 25.4\n" " write_strdict 28.4 29.9 27.5 25.2 23.1 24.5\n" "\n" -"عملیات پشته (یا صف):\n" +"Stack (or queue) operations:\n" " list_append_pop 93.4 112.7 75.4 74.2 50.8 50.6\n" " deque_append_pop 43.5 57.0 49.4 49.2 42.5 44.2\n" " deque_append_popleft 43.7 57.3 49.7 49.7 42.8 46.4\n" "\n" -"حلقه زمان‌سنجی:\n" +"Timing loop:\n" " loop_overhead 0.5 0.6 0.4 0.3 0.3 0.3" msgid "These results were generated from the variable access benchmark script at: ``Tools/scripts/var_access_benchmark.py``. The benchmark script displays timings in nanoseconds. The benchmarks were measured on an `Intel® Core™ i7-4960HQ processor `_ running the macOS 64-bit builds found at `python.org `_." @@ -800,9 +800,8 @@ msgstr ":func:`!rlecode_hqx`, :func:`!rledecode_hqx`" msgid "(Contributed by Victor Stinner in :issue:`39353`.)" msgstr "(مشارکت توسط Victor Stinner در :issue:`39353`.)" -#, fuzzy msgid ":mod:`ast` classes ``slice``, ``Index`` and ``ExtSlice`` are considered deprecated and will be removed in future Python versions. ``value`` itself should be used instead of ``Index(value)``. ``Tuple(slices, Load())`` should be used instead of ``ExtSlice(slices)``. (Contributed by Serhiy Storchaka in :issue:`34822`.)" -msgstr "کلاس‌های :mod:`ast` یعنی ``slice``، ``Index`` و ``ExtSlice`` منسوخ در نظر گرفته می‌شوند و در نسخه‌های آینده پایتون حذف خواهند شد. به جای ``Index(value)`` باید از خود ``value`` استفاده شود. به جای ``ExtSlice`` باید از ``Tuple(slices, Load())`` استفاده شود. (مشارکت‌شده توسط Serhiy Storchaka در :issue:`34822`.)" +msgstr "کلاس‌های :mod:`ast` یعنی ``slice``، ``Index`` و ``ExtSlice`` منسوخ در نظر گرفته می‌شوند و در نسخه‌های آینده‌ی پایتون حذف خواهند شد. به جای ``Index(value)`` باید از خود ``value`` استفاده شود. به جای ``ExtSlice(slices)`` باید از ``Tuple(slices, Load())`` استفاده شود. (با مشارکت Serhiy Storchaka در :issue:`34822`.)" msgid ":mod:`ast` classes ``Suite``, ``Param``, ``AugLoad`` and ``AugStore`` are considered deprecated and will be removed in future Python versions. They were not generated by the parser and not accepted by the code generator in Python 3. (Contributed by Batuhan Taskaya in :issue:`39639` and :issue:`39969` and Serhiy Storchaka in :issue:`39988`.)" msgstr "کلاس‌های ``Suite``، ``Param``، ``AugLoad`` و ``AugStore`` در :mod:`ast` منسوخ در نظر گرفته می‌شوند و در نسخه‌های آینده پایتون حذف خواهند شد. این کلاس‌ها توسط پارسر تولید نمی‌شدند و در پایتون ۳ توسط تولیدگر کد پذیرفته نمی‌شدند. (مشارکت‌شده توسط Batuhan Taskaya در :issue:`39639` و :issue:`39969` و Serhiy Storchaka در :issue:`39988`.)" @@ -912,9 +911,8 @@ msgstr "متد :meth:`select.epoll.unregister` دیگر خطای :const:`~errno. msgid "The *compresslevel* parameter of :class:`bz2.BZ2File` became keyword-only, since the *buffering* parameter has been removed. (Contributed by Victor Stinner in :issue:`39357`.)" msgstr "پارامتر *compresslevel* در :class:`bz2.BZ2File` فقط‌کلیدواژه‌ای شد، زیرا پارامتر *buffering* حذف شده است. (مشارکت‌شده توسط Victor Stinner در :issue:`39357`.)" -#, fuzzy msgid "Simplified AST for subscription. Simple indices will be represented by their value, extended slices will be represented as tuples. ``Index(value)`` will return a ``value`` itself, ``ExtSlice(slices)`` will return ``Tuple(slices, Load())``. (Contributed by Serhiy Storchaka in :issue:`34822`.)" -msgstr "ساده‌سازی درخت سینتکس انتزاعی (AST) برای زیرنویسی. اندیس‌های ساده با مقدار خود و اسلایس‌های توسعه‌یافته به صورت تاپل نمایش داده خواهند شد. ``Index(value)`` خودِ ``value`` را برمی‌گرداند و ``ExtSlice`` نیز ``Tuple(slices, Load())`` را برمی‌گرداند. (مشارکت‌شده توسط Serhiy Storchaka در :issue:`34822`.)" +msgstr "AST ساده‌شده برای :[subscription term]. اندیس‌های ساده با مقدار خود و اسلایس‌های توسعه‌یافته به‌صورت تاپل نمایش داده خواهند شد. ``Index(value)`` خودِ ``value`` را برمی‌گرداند و ``ExtSlice(slices)`` مقدار ``Tuple(slices, Load())`` را برمی‌گرداند. (با مشارکت Serhiy Storchaka در :issue:`34822`.)" msgid "The :mod:`importlib` module now ignores the :envvar:`PYTHONCASEOK` environment variable when the :option:`-E` or :option:`-I` command line options are being used." msgstr "ماژول :mod:`importlib` اکنون متغیر محیطی :envvar:`PYTHONCASEOK` را هنگام استفاده از گزینه‌های خط فرمان :option:`-E` یا :option:`-I` نادیده می‌گیرد." From 186a58d91e71f911312e0d7e8787fb3be36bc382 Mon Sep 17 00:00:00 2001 From: Sepehr Rasouli Date: Wed, 16 Sep 2026 18:00:34 +0330 Subject: [PATCH 2/2] Fix build issues --- .github/workflows/build-and-deploy.yml | 2 +- .readthedocs.yml | 1 - c-api/frame.po | 28 +- c-api/unicode.po | 6 +- faq/programming.po | 2 +- glossary.json | 520 ------------------------- glossary.po | 4 +- glossary.tsv | 2 +- library/asyncio-task.po | 156 ++++---- library/doctest.po | 8 +- library/email.compat32-message.po | 106 ++--- library/modulefinder.po | 6 +- library/optparse.po | 12 +- library/re.po | 6 +- library/socket.po | 190 ++++----- library/sqlite3.po | 8 +- library/test.po | 2 +- library/unittest.mock-examples.po | 4 +- library/unittest.mock.po | 42 +- library/unittest.po | 2 +- whatsnew/2.0.po | 2 +- whatsnew/2.1.po | 24 +- whatsnew/2.2.po | 6 +- whatsnew/2.3.po | 4 +- whatsnew/2.4.po | 60 +-- whatsnew/2.7.po | 20 +- whatsnew/3.7.po | 2 +- 27 files changed, 352 insertions(+), 873 deletions(-) delete mode 100644 glossary.json diff --git a/.github/workflows/build-and-deploy.yml b/.github/workflows/build-and-deploy.yml index 02a4c028..4c9b661b 100644 --- a/.github/workflows/build-and-deploy.yml +++ b/.github/workflows/build-and-deploy.yml @@ -50,7 +50,7 @@ jobs: uses: sphinx-doc/github-problem-matcher@v1.1 - name: Build documentation - run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -D suppress_warnings=misc.highlighting_failure -D html_theme_options.is_rtl=true --keep-going" html + run: make -e SPHINXOPTS="--color -D language='fa' -D gettext_allow_fuzzy_translations=1 -D html_theme_options.is_rtl=true --keep-going" html working-directory: ./Doc - name: Setup Pages diff --git a/.readthedocs.yml b/.readthedocs.yml index 45652e85..e298dedc 100644 --- a/.readthedocs.yml +++ b/.readthedocs.yml @@ -16,7 +16,6 @@ build: -d $READTHEDOCS_OUTPUT/doctrees -D language=fa -D gettext_allow_fuzzy_translations=1 - -D suppress_warnings=misc.highlighting_failure -D gettext_compact=0 -D html_theme_options.is_rtl=true --keep-going diff --git a/c-api/frame.po b/c-api/frame.po index fabb9e02..2aca2252 100644 --- a/c-api/frame.po +++ b/c-api/frame.po @@ -52,25 +52,25 @@ msgid "Create a new frame object. This function returns a :term:`strong referenc msgstr "یک شیء فریم جدید ایجاد می‌کند. این تابع در صورت موفقیت، یک :term:`ارجاع قوی ` به شیء فریم جدید برمی‌گرداند و در صورت شکست، ``NULL`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند." msgid "Return non-zero if *obj* is a frame object." -msgstr "اگر *obj* یک شیء فریم باشد، مقدار غیر صفر برمی‌گرداند." +msgstr "اگر \*obj\* یک شیء فریم باشد، مقدار غیر صفر برمی‌گرداند." msgid "Previously, this function was only available after including ````." msgstr "پیش‌تر، این تابع تنها پس از گنجاندن ```` در دسترس بود." msgid "Get the *frame* next outer frame." -msgstr "گرفتن فریم بیرونی بعدیِ *frame*." +msgstr "گرفتن فریم بیرونی بعدیِ \*frame\*." msgid "Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame. This raises no exceptions." -msgstr "یک :term:`ارجاع قوی ` برمی‌گرداند، یا اگر *frame* فریم بیرونی نداشته باشد، ``NULL``. این تابع هیچ استثنایی ایجاد نمی‌کند." +msgstr "یک :term:`ارجاع قوی ` برمی‌گرداند، یا اگر \*frame\* فریم بیرونی نداشته باشد، ``NULL``. این تابع هیچ استثنایی ایجاد نمی‌کند." msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute." -msgstr "ویژگی :attr:`~frame.f_builtins` *فریم* را دریافت می‌کند." +msgstr "ویژگی :attr:`~frame.f_builtins` \*فریم\* را دریافت می‌کند." msgid "Return a :term:`strong reference`. The result cannot be ``NULL``." msgstr "یک :term:`strong reference` برمی‌گرداند. نتیجه نمی‌تواند ``NULL`` باشد." msgid "Get the *frame* code." -msgstr "دریافت کد *فریم* ." +msgstr "دریافت کد \*فریم\* ." msgid "Return a :term:`strong reference`." msgstr "یک :term:`strong reference` را برمی‌گرداند." @@ -85,16 +85,16 @@ msgid "Return a :term:`strong reference`, or ``NULL``." msgstr "یک :term:`ارجاع قوی ` یا ``NULL`` برمی‌گرداند." msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute." -msgstr "گرفتن ویژگی :attr:`~frame.f_globals` از *فریم*." +msgstr "گرفتن ویژگی :attr:`~frame.f_globals` از \*فریم\*." msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute." -msgstr "ویژگی :attr:`~frame.f_lasti` *فریم * را دریافت کنید." +msgstr "ویژگی :attr:`~frame.f_lasti` \*فریم \* را دریافت کنید." msgid "Returns -1 if ``frame.f_lasti`` is ``None``." msgstr "اگر ``frame.f_lasti`` برابر با ``None`` باشد، مقدار -1 را برمی‌گرداند." msgid "Get the variable *name* of *frame*." -msgstr "متغیر *name* را از *frame* می‌گیرد." +msgstr "متغیر \*name\* را از \*frame\* می‌گیرد." msgid "Return a :term:`strong reference` to the variable value on success." msgstr "در صورت موفقیت، یک :term:`ارجاع قوی ` به مقدار متغیر برمی‌گرداند." @@ -106,19 +106,19 @@ msgid "Raise an exception and return ``NULL`` on error." msgstr "در صورت خطا، یک استثنا ایجاد کرده و ``NULL`` را برمی‌گرداند." msgid "*name* type must be a :class:`str`." -msgstr "نوع *name* باید :class:`str` باشد." +msgstr "نوع \*name\* باید :class:`str` باشد." msgid "Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string encoded in UTF-8." msgstr "مشابه :c:func:`PyFrame_GetVar`، اما نام متغیر یک رشته C کدگذاری‌شده با UTF-8 است." msgid "Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to an :term:`optimized scope`, this returns a write-through proxy object that allows modifying the locals. In all other cases (classes, modules, :func:`exec`, :func:`eval`) it returns the mapping representing the frame locals directly (as described for :func:`locals`)." -msgstr "ویژگی :attr:`~frame.f_locals` *فریم* را دریافت می‌کند. اگر فریم به یک :term:`محدوده بهینه‌شده ` اشاره کند، یک شیء پراکسی نوشتن‌همزمان برمی‌گرداند که امکان تغییر متغیرهای محلی را فراهم می‌کند. در تمام موارد دیگر (کلاس‌ها، ماژول‌ها، :func:`exec`، :func:`eval`) نگاشتی را برمی‌گرداند که متغیرهای محلی فریم را به‌طور مستقیم نمایش می‌دهد (همان‌طور که برای :func:`locals` توضیح داده شده است)." +msgstr "ویژگی :attr:`~frame.f_locals` \*فریم\* را دریافت می‌کند. اگر فریم به یک :term:`محدوده بهینه‌شده ` اشاره کند، یک شیء پراکسی نوشتن‌همزمان برمی‌گرداند که امکان تغییر متغیرهای محلی را فراهم می‌کند. در تمام موارد دیگر (کلاس‌ها، ماژول‌ها، :func:`exec`، :func:`eval`) نگاشتی را برمی‌گرداند که متغیرهای محلی فریم را به‌طور مستقیم نمایش می‌دهد (همان‌طور که برای :func:`locals` توضیح داده شده است)." msgid "As part of :pep:`667`, return an instance of :c:var:`PyFrameLocalsProxy_Type`." msgstr "به عنوان بخشی از :pep:`667`، یک نمونه از :c:var:`PyFrameLocalsProxy_Type` را برمی‌گرداند." msgid "Return the line number that *frame* is currently executing." -msgstr "شماره سطری که *frame* هم‌اکنون در حال اجرای آن است را بازمی‌گرداند." +msgstr "شماره سطری که \*frame\* هم‌اکنون در حال اجرای آن است را بازمی‌گرداند." msgid "Frame locals proxies" msgstr "پراکسی‌های متغیرهای محلی فریم" @@ -133,7 +133,7 @@ msgid "The type of frame :func:`locals` proxy objects." msgstr "نوع شیءهای پراکسی :func:`locals` در فریم." msgid "Return non-zero if *obj* is a frame :func:`locals` proxy." -msgstr "اگر *obj* یک پراکسی :func:`locals` فریم باشد، مقدار غیر صفر را برمی‌گرداند." +msgstr "اگر \*obj\* یک پراکسی :func:`locals` فریم باشد، مقدار غیر صفر را برمی‌گرداند." msgid "Legacy local variable APIs" msgstr "APIهای قدیمی متغیر محلی" @@ -142,13 +142,13 @@ msgid "These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothin msgstr "این API‌ها :term:`soft deprecated` هستند. از پایتون 3.13 به بعد، آن‌ها هیچ کاری انجام نمی‌دهند. آن‌ها صرفاً برای سازگاری با نسخه‌های قبلی وجود دارند." msgid "Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` attribute of *f* to the internal \"fast\" array of local variables, allowing changes in frame objects to be visible to the interpreter. If *clear* was true, this function would process variables that were unset in the locals dictionary." -msgstr "پیش از پایتون 3.13، این تابع ویژگی :attr:`~frame.f_locals` از *f* را به آرایه‌ی داخلی «سریع» (fast) متغیرهای محلی کپی می‌کرد، به‌طوری‌که تغییرات در اشیاء فریم برای مفسر قابل مشاهده می‌شدند. اگر *clear* درست بود، این تابع متغیرهایی را که در دیکشنری متغیرهای محلی تنظیم نشده بودند پردازش می‌کرد." +msgstr "پیش از پایتون 3.13، این تابع ویژگی :attr:`~frame.f_locals` از \*f\* را به آرایه‌ی داخلی «سریع» (fast) متغیرهای محلی کپی می‌کرد، به‌طوری‌که تغییرات در اشیاء فریم برای مفسر قابل مشاهده می‌شدند. اگر \*clear\* درست بود، این تابع متغیرهایی را که در دیکشنری متغیرهای محلی تنظیم نشده بودند پردازش می‌کرد." msgid "This function now does nothing." msgstr "این تابع اکنون کاری انجام نمی‌دهد." msgid "Prior to Python 3.13, this function would copy the internal \"fast\" array of local variables (which is used by the interpreter) to the :attr:`~frame.f_locals` attribute of *f*, allowing changes in local variables to be visible to frame objects." -msgstr "پیش از پایتون 3.13، این تابع آرایه داخلی «سریع» متغیرهای محلی (که توسط مفسر استفاده می‌شود) را به ویژگی :attr:`~frame.f_locals` از *f* کپی می‌کرد، به‌طوری که تغییرات در متغیرهای محلی برای اشیاء فریم قابل مشاهده باشند." +msgstr "پیش از پایتون 3.13، این تابع آرایه داخلی «سریع» متغیرهای محلی (که توسط مفسر استفاده می‌شود) را به ویژگی :attr:`~frame.f_locals` از \*f\* کپی می‌کرد، به‌طوری که تغییرات در متغیرهای محلی برای اشیاء فریم قابل مشاهده باشند." msgid "Prior to Python 3.13, this function was similar to :c:func:`PyFrame_FastToLocals`, but would return ``0`` on success, and ``-1`` with an exception set on failure." msgstr "پیش از پایتون 3.13، این تابع مشابه :c:func:`PyFrame_FastToLocals` بود، اما در صورت موفقیت ``0`` و در صورت شکست ``-1`` به همراه استثنای تنظیم‌شده برمی‌گرداند." diff --git a/c-api/unicode.po b/c-api/unicode.po index 23e89d6a..6ef2c338 100644 --- a/c-api/unicode.po +++ b/c-api/unicode.po @@ -822,9 +822,9 @@ msgid "" "*byteorder == 0: native order\n" "*byteorder == 1: big endian" msgstr "" -"*byteorder == -1: کوچک‌اندیان\n" -"*byteorder == 0: ترتیب بومی\n" -"*byteorder == 1: بزرگ‌اندیان" +"*byteorder == -1: little endian\n" +"*byteorder == 0: native order\n" +"*byteorder == 1: big endian" msgid "If ``*byteorder`` is zero, and the first four bytes of the input data are a byte order mark (BOM), the decoder switches to this byte order and the BOM is not copied into the resulting Unicode string. If ``*byteorder`` is ``-1`` or ``1``, any byte order mark is copied to the output." msgstr "اگر ``*byteorder`` صفر باشد و چهار بایت نخست داده‌های ورودی، نشانگر ترتیب بایت (BOM) باشند، کدگشا به این ترتیب بایت تغییر می‌کند و BOM در رشته یونیکد حاصل کپی نمی‌شود. اگر ``*byteorder`` برابر ``-1`` یا ``1`` باشد، هر نشانگر ترتیب بایتی به خروجی کپی می‌شود." diff --git a/faq/programming.po b/faq/programming.po index 8b5f1ecf..ad124056 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -1623,7 +1623,7 @@ msgstr "" "['foo', 'item']" msgid "To see why this happens, you need to know that (a) if an object implements an :meth:`~object.__iadd__` magic method, it gets called when the ``+=`` augmented assignment is executed, and its return value is what gets used in the assignment statement; and (b) for lists, :meth:`!__iadd__` is equivalent to calling :meth:`~sequence.extend` on the list and returning the list. That's why we say that for lists, ``+=`` is a \"shorthand\" for :meth:`list.extend`::" -msgstr "برای این‌که ببینید چرا این اتفاق می‌افتد، باید بدانید که (الف) اگر یک شیء متد ویژه :meth:`~object.__iadd__` را پیاده‌سازی کرده باشد، هنگامی که انتساب تقویت‌شده‌ی ``+=`` اجرا شود، آن متد فراخوانی می‌شود و مقدار بازگشتی آن چیزی است که در دستور انتساب به کار می‌رود؛ و (ب) برای فهرست‌ها، :meth:`!__iadd__` معادل فراخوانی :meth:`~sequence.extend` روی فهرست و برگرداندن فهرست است. به همین دلیل است که می‌گوییم برای فهرست‌ها، ``+=`` «میان‌بر» برای :meth:`list.extend` است::" +msgstr "برای این‌که ببینید چرا این اتفاق می‌افتد، باید بدانید که (الف) اگر یک شیء متد جادویی :meth:`~object.__iadd__` را پیاده‌سازی کرده باشد، هنگامی که انتساب تقویت‌شده‌ی ``+=`` اجرا شود، آن متد فراخوانی می‌شود و مقدار بازگشتی آن چیزی است که در دستور انتساب به کار می‌رود؛ و (ب) برای فهرست‌ها، :meth:`!__iadd__` معادل فراخوانی :meth:`~sequence.extend` روی فهرست و برگرداندن فهرست است. به همین دلیل است که می‌گوییم برای فهرست‌ها، ``+=`` «میان‌بر» برای :meth:`list.extend` است::" msgid "" ">>> a_list = []\n" diff --git a/glossary.json b/glossary.json deleted file mode 100644 index 374e49e0..00000000 --- a/glossary.json +++ /dev/null @@ -1,520 +0,0 @@ -{ - "__pycache__": "__pycache__", - "ABC": "کلاس پایه انتزاعی", - "abstract base class": "کلاس پایه انتزاعی", - "accessibility": "دسترسی‌پذیری", - "action": "اکشن، کنش", - "anchor": "لنگر", - "annotate": "حاشیه‌نویسی کردن", - "arena": "آرنا", - "annotation": "حاشیه‌نویسی", - "API": "API", - "argument": "آرگومان", - "ASCII": "اسکی", - "assertion": "ادعا، شرط", - "async": "ناهمگام، غیرهمگام", - "asynchronous context manager": "مدیر زمینه ناهمگام", - "asynchronous generator": "تولیدگر ناهمگام", - "asynchronous iterable": "پیمایش‌پذیر ناهمگام", - "asynchronous iterator": "پیمایش‌گر ناهمگام", - "attribute": "ویژگی، صفت، شاخصه", - "attribute reference": "ارجاع به ویژگی", - "audit": "حسابرسی", - "autospeccing": "مشخصه‌گذاری خودکار", - "availability": "دسترس‌پذیری", - "await": "await", - "awaitable": "انتظارپذیر، awaitable", - "backend": "بک‌اند", - "backreference": "بازارجاع", - "backslash": "بک‌اسلش", - "backspace": "بک‌اسپیس، پس‌بر", - "barrier": "سد", - "BDFL": "BDFL (دیکتاتور خیرخواه مادام‌العمر)", - "big-endian": "بزرگ‌اندیان", - "binary": "دودویی", - "binary file": "پرونده دودویی", - "bind": "مقید کردن", - "bitmap": "بیت‌مپ", - "bitmask": "نقاب بیتی", - "backport": "بک‌پورت", - "bitwise mask": "نقاب بیتی", - "blob": "بلاب", - "boilerplate": "کد پیش‌ساخته، متن قالبی", - "bom, byte-order mark": "نشانگر ترتیب بایت", - "boolean": "بولی", - "bootstrapping": "بوت‌استرپینگ", - "borrowed reference": "ارجاع امانتی", - "bot": "بات", - "bottom tee": "tee پایین", - "bounding box": "جعبه‌ی محدودکننده", - "bound": "کران", - "broadcast (network/event)": "پخش", - "broadcasting (array)": "بسط‌دهی", - "buffer": "بافر", - "build": "ساخت", - "built-in": "توکار، درونی، درون‌ساخته", - "by-name": "نام‌محور", - "bytecode": "بایت‌کد", - "bytes-like object": "شیء شبه‌بایت", - "CA": "مرجع صدور گواهی", - "cache": "نهانگاه", - "calendar": "گاه‌شماری", - "callable": "فراخوانی‌پذیر", - "callback": "کال‌بک، فراخوانی بازگشتی", - "canonical": "کانونیکال", - "capture pattern": "الگوی ثبت‌کننده", - "capturing group": "گروه ثبت‌کننده", - "cardinality": "کاردینالیتی", - "carriage return": "بازگشت به ابتدای سطر", - "cast": "تبدیل نوع، قالب‌ریزی", - "certification": "گواهی‌سازی", - "certificate": "گواهی", - "character": "نویسه", - "checkbutton": "دکمه‌ی انتخابی", - "checksum": "جمع‌آزما", - "chunked": "بخش‌بندی‌شده", - "cipher": "رمز", - "class": "کلاس", - "client": "کلاینت", - "class method": "متد کلاس", - "class variable": "متغیر کلاس", - "classmethod": "classmethod", - "CLI": "رابط خط فرمان، CLI", - "clone": "رونوشت", - "closure": "بستار", - "code point": "نقطه‌کد", - "coercion": "تبدیل ضمنی نوع", - "collation": "ترتیب‌گذاری", - "column": "ستون", - "combobox": "جعبه انتخاب", - "command line": "خط فرمان", - "comment": "کامنت", - "commit (database transaction)": "ثبت نهایی", - "community": "کامیونیتی", - "compile": "کامپایل", - "compiled": "کامپایل‌شده", - "component": "کامپوننت، جزء", - "container": "ظرف", - "context": "زمینه", - "context management": "مدیریت زمینه", - "context manager": "مدیر زمینه", - "context variable": "متغیر زمینه", - "contiguous": "پیوسته", - "contravariant": "پادوردا", - "converter": "مبدل", - "converter function": "تابع تبدیل‌کننده", - "coroutine": "هم‌روال", - "covariant": "هم‌وردا", - "CPU-bound": "محدود به CPU", - "CPython": "سی‌پایتون", - "crash": "فروپاشی", - "CRL": "فهرست لغو گواهی", - "cursor": "مکان‌نما", - "cursor (database)": "نشانگر", - "custom": "سفارشی، اختصاصی", - "daemon": "دِیمِن", - "dataclass": "دیتاکلاس", - "debugging": "اشکال‌زدایی، دیباگ کردن", - "decoding": "کدگشایی", - "deallocater": "آزادساز حافظه", - "decompressor": "واگشا", - "decompression": "واگشایی", - "decorator": "دکوراتور، آراینده", - "deferred reference counting": "شمارش ارجاعِ معوق", - "delegation": "واگذاری", - "delta": "دلتا", - "dependency": "وابستگی", - "dependency resolution": "حل وابستگی", - "deprecated": "منسوخ، از رده خارج شده", - "deque": "صف دوطرفه", - "deleter": "deleter", - "descriptor": "توصیف‌گر", - "deserialization": "سریال‌زدایی", - "deserialize": "سریال‌زدایی کردن", - "deserializer": "سریال‌زدا", - "dialect": "گویش", - "dictionary": "دیکشنری", - "dictionary comprehension": "درک دیکشنری", - "dictionary view": "نمای دیکشنری", - "directive": "دایرکتیو", - "directory": "پوشه", - "disassemble": "واسازی کردن", - "disassembler": "واساز", - "dispatch table": "جدول نگاشت", - "docstring": "رشته مستند", - "DOM": "DOM", - "double (double precision)": "ممیز شناور با دقت مضاعف", - "drop-in": "جایگزین مستقیم", - "duck-typing": "نوع‌دهی اردکی", - "dump": "برون‌ریزی", - "EAFP": "EAFP (بهتر است پوزش بخواهی تا اجازه)", - "ecosystem": "اکوسیستم", - "element": "المان، عنصر", - "ellipsis": "سه‌نقطه", - "Ellipsis": "Ellipsis", - "encoding": "کدگذاری", - "endian": "اندیان", - "endianness": "ترتیب بایت", - "endpoint": "پایانه", - "entitlement": "حق دسترسی", - "entity": "موجودیت", - "enum": "enum", - "embed": "تعبیه کردن", - "embedded": "تعبیه‌شده", - "embedding": "تعبیه", - "envelope": "پاکت", - "EOF": "EOF، پایان پرونده", - "epoch": "مبدأ زمان", - "escape": "خنثی کردن، گریز", - "event": "رویداد", - "exception": "استثنا", - "executor": "اجراکننده", - "export": "اکسپورت", - "expression": "عبارت", - "extended hex alphabet": "الفبای مبنای شانزده‌ی توسعه‌یافته", - "extension module": "ماژول توسعه‌ای", - "extension types": "نوع‌های توسعه‌ای", - "f-string": "اف‌استرینگ", - "facility": "امکان، دسته گزارش", - "factory function": "تابع کارخانه‌ای", - "fallback": "جایگزین", - "frame": "فریم", - "frame (GUI)": "قاب", - "folder": "پوشه", - "file": "پرونده", - "file object": "شیء پرونده", - "file-like object": "شیء شبه‌پرونده", - "filesystem encoding": "کدگذاری فایل‌سیستم", - "finalizer": "نهایی‌ساز", - "frozen": "فریزشده", - "finder": "یابنده", - "fixture": "ثابت آزمایشی", - "flattening": "تخت‌سازی", - "float (type)": "اعشاری", - "float (value)": "عدد اعشاری", - "floating point (adj., representation)": "ممیز شناور", - "floating-point arithmetic": "محاسبات ممیز شناور", - "floating-point number": "عدد ممیز شناور", - "floor division": "تقسیم کف", - "folding": "تا کردن", - "fork": "انشعاب، فورک", - "form feed": "تغذیه‌ی صفحه", - "formatter": "قالب‌بند", - "forward reference": "ارجاع پیشرو", - "free threading": "نخ‌بندی آزاد", - "free variable": "متغیر آزاد", - "free-threaded": "نخ‌آزاد", - "function": "تابع", - "function annotation": "حاشیه‌نویسی تابع", - "futures": "آینده‌نماها، فیوچرز", - "garbage collection": "زباله‌روبی", - "generator": "تولیدگر", - "getatter": "getatter", - "getter": "getter", - "generator expression": "عبارت تولیدگر", - "generic": "عام", - "generic function": "تابع عام، تابع عمومی", - "generic type": "نوع عام", - "GIL": "قفل مفسر سراسری", - "global": "سراسری، عمومی", - "guard": "نگهبان", - "handshake": "دست‌دهی", - "handle": "دسته", - "handler": "هندلر", - "hash-based pyc": "pyc مبتنی بر هش", - "hashable": "هش‌پذیر", - "header": "سرآیند", - "heap": "هیپ", - "hex": "مبنای شانزده", - "hexadecimal": "مبنای شانزده", - "hook": "قلاب", - "howto": "راهنمای عملی", - "IDE": "IDE, محیط توسعه یکپارچه", - "idempotent": "هم‌توان", - "IDN": "IDN، دامنه اینترنتی بین‌المللی", - "immortal": "نامیرا", - "intern": "درونی‌سازی کردن", - "interning": "درونی‌سازی", - "interned": "درونی‌سازی‌شده", - "immutable": "تغییرناپذیر", - "import": "ایمپورت", - "import path": "مسیر ایمپورت", - "importing": "ایمپورت کردن", - "index": "اندیس، شماره", - "inode": "آی‌نود", - "instance": "نمونه", - "integer": "عدد صحیح", - "interactive": "تعاملی", - "interface": "رابط", - "interpolation": "درون‌یابی", - "interpreted": "تفسیرشده", - "interpreter": "مفسر", - "invariant": "ناوردا", - "isolate": "ایزوله کردن", - "IPC": "ارتباط بین‌فرایندی", - "item": "آیتم", - "introspection": "درون‌نگری", - "iterable": "پیمایش‌پذیر", - "iterate": "پیمایش کردن", - "iteration": "پیمایش", - "iterator": "پیمایش‌گر", - "join": "پیوستن، الحاق", - "junction": "اتصال", - "key function": "تابع کلید", - "keybinding": "کلیدبندی", - "keyword": "کلیدواژه", - "keyword argument": "آرگومان کلیدواژه‌ای", - "lambda": "لامبدا", - "LBYL": "LBYL (نگاه کن پیش از پریدن)", - "line": "سطر", - "line feed": "تغذیه‌ی سطر", - "list": "فهرست", - "list comprehension": "درک فهرستی", - "literal": "لفظی", - "literals": "مقادیر لفظی", - "little-endian": "کوچک‌اندیان", - "linker": "پیونددهنده", - "load": "بارگذاری", - "loader": "بارگذار", - "local": "محلی", - "locale": "locale", - "logger": "گزارش‌گیر", - "logging": "گزارش‌گیری", - "long distance matcher": "تطبیق‌گر فاصله بلند", - "lookahead assertion": "شرط پیش‌نگر", - "lookbehind assertion": "شرط پس‌نگر", - "loop": "حلقه", - "magic method": "متد ویژه", - "manager": "مدیر", - "map": "نگاشت", - "mapped": "نگاشت‌شده", - "mapping": "نگاشت", - "marshal": "مارشال‌کردن", - "marshaling/marshalling": "مارشالینگ", - "mask": "نقاب", - "master (pty)": "اصلی", - "match finder": "تطبیق‌یاب", - "max-heap": "هیپ بیشینه", - "meta path finder": "یابنده مسیر فرا", - "metaclass": "فراکلاس", - "method": "متد، روش", - "method resolution order (MRO)": "ترتیب حل متد", - "min-heap": "هیپ کمینه", - "mix-in": "میکس‌این", - "mixed-in": "افزوده‌شده، میکس‌این", - "mock": "ماک", - "mode": "حالت", - "module": "ماژول", - "module spec": "مشخصه ماژول", - "monkey-patch": "مانکی‌پچ", - "mutable": "تغییرپذیر", - "mutex": "قفل متقابل", - "name resolution": "حل نام", - "named tuple": "تاپل نام‌دار", - "namespace": "فضای نام", - "namespace package": "بسته فضای نام", - "NaN": "NaN", - "nested scope": "محدوده تودرتو", - "no-op": "عملیات بی‌اثر", - "non-capturing group": "گروه غیرثبت‌کننده", - "notation": "نمادگذاری، نماد", - "nul": "تهی", - "object": "شیء", - "octet": "هشت‌بیتی", - "offset": "آفست", - "opcode": "کدعمل", - "operator": "عملگر", - "optimized scope": "محدوده بهینه‌شده", - "ordinal": "ترتیبی", - "overload": "سربارگذاری", - "overloaded": "سربارگذاری‌شده", - "package": "بسته", - "padding": "پُرکننده، پدینگ", - "pane": "بخش", - "parallelism": "موازی‌سازی", - "parameter": "پارامتر", - "parser": "پارسر", - "patch": "وصل", - "path entry": "ورودی مسیر", - "path entry finder": "یابنده ورودی مسیر", - "path entry hook": "قلاب ورودی مسیر", - "path-based finder": "یابنده مبتنی بر مسیر", - "path-like object": "شیء شبه‌مسیر", - "pathname": "مسیرنام", - "payload": "بار", - "PEP": "PEP (پیشنهاد بهبود پایتون)", - "persistence": "ماندگاری", - "persistent": "پایا", - "picklable": "پیکل‌پذیر", - "pickle": "پیکل", - "pickler": "پیکل‌ساز", - "pipe": "پایپ", - "placeholder": "جای‌نگهدار", - "poll": "پایش", - "pool": "استخر", - "polling": "پایش", - "portion": "بخش", - "positional": "جایگاهی", - "positional argument": "آرگومان جایگاهی", - "post-mortem debugging": "اشکال‌زدایی پس از خاتمه", - "precision": "دقت", - "predicate": "محمول", - "process": "فرایند", - "process-local": "فرایندمحلی", - "process-safe": "فرایندایمن", - "profiler": "پروفایل‌گیر", - "profiling": "پروفایل‌گیری", - "proleptic Gregorian": "گاه‌شماری میلادی تعمیم‌یافته", - "prompt": "اعلان", - "property": "ویژگی، پراپرتی، خصوصیت", - "protocol": "پروتکل", - "prototype": "پیش‌نمونه", - "provisional API": "API آزمایشی", - "proxy": "پراکسی", - "pseudo-terminal": "شبه‌پایانه", - "qualified": "کامل", - "qualified name": "نام کامل", - "qualifier": "مشخص‌کننده", - "quantifier": "کمیت‌گذار", - "quotation": "علامت نقل‌قول", - "quoted-printable": "quoted-printable", - "race": "رقابت", - "realm": "قلمرو", - "reentrancy": "بازورودپذیری", - "reentrant": "بازورودپذیر", - "refcount": "شمارش ارجاع", - "reference": "ارجاع", - "reference counting": "شمارش ارجاع", - "register": "ثبت کردن", - "registry": "رجیستری", - "regular expression/RE": "عبارت باقاعده", - "regular package": "بسته معمولی", - "REPL": "REPL، پوسته تعاملی پایتون", - "resolution": "حل، وضوح", - "resolve": "حل کردن", - "return": "بازگشت، برگرداندن", - "reverse solidus": "اسلش معکوس", - "rollback": "بازگردانی", - "rollover": "چرخش", - "row": "ردیف", - "run time, run-time": "زمان اجرا", - "runtime": "ران‌تایم", - "salt": "نمک", - "sandbox": "سندباکس", - "sash": "نوار جداکننده", - "scheme": "طرح‌واره، طرح", - "scope": "محدوده", - "seal": "مهر و موم", - "server": "سرور", - "seed": "بذر", - "seek": "مکان‌یابی کردن", - "seeking": "مکان‌یابی", - "setatter": "setatter", - "setter": "setter", - "segmentation fault": "خطای قطعه‌بندی (segmentation fault)", - "sentinel": "نشانگر", - "sequence": "دنباله", - "serialization": "سریال‌سازی", - "set": "مجموعه", - "set comprehension": "درک مجموعه", - "shadowing": "پوشاندن", - "shelf": "قفسه", - "shell": "پوسته", - "signal": "سیگنال", - "single dispatch": "ارسال تک‌گانه", - "single precision": "دقت منفرد", - "singleton": "تک‌نمونه", - "slave (pty)": "پیرو", - "sleep": "توقف", - "slice": "اسلایس", - "slot": "جایگاه", - "snapshot": "تصویر لحظه‌ای", - "spec": "مشخصات", - "special method": "متد ویژه", - "spinbox": "اسپین‌باکس", - "shebang": "خط مفسر", - "stack traceback": "ردگیری پشته", - "state": "وضعیت", - "statement": "دستور", - "static method": "متد ایستا", - "staticmethod": "staticmethod", - "stipple": "نقطه‌نگاری", - "string": "رشته", - "stringifier": "رشته‌ساز", - "struct sequence": "دنباله ساختاری", - "stub": "stub", - "subnormal": "زیرنرمال", - "subscript": "زیرنویس", - "subscription": "زیرنویسی", - "suite": "بدنه", - "surrogate": "جانشین", - "symlink": "پیوند نمادین", - "syntactic sugar": "قند نحوی", - "syntax": "سینتکس، سینتکس", - "t-string": "تی‌استرینگ", - "task": "وظیفه", - "test": "آزمون", - "test fixture": "ثابت آزمایشی", - "text encoding": "کدگذاری متن", - "text file": "پرونده متنی", - "thread": "نخ", - "thread-local": "نخ‌محلی", - "thread-safe": "نخ‌ایمن", - "time tuple": "تاپل زمانی", - "timeout": "مهلت زمانی", - "titlecase": "نگارش عنوان‌نویسی", - "titlecased": "عنوان‌نویسی‌شده", - "TLS": "TLS", - "token": "توکن", - "tokenizer": "توکن‌ساز", - "trace": "ردگیری", - "tracking": "پیگیری", - "trampoline": "ترامپولین", - "transcode": "بازکدگذاری کردن", - "transcoding": "بازکدگذاری", - "transformer": "تبدیل کننده", - "Transport Layer Security": "امنیت لایه انتقال", - "trap (catch/intercept)": "گرفتن، رهگیری کردن", - "trap (decimal signal mechanism)": "تله", - "treeview": "نمای درختی", - "triple-quoted string": "رشته سه‌نقل‌قولی", - "turtle": "turtle، لاک‌پشت", - "type": "نوع، نوع داده، تایپ", - "type alias": "مستعار نوع", - "type hint": "راهنمای نوع", - "typeahead": "پیش‌تایپ", - "unary": "یک‌عملوندی", - "undo buffer": "بافر لغو", - "unhashable": "هش‌ناپذیر", - "URL": "URL، نشانی‌وب", - "unicode": "یونیکد", - "unit test": "آزمون واحد", - "universal": "همگانی", - "universal newlines": "سطرهای جدید همگانی", - "unmarshal": "مارشال‌گشایی کردن", - "unmarshaling": "مارشال‌گشایی", - "unpacking": "واگشایی", - "unraisable": "غیرقابل‌پرتاب", - "unpacking assignments": "انتساب‌های واگشایی", - "unpickle": "پیکل‌گشایی", - "UTC": "UTC، زمان هماهنگ جهانی", - "value": "مقدار", - "variable": "متغیر", - "variable annotation": "حاشیه‌نویسی متغیر", - "view": "نما", - "verbose": "پرگو، پرجزئیات", - "virtual environment": "محیط مجازی", - "walrus operator": "عملگر گراز دریایی", - "weak reference": "ارجاع ضعیف", - "wide": "پهن", - "widget": "ابزارک", - "wildcard": "وایلدکارد", - "wrap": "پوشش دادن، دربرگرفتن", - "wrapper": "پوششی، دربرگیرنده", - "write-back": "بازنوشت", - "write-through": "نوشتن‌همزمان", - "zero-padded": "پرشده با صفر", - "zero-padding": "پدینگ صفر", - "zero-width assertion": "شرط با عرض صفر", - "zip application": "برنامه zip" -} \ No newline at end of file diff --git a/glossary.po b/glossary.po index 2723b7ab..4a5b7ad7 100644 --- a/glossary.po +++ b/glossary.po @@ -52,7 +52,7 @@ 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 `). 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:`magic methods `)، :term:`نوع‌دهی اردکی ` را تکمیل می‌کنند. ABCها زیرکلاس‌های مجازی معرفی می‌کنند، که کلاس‌هایی هستند که از یک کلاس دیگر به ارث نمی‌برند اما همچنان توسط :func:`isinstance` و :func:`issubclass` شناخته می‌شوند؛ مستندات ماژول :mod:`abc` را ببینید. پایتون همراه با ABCهای توکار بسیاری برای ساختارهای داده (در ماژول :mod:`collections.abc`)، اعداد (در ماژول :mod:`numbers`)، جریان‌ها (در ماژول :mod:`io`)، یابنده‌ها و بارگذارهای ایمپورت (در ماژول :mod:`importlib.abc`) ارائه می‌شود. شما می‌توانید ABCهای سفارشی خود را با ماژول :mod:`abc` ایجاد کنید." +msgstr "کلاس‌های پایه‌ی انتزاعی با فراهم کردن روشی برای تعریف رابط‌ها، زمانی که تکنیک‌های دیگری مانند :func:`hasattr` دست‌وپاگیر یا به‌طور ضمنی نادرست هستند (برای مثال با :ref:`متدهای جادویی `)، :term:`نوع‌دهی اردکی ` را تکمیل می‌کنند. 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 "توابع حاشیه‌گذاری" @@ -915,7 +915,7 @@ msgid "See also the :term:`filesystem encoding and error handler`." msgstr "همچنین :term:`کدگذاری سیستم پرونده و هندلر خطا ` را ببینید." msgid "magic method" -msgstr "متد ویژه" +msgstr "متد جادویی" msgid "An informal synonym for :term:`special method`." msgstr "یک مترادف غیررسمی برای :term:`متد ویژه `." diff --git a/glossary.tsv b/glossary.tsv index 2da075be..e9c728c8 100644 --- a/glossary.tsv +++ b/glossary.tsv @@ -288,7 +288,7 @@ long distance matcher تطبیق‌گر فاصله بلند lookahead assertion شرط پیش‌نگر lookbehind assertion شرط پس‌نگر loop حلقه -magic method متد ویژه +magic method متد جادویی manager مدیر map نگاشت mapped نگاشت‌شده diff --git a/library/asyncio-task.po b/library/asyncio-task.po index 213ed826..733f8673 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -79,7 +79,7 @@ msgid "The :func:`asyncio.run` function to run the top-level entry point \"main( msgstr "تابع :func:`asyncio.run` برای اجرای تابع نقطه ورود سطح بالا \"main()\" (مثال بالا را ببینید.)" msgid "Awaiting on a coroutine. The following snippet of code will print \"hello\" after waiting for 1 second, and then print \"world\" after waiting for *another* 2 seconds::" -msgstr "در انتظار یک هم‌روال. قطعه‌کد زیر پس از انتظار برای ۱ ثانیه، «hello» را چاپ می‌کند و سپس «world» را پس از انتظار برای ۲ ثانیه‌ی *دیگر* چاپ خواهد کرد::" +msgstr "در انتظار یک هم‌روال. قطعه‌کد زیر پس از انتظار برای ۱ ثانیه، «hello» را چاپ می‌کند و سپس «world» را پس از انتظار برای ۲ ثانیه‌ی \*دیگر\* چاپ خواهد کرد::" msgid "" "import asyncio\n" @@ -134,7 +134,7 @@ msgid "The :func:`asyncio.create_task` function to run coroutines concurrently a msgstr "تابع :func:`asyncio.create_task` برای اجرای همزمان هم‌روال‌ها به‌عنوان :class:`Tasks ` در asyncio." msgid "Let's modify the above example and run two ``say_after`` coroutines *concurrently*::" -msgstr "بیایید مثال بالا را تغییر دهیم و دو هم‌روال ``say_after`` را *همزمان* اجرا کنیم::" +msgstr "بیایید مثال بالا را تغییر دهیم و دو هم‌روال ``say_after`` را \*همزمان\* اجرا کنیم::" msgid "" "async def main():\n" @@ -228,10 +228,10 @@ msgid "We say that an object is an **awaitable** object if it can be used in an msgstr "می‌گوییم که یک شیء در صورتی یک شیء **awaitable** است که بتوان از آن در یک عبارت :keyword:`await` استفاده کرد. بسیاری از APIهای asyncio برای پذیرش awaitableها طراحی شده‌اند." msgid "There are three main types of *awaitable* objects: **coroutines**, **Tasks**, and **Futures**." -msgstr "سه نوع اصلی از اشیای *awaitable* وجود دارد: **هم‌روال‌ها**، **Taskها** و **Futureها**." +msgstr "سه نوع اصلی از اشیای \*awaitable\* وجود دارد: **هم‌روال‌ها**، **Taskها** و **Futureها**." msgid "Python coroutines are *awaitables* and therefore can be awaited from other coroutines::" -msgstr "هم‌روال‌های پایتون *awaitables* هستند و بنابراین می‌توان آن‌ها را از هم‌روال‌های دیگر await کرد::" +msgstr "هم‌روال‌های پایتون \*awaitables\* هستند و بنابراین می‌توان آن‌ها را از هم‌روال‌های دیگر await کرد::" msgid "" "import asyncio\n" @@ -270,19 +270,19 @@ msgid "In this documentation the term \"coroutine\" can be used for two closely msgstr "در این مستندات، اصطلاح «هم‌روال» می‌تواند برای دو مفهوم بسیار مرتبط به‌کار رود:" msgid "a *coroutine function*: an :keyword:`async def` function;" -msgstr "یک *تابع هم‌روال*: یک تابع :keyword:`async def`؛" +msgstr "یک \*تابع هم‌روال\*: یک تابع :keyword:`async def`؛" msgid "a *coroutine object*: an object returned by calling a *coroutine function*." -msgstr "یک *شیء هم‌روال*: شیءای که با فراخوانی یک *تابع هم‌روال* برگردانده می‌شود." +msgstr "یک \*شیء هم‌روال\*: شیءای که با فراخوانی یک \*تابع هم‌روال\* برگردانده می‌شود." msgid "Tasks" msgstr "وظایف" msgid "*Tasks* are used to schedule coroutines *concurrently*." -msgstr "*وظایف* برای زمان‌بندی هم‌روال‌ها به‌صورت همزمان استفاده می‌شوند." +msgstr "\*وظایف\* برای زمان‌بندی هم‌روال‌ها به‌صورت همزمان استفاده می‌شوند." msgid "When a coroutine is wrapped into a *Task* with functions like :func:`asyncio.create_task` the coroutine is automatically scheduled to run soon::" -msgstr "هنگامی که یک هم‌روال با توابعی مانند :func:`asyncio.create_task` در یک *Task* قرار می‌گیرد، آن هم‌روال به‌طور خودکار زمان‌بندی می‌شود تا به‌زودی اجرا شود::" +msgstr "هنگامی که یک هم‌روال با توابعی مانند :func:`asyncio.create_task` در یک \*Task\* قرار می‌گیرد، آن هم‌روال به‌طور خودکار زمان‌بندی می‌شود تا به‌زودی اجرا شود::" msgid "" "import asyncio\n" @@ -324,7 +324,7 @@ msgid "A :class:`Future` is a special **low-level** awaitable object that repres msgstr ":class:`Future` یک شیء خاص **سطح پایین** قابل await (awaitable) است که نشان‌دهنده‌ی **نتیجه نهایی** یک عملیات ناهمگام است." msgid "When a Future object is *awaited* it means that the coroutine will wait until the Future is resolved in some other place." -msgstr "هنگامی که یک شیء Future *await* می‌شود، به این معنا است که هم‌روال منتظر می‌ماند تا Future در جای دیگری حل شود." +msgstr "هنگامی که یک شیء Future \*await\* می‌شود، به این معنا است که هم‌روال منتظر می‌ماند تا Future در جای دیگری حل شود." msgid "Future objects in asyncio are needed to allow callback-based code to be used with async/await." msgstr "اشیای Future در asyncio لازم هستند تا بتوان از کد مبتنی بر کال‌بک با async/await استفاده کرد." @@ -364,16 +364,16 @@ msgid "**Source code:** :source:`Lib/asyncio/tasks.py`" msgstr "**کد منبع:** :source:`Lib/asyncio/tasks.py`" msgid "Wrap the *coro* :ref:`coroutine ` into a :class:`Task` and schedule its execution. Return the Task object." -msgstr ":ref:`هم‌روال ` *coro* را در یک :class:`Task` قرار می‌دهد و اجرای آن را زمان‌بندی می‌کند. شیء Task را برمی‌گرداند." +msgstr ":ref:`هم‌روال ` \*coro\* را در یک :class:`Task` قرار می‌دهد و اجرای آن را زمان‌بندی می‌کند. شیء Task را برمی‌گرداند." msgid "The full function signature is largely the same as that of the :class:`Task` constructor (or factory) - all of the keyword arguments to this function are passed through to that interface." msgstr "امضای کامل تابع تا حد زیادی مشابه سازنده‌ی :class:`Task` (یا کارخانه) است؛ تمام آرگومان‌های کلیدواژه‌ای این تابع به آن رابط منتقل می‌شوند." msgid "An optional keyword-only *context* argument allows specifying a custom :class:`contextvars.Context` for the *coro* to run in. The current context copy is created when no *context* is provided." -msgstr "یک آرگومان اختیاری فقط کلیدواژه‌ای *context* به شما امکان می‌دهد یک :class:`contextvars.Context` سفارشی برای اجرای *coro* مشخص کنید. اگر *context* ارائه نشود، یک کپی از زمینه فعلی ایجاد می‌شود." +msgstr "یک آرگومان اختیاری فقط کلیدواژه‌ای \*context\* به شما امکان می‌دهد یک :class:`contextvars.Context` سفارشی برای اجرای \*coro\* مشخص کنید. اگر \*context\* ارائه نشود، یک کپی از زمینه فعلی ایجاد می‌شود." msgid "An optional keyword-only *eager_start* argument allows specifying if the task should execute eagerly during the call to create_task, or be scheduled later. If *eager_start* is not passed the mode set by :meth:`loop.set_task_factory` will be used." -msgstr "یک آرگومان اختیاری فقط کلیدواژه‌ای *eager_start* به شما امکان می‌دهد مشخص کنید که آیا وظیفهباید در حین فراخوانی create_task به‌صورت فوری اجرا شود یا بعداً زمان‌بندی شود. اگر *eager_start* ارسال نشود، حالت تنظیم‌شده توسط :meth:`loop.set_task_factory` استفاده خواهد شد." +msgstr "یک آرگومان اختیاری فقط کلیدواژه‌ای \*eager_start\* به شما امکان می‌دهد مشخص کنید که آیا وظیفهباید در حین فراخوانی create_task به‌صورت فوری اجرا شود یا بعداً زمان‌بندی شود. اگر \*eager_start\* ارسال نشود، حالت تنظیم‌شده توسط :meth:`loop.set_task_factory` استفاده خواهد شد." msgid "The task is executed in the loop returned by :func:`get_running_loop`, :exc:`RuntimeError` is raised if there is no running loop in current thread." msgstr "این وظیفه در حلقه‌ای که :func:`get_running_loop` برمی‌گرداند اجرا می‌شود؛ اگر حلقه‌ی در حال اجرا در نخ جاری وجود نداشته باشد، :exc:`RuntimeError` پرتاب می‌شود." @@ -412,13 +412,13 @@ msgstr "" " task.add_done_callback(background_tasks.discard)" msgid "Added the *name* parameter." -msgstr "پارامتر *name* افزوده شد." +msgstr "پارامتر \*name\* افزوده شد." msgid "Added the *context* parameter." -msgstr "پارامتر *context* افزوده شد." +msgstr "پارامتر \*context\* افزوده شد." msgid "Added the *eager_start* parameter by passing on all *kwargs*." -msgstr "پارامتر *eager_start* با ارسال تمام *kwargs* افزوده شد." +msgstr "پارامتر \*eager_start\* با ارسال تمام \*kwargs\* افزوده شد." msgid "Task cancellation" msgstr "لغو وظیفه" @@ -448,7 +448,7 @@ msgid "Close the given coroutine if the task group is not active." msgstr "اگر گروه وظیفه فعال نیست، هم‌روال داده‌شده را ببندید." msgid "Passes on all *kwargs* to :meth:`loop.create_task`" -msgstr "تمام *kwargs* را به :meth:`loop.create_task` منتقل می‌کند" +msgstr "تمام \*kwargs\* را به :meth:`loop.create_task` منتقل می‌کند" msgid "Example::" msgstr "مثال::" @@ -576,10 +576,10 @@ msgid "Sleeping" msgstr "توقف" msgid "Block for *delay* seconds." -msgstr "به مدت *delay* ثانیه مسدود می‌شود." +msgstr "به مدت \*delay\* ثانیه مسدود می‌شود." msgid "If *result* is provided, it is returned to the caller when the coroutine completes." -msgstr "اگر *result* ارائه شده باشد، پس از تکمیل هم‌روال، به فراخواننده بازگردانده می‌شود." +msgstr "اگر \*result\* ارائه شده باشد، پس از تکمیل هم‌روال، به فراخواننده بازگردانده می‌شود." msgid "``sleep()`` always suspends the current task, allowing other tasks to run." msgstr "``sleep()`` همیشه وظیفهجاری را معلق می‌کند و به سایر وظایف اجازه اجرا می‌دهد." @@ -620,37 +620,37 @@ msgstr "" "asyncio.run(display_date())" msgid "Removed the *loop* parameter." -msgstr "پارامتر *loop* حذف شد." +msgstr "پارامتر \*loop\* حذف شد." msgid "Raises :exc:`ValueError` if *delay* is :data:`~math.nan`." -msgstr "اگر *delay* برابر با :data:`~math.nan` باشد، :exc:`ValueError` پرتاب می‌شود." +msgstr "اگر \*delay\* برابر با :data:`~math.nan` باشد، :exc:`ValueError` پرتاب می‌شود." msgid "Running tasks concurrently" msgstr "اجرای همزمان وظایف" msgid "Run :ref:`awaitable objects ` in the *aws* sequence *concurrently*." -msgstr ":ref:`اشیاء awaitable ` را در دنباله‌ی *aws* به‌صورت *همزمان* اجرا کنید." +msgstr ":ref:`اشیاء awaitable ` را در دنباله‌ی \*aws\* به‌صورت \*همزمان\* اجرا کنید." msgid "If any awaitable in *aws* is a coroutine, it is automatically scheduled as a Task." -msgstr "اگر هر awaitable در *aws* یک هم‌روال باشد، به‌طور خودکار به‌عنوان یک Task زمان‌بندی می‌شود." +msgstr "اگر هر awaitable در \*aws\* یک هم‌روال باشد، به‌طور خودکار به‌عنوان یک Task زمان‌بندی می‌شود." msgid "If all awaitables are completed successfully, the result is an aggregate list of returned values. The order of result values corresponds to the order of awaitables in *aws*." -msgstr "اگر همه‌ی awaitableها با موفقیت کامل شوند، نتیجه یک فهرست تجمیعی از مقادیر بازگشتی است. ترتیب مقادیر نتیجه با ترتیب awaitableها در *aws* مطابقت دارد." +msgstr "اگر همه‌ی awaitableها با موفقیت کامل شوند، نتیجه یک فهرست تجمیعی از مقادیر بازگشتی است. ترتیب مقادیر نتیجه با ترتیب awaitableها در \*aws\* مطابقت دارد." msgid "If *return_exceptions* is ``False`` (default), the first raised exception is immediately propagated to the task that awaits on ``gather()``. Other awaitables in the *aws* sequence **won't be cancelled** and will continue to run." -msgstr "اگر *return_exceptions* ``False`` (پیش‌فرض) باشد، نخستین استثنای پرتاب‌شده بلافاصله به وظیفه‌ای که ``gather()`` را await می‌کند، منتشر می‌شود. سایر اشیاء قابل انتظار (awaitable) در دنباله‌ی *aws* **لغو نخواهند شد** و به اجرا ادامه خواهند داد." +msgstr "اگر \*return_exceptions\* ``False`` (پیش‌فرض) باشد، نخستین استثنای پرتاب‌شده بلافاصله به وظیفه‌ای که ``gather()`` را await می‌کند، منتشر می‌شود. سایر اشیاء قابل انتظار (awaitable) در دنباله‌ی \*aws\* **لغو نخواهند شد** و به اجرا ادامه خواهند داد." msgid "If *return_exceptions* is ``True``, exceptions are treated the same as successful results, and aggregated in the result list." -msgstr "اگر *return_exceptions* برابر ``True`` باشد، استثناها همانند نتایج موفق در نظر گرفته می‌شوند و در فهرست نتایج جمع‌آوری می‌شوند." +msgstr "اگر \*return_exceptions\* برابر ``True`` باشد، استثناها همانند نتایج موفق در نظر گرفته می‌شوند و در فهرست نتایج جمع‌آوری می‌شوند." msgid "If ``gather()`` is *cancelled*, all submitted awaitables (that have not completed yet) are also *cancelled*." -msgstr "اگر ``gather()`` *لغو شود*، تمام awaitableهای ارسال‌شده (که هنوز کامل نشده‌اند) نیز *لغو می‌شوند*." +msgstr "اگر ``gather()`` \*لغو شود\*، تمام awaitableهای ارسال‌شده (که هنوز کامل نشده‌اند) نیز \*لغو می‌شوند\*." msgid "If any Task or Future from the *aws* sequence is *cancelled*, it is treated as if it raised :exc:`CancelledError` -- the ``gather()`` call is **not** cancelled in this case. This is to prevent the cancellation of one submitted Task/Future to cause other Tasks/Futures to be cancelled." -msgstr "اگر هر Task یا Future از دنباله‌ی *aws* *لغوشده* باشد، با آن به‌گونه‌ای رفتار می‌شود که گویی :exc:`CancelledError` را پرتاب کرده است — در این حالت، فراخوانی ``gather()`` لغو **نمی‌شود**. این برای جلوگیری از این است که لغو یک Task/Future ارسال‌شده، باعث لغو سایر Taskها/Futureها شود." +msgstr "اگر هر Task یا Future از دنباله‌ی \*aws\* \*لغوشده\* باشد، با آن به‌گونه‌ای رفتار می‌شود که گویی :exc:`CancelledError` را پرتاب کرده است — در این حالت، فراخوانی ``gather()`` لغو **نمی‌شود**. این برای جلوگیری از این است که لغو یک Task/Future ارسال‌شده، باعث لغو سایر Taskها/Futureها شود." msgid "A new alternative to create and run tasks concurrently and wait for their completion is :class:`asyncio.TaskGroup`. *TaskGroup* provides stronger safety guarantees than *gather* for scheduling a nesting of subtasks: if a task (or a subtask, a task scheduled by a task) raises an exception, *TaskGroup* will, while *gather* will not, cancel the remaining scheduled tasks." -msgstr "یک جایگزین جدید برای ایجاد و اجرای همزمان وظیفه‌ها و انتظار برای تکمیل آن‌ها، :class:`asyncio.TaskGroup` است. *TaskGroup* برای زمان‌بندی زیروظیفه‌های تودرتو، نسبت به *gather* تضمین‌های ایمنی قوی‌تری فراهم می‌کند: اگر یک وظیفه (یا یک زیروظیفه، یعنی وظیفه‌ای که توسط یک وظیفه زمان‌بندی شده است) استثنایی را پرتاب کند، *TaskGroup* وظیفه‌های زمان‌بندی‌شده‌ی باقی‌مانده را لغو می‌کند، در حالی که *gather* این کار را نمی‌کند." +msgstr "یک جایگزین جدید برای ایجاد و اجرای همزمان وظیفه‌ها و انتظار برای تکمیل آن‌ها، :class:`asyncio.TaskGroup` است. \*TaskGroup\* برای زمان‌بندی زیروظیفه‌های تودرتو، نسبت به \*gather\* تضمین‌های ایمنی قوی‌تری فراهم می‌کند: اگر یک وظیفه (یا یک زیروظیفه، یعنی وظیفه‌ای که توسط یک وظیفه زمان‌بندی شده است) استثنایی را پرتاب کند، \*TaskGroup\* وظیفه‌های زمان‌بندی‌شده‌ی باقی‌مانده را لغو می‌کند، در حالی که \*gather\* این کار را نمی‌کند." msgid "" "import asyncio\n" @@ -724,10 +724,10 @@ msgstr "" "# [2, 6, 24]" msgid "If *return_exceptions* is false, cancelling gather() after it has been marked done won't cancel any submitted awaitables. For instance, gather can be marked done after propagating an exception to the caller, therefore, calling ``gather.cancel()`` after catching an exception (raised by one of the awaitables) from gather won't cancel any other awaitables." -msgstr "اگر *return_exceptions* نادرست باشد، لغو gather() پس از آن‌که به‌عنوان انجام‌شده علامت‌گذاری شده باشد، هیچ‌کدام از موارد قابل await (awaitable) ارسال‌شده را لغو نمی‌کند. برای مثال، gather می‌تواند پس از انتشار یک استثنا به فراخواننده، به‌عنوان انجام‌شده علامت‌گذاری شود؛ بنابراین، فراخوانی ``gather.cancel()`` پس از گرفتن استثنایی از gather (که توسط یکی از موارد قابل await پرتاب‌شده است)، هیچ مورد قابل await دیگری را لغو نمی‌کند." +msgstr "اگر \*return_exceptions\* نادرست باشد، لغو gather() پس از آن‌که به‌عنوان انجام‌شده علامت‌گذاری شده باشد، هیچ‌کدام از موارد قابل await (awaitable) ارسال‌شده را لغو نمی‌کند. برای مثال، gather می‌تواند پس از انتشار یک استثنا به فراخواننده، به‌عنوان انجام‌شده علامت‌گذاری شود؛ بنابراین، فراخوانی ``gather.cancel()`` پس از گرفتن استثنایی از gather (که توسط یکی از موارد قابل await پرتاب‌شده است)، هیچ مورد قابل await دیگری را لغو نمی‌کند." msgid "If the *gather* itself is cancelled, the cancellation is propagated regardless of *return_exceptions*." -msgstr "اگر خود *gather* لغو شود، لغو صرف‌نظر از *return_exceptions* انتشار می‌یابد." +msgstr "اگر خود \*gather\* لغو شود، لغو صرف‌نظر از \*return_exceptions\* انتشار می‌یابد." msgid "Deprecation warning is emitted if no positional arguments are provided or not all positional arguments are Future-like objects and there is no running event loop." msgstr "در صورتی که هیچ آرگومان جایگاهی ارائه نشده باشد یا همه‌ی آرگومان‌های جایگاهی اشیای Future-مانند نباشند و هیچ حلقه‌ی رویدادی در حال اجرا وجود نداشته باشد، هشدار از رده خارج شدن نشان داده می‌شود." @@ -748,13 +748,13 @@ msgid "Immediate execution of the coroutine is a semantic change. If the corouti msgstr "اجرای فوری هم‌روال یک تغییر معنایی است. اگر هم‌روال مقداری برگرداند یا استثنایی پرتاب کند، وظیفه هرگز در حلقه رویداد زمان‌بندی نمی‌شود. اگر اجرای هم‌روال مسدود شود، وظیفه در حلقه رویداد زمان‌بندی می‌شود. این تغییر ممکن است تغییراتی در رفتار برنامه‌های موجود ایجاد کند. برای مثال، ترتیب اجرای وظایف برنامه احتمالاً تغییر خواهد کرد." msgid "Create an eager task factory, similar to :func:`eager_task_factory`, using the provided *custom_task_constructor* when creating a new task instead of the default :class:`Task`." -msgstr "یک کارخانه وظیفه فوری ایجاد کنید، مشابه :func:`eager_task_factory`، که هنگام ایجاد یک وظیفه جدید، به‌جای :class:`Task` پیش‌فرض، از *custom_task_constructor* ارائه‌شده استفاده می‌کند." +msgstr "یک کارخانه وظیفه فوری ایجاد کنید، مشابه :func:`eager_task_factory`، که هنگام ایجاد یک وظیفه جدید، به‌جای :class:`Task` پیش‌فرض، از \*custom_task_constructor\* ارائه‌شده استفاده می‌کند." msgid "*custom_task_constructor* must be a *callable* with the signature matching the signature of :class:`Task.__init__ `. The callable must return a :class:`asyncio.Task`-compatible object." -msgstr "*custom_task_constructor* باید یک *فراخوانی‌پذیر * با امضایی مطابق با امضای :class:`Task.__init__ ` باشد. این فراخوانی‌پذیر باید یک شیء سازگار با :class:`asyncio.Task` بازگشت دهد." +msgstr "\*custom_task_constructor\* باید یک \*فراخوانی‌پذیر \* با امضایی مطابق با امضای :class:`Task.__init__ ` باشد. این فراخوانی‌پذیر باید یک شیء سازگار با :class:`asyncio.Task` بازگشت دهد." msgid "This function returns a *callable* intended to be used as a task factory of an event loop via :meth:`loop.set_task_factory(factory) `)." -msgstr "این تابع یک شیء *فراخوانی‌پذیر* را برمی‌گرداند که برای استفاده به‌عنوان کارخانه‌ی وظیفه یک حلقه‌ی رویداد از طریق :meth:`loop.set_task_factory(factory) ` در نظر گرفته شده است." +msgstr "این تابع یک شیء \*فراخوانی‌پذیر\* را برمی‌گرداند که برای استفاده به‌عنوان کارخانه‌ی وظیفه یک حلقه‌ی رویداد از طریق :meth:`loop.set_task_factory(factory) ` در نظر گرفته شده است." msgid "Shielding from cancellation" msgstr "محافظت در برابر لغو" @@ -763,7 +763,7 @@ msgid "Protect an :ref:`awaitable object ` from being :meth: msgstr "از یک :ref:`شیء awaitable ` در برابر :meth:`لغو شدن ` محافظت کنید." msgid "If *aw* is a coroutine it is automatically scheduled as a Task." -msgstr "اگر *aw* یک هم‌روال باشد، به‌طور خودکار به‌عنوان یک Task زمان‌بندی می‌شود." +msgstr "اگر \*aw\* یک هم‌روال باشد، به‌طور خودکار به‌عنوان یک Task زمان‌بندی می‌شود." msgid "The statement::" msgstr "دستور::" @@ -782,7 +782,7 @@ msgid "res = await something()" msgstr "res = await something()" msgid "*except* that if the coroutine containing it is cancelled, the Task running in ``something()`` is not cancelled. From the point of view of ``something()``, the cancellation did not happen. Although its caller is still cancelled, so the \"await\" expression still raises a :exc:`CancelledError`." -msgstr "*به جز* اینکه اگر هم‌روال حاوی آن لغو شود، Task در حال اجرا در ``something()`` لغو نمی‌شود. از دید ``something()``، لغو رخ نداده است. اگرچه فراخواننده‌ی آن همچنان لغو می‌شود، بنابراین عبارت \"await\" همچنان یک :exc:`CancelledError` را پرتاب می‌کند." +msgstr "\*به جز\* اینکه اگر هم‌روال حاوی آن لغو شود، Task در حال اجرا در ``something()`` لغو نمی‌شود. از دید ``something()``، لغو رخ نداده است. اگرچه فراخواننده‌ی آن همچنان لغو می‌شود، بنابراین عبارت \"await\" همچنان یک :exc:`CancelledError` را پرتاب می‌کند." msgid "If ``something()`` is cancelled by other means (i.e. from within itself) that would also cancel ``shield()``." msgstr "اگر ``something()`` به روش‌های دیگر لغو شود (یعنی از درون خودش)، این موضوع ``shield()`` را نیز لغو می‌کند." @@ -807,7 +807,7 @@ msgid "Save a reference to tasks passed to this function, to avoid a task disapp msgstr "برای جلوگیری از ناپدید شدن یک وظیفه در میانه‌ی اجرا، ارجاعی به وظایف داده‌شده به این تابع ذخیره کنید. حلقه‌ی رویداد فقط ارجاع‌های ضعیف به وظایف را نگه می‌دارد. وظیفهی که در جای دیگری به آن ارجاع داده نشده است، ممکن است در هر زمانی، حتی پیش از آنکه به پایان برسد، زباله‌روبی شود." msgid "Deprecation warning is emitted if *aw* is not Future-like object and there is no running event loop." -msgstr "اگر *aw* یک شیء شبیه Future نباشد و حلقه رویدادی در حال اجرا وجود نداشته باشد، هشدار از رده خارج شدن نشان داده می‌شود." +msgstr "اگر \*aw\* یک شیء شبیه Future نباشد و حلقه رویدادی در حال اجرا وجود نداشته باشد، هشدار از رده خارج شدن نشان داده می‌شود." msgid "Timeouts" msgstr "مهلت‌های زمانی" @@ -816,7 +816,7 @@ msgid "Return an :ref:`asynchronous context manager ` th msgstr "یک :ref:`مدیر زمینه ناهمگام ` برمی‌گرداند که می‌توان از آن برای محدود کردن مدت زمانی که صرف انتظار برای چیزی می‌شود استفاده کرد." msgid "*delay* can either be ``None``, or a float/int number of seconds to wait. If *delay* is ``None``, no time limit will be applied; this can be useful if the delay is unknown when the context manager is created." -msgstr "*delay* می‌تواند ``None`` یا عددی از نوع float/int برای تعداد ثانیه‌های انتظار باشد. اگر *delay* برابر ``None`` باشد، هیچ محدودیت زمانی اعمال نخواهد شد؛ این موضوع می‌تواند زمانی مفید باشد که تأخیر در هنگام ایجاد مدیر زمینه نامشخص باشد." +msgstr "\*delay\* می‌تواند ``None`` یا عددی از نوع float/int برای تعداد ثانیه‌های انتظار باشد. اگر \*delay\* برابر ``None`` باشد، هیچ محدودیت زمانی اعمال نخواهد شد؛ این موضوع می‌تواند زمانی مفید باشد که تأخیر در هنگام ایجاد مدیر زمینه نامشخص باشد." msgid "In either case, the context manager can be rescheduled after creation using :meth:`Timeout.reschedule`." msgstr "در هر صورت، می‌توان مدیر زمینه را پس از ایجاد، با استفاده از :meth:`Timeout.reschedule` دوباره زمان‌بندی کرد." @@ -834,7 +834,7 @@ msgid "If ``long_running_task`` takes more than 10 seconds to complete, the cont msgstr "اگر تکمیل ``long_running_task`` بیش از ۱۰ ثانیه طول بکشد، مدیر زمینه، وظیفه جاری را لغو می‌کند و :exc:`asyncio.CancelledError` حاصل را به‌صورت داخلی مدیریت می‌کند و آن را به :exc:`TimeoutError` تبدیل می‌کند که می‌توان آن را گرفت و مدیریت کرد." msgid "The :func:`asyncio.timeout` context manager is what transforms the :exc:`asyncio.CancelledError` into a :exc:`TimeoutError`, which means the :exc:`TimeoutError` can only be caught *outside* of the context manager." -msgstr "مدیر زمینه‌ی :func:`asyncio.timeout` همان چیزی است که :exc:`asyncio.CancelledError` را به :exc:`TimeoutError` تبدیل می‌کند، به این معنا که :exc:`TimeoutError` فقط در *خارج* از مدیر زمینه قابل گرفتن است." +msgstr "مدیر زمینه‌ی :func:`asyncio.timeout` همان چیزی است که :exc:`asyncio.CancelledError` را به :exc:`TimeoutError` تبدیل می‌کند، به این معنا که :exc:`TimeoutError` فقط در \*خارج\* از مدیر زمینه قابل گرفتن است." msgid "Example of catching :exc:`TimeoutError`::" msgstr "نمونه‌ای از گرفتن :exc:`TimeoutError`::" @@ -920,7 +920,7 @@ msgid "Timeout context managers can be safely nested." msgstr "می‌توان مدیران زمینه‌ی مهلت زمانی را با اطمینان تودرتو کرد." msgid "Similar to :func:`asyncio.timeout`, except *when* is the absolute time to stop waiting, or ``None``." -msgstr "مشابه :func:`asyncio.timeout`، با این تفاوت که *when* زمان مطلق برای توقف انتظار است، یا ``None``." +msgstr "مشابه :func:`asyncio.timeout`، با این تفاوت که \*when\* زمان مطلق برای توقف انتظار است، یا ``None``." msgid "" "async def main():\n" @@ -946,10 +946,10 @@ msgstr "" " print(\"This statement will run regardless.\")" msgid "Wait for the *aw* :ref:`awaitable ` to complete with a timeout." -msgstr "منتظر بمانید تا *aw* :ref:`awaitable ` با یک مهلت زمانی کامل شود." +msgstr "منتظر بمانید تا \*aw\* :ref:`awaitable ` با یک مهلت زمانی کامل شود." msgid "*timeout* can either be ``None`` or a float or int number of seconds to wait for. If *timeout* is ``None``, block until the future completes." -msgstr "*timeout* می‌تواند ``None`` یا یک عدد float یا int به‌عنوان تعداد ثانیه‌های انتظار باشد. اگر *timeout* برابر ``None`` باشد، تا زمانی که future تکمیل شود، مسدود می‌شود." +msgstr "\*timeout\* می‌تواند ``None`` یا یک عدد float یا int به‌عنوان تعداد ثانیه‌های انتظار باشد. اگر \*timeout\* برابر ``None`` باشد، تا زمانی که future تکمیل شود، مسدود می‌شود." msgid "If a timeout occurs, it cancels the task and raises :exc:`TimeoutError`." msgstr "در صورت رخ دادن مهلت زمانی، وظیفه لغو می‌شود و :exc:`TimeoutError` پرتاب می‌شود." @@ -958,10 +958,10 @@ msgid "To avoid the task :meth:`cancellation `, wrap it in :func:`s msgstr "برای جلوگیری از :meth:`لغو ` وظیفه، آن را در :func:`shield` بپیچید." msgid "The function will wait until the future is actually cancelled, so the total wait time may exceed the *timeout*. If an exception happens during cancellation, it is propagated." -msgstr "این تابع تا زمانی که فیوچر (future) به‌طور واقعی لغو شود، صبر می‌کند، بنابراین کل زمان انتظار ممکن است از *timeout* فراتر رود. اگر در حین لغو استثنایی رخ دهد، آن استثنا انتشار می‌یابد." +msgstr "این تابع تا زمانی که فیوچر (future) به‌طور واقعی لغو شود، صبر می‌کند، بنابراین کل زمان انتظار ممکن است از \*timeout\* فراتر رود. اگر در حین لغو استثنایی رخ دهد، آن استثنا انتشار می‌یابد." msgid "If the wait is cancelled, the future *aw* is also cancelled." -msgstr "اگر انتظار لغو شود، آینده *aw* نیز لغو می‌شود." +msgstr "اگر انتظار لغو شود، آینده \*aw\* نیز لغو می‌شود." msgid "" "async def eternity():\n" @@ -1001,7 +1001,7 @@ msgstr "" "# timeout!" msgid "When *aw* is cancelled due to a timeout, ``wait_for`` waits for *aw* to be cancelled. Previously, it raised :exc:`TimeoutError` immediately." -msgstr "هنگامی که *aw* به دلیل مهلت زمانی لغو می‌شود، ``wait_for`` منتظر می‌ماند تا *aw* لغو شود. پیش از این، بلافاصله :exc:`TimeoutError` را پرتاب می‌کرد." +msgstr "هنگامی که \*aw\* به دلیل مهلت زمانی لغو می‌شود، ``wait_for`` منتظر می‌ماند تا \*aw\* لغو شود. پیش از این، بلافاصله :exc:`TimeoutError` را پرتاب می‌کرد." msgid "Raises :exc:`TimeoutError` instead of :exc:`asyncio.TimeoutError`." msgstr ":exc:`TimeoutError` را به‌جای :exc:`asyncio.TimeoutError` پرتاب می‌کند." @@ -1010,10 +1010,10 @@ msgid "Waiting primitives" msgstr "اولیه‌های انتظار" msgid "Run :class:`~asyncio.Future` and :class:`~asyncio.Task` instances in the *aws* iterable concurrently and block until the condition specified by *return_when*." -msgstr "نمونه‌های :class:`~asyncio.Future` و :class:`~asyncio.Task` موجود در پیمایش‌پذیر *aws* را به‌طور همزمان اجرا می‌کند و تا برقراری شرط مشخص‌شده توسط *return_when* مسدود می‌شود." +msgstr "نمونه‌های :class:`~asyncio.Future` و :class:`~asyncio.Task` موجود در پیمایش‌پذیر \*aws\* را به‌طور همزمان اجرا می‌کند و تا برقراری شرط مشخص‌شده توسط \*return_when\* مسدود می‌شود." msgid "The *aws* iterable must not be empty." -msgstr "پیمایش‌پذیر *aws* نباید خالی باشد." +msgstr "پیمایش‌پذیر \*aws\* نباید خالی باشد." msgid "Returns two sets of Tasks/Futures: ``(done, pending)``." msgstr "دو مجموعه از Tasks/Futures را برمی‌گرداند: ``(done, pending)``." @@ -1025,13 +1025,13 @@ msgid "done, pending = await asyncio.wait(aws)" msgstr "done, pending = await asyncio.wait(aws)" msgid "*timeout* (a float or int), if specified, can be used to control the maximum number of seconds to wait before returning." -msgstr "*timeout* (یک float یا int)، در صورت مشخص بودن، می‌تواند برای کنترل حداکثر تعداد ثانیه‌های انتظار پیش از بازگشت استفاده شود." +msgstr "\*timeout\* (یک float یا int)، در صورت مشخص بودن، می‌تواند برای کنترل حداکثر تعداد ثانیه‌های انتظار پیش از بازگشت استفاده شود." msgid "Note that this function does not raise :exc:`TimeoutError`. Futures or Tasks that aren't done when the timeout occurs are simply returned in the second set." msgstr "توجه داشته باشید که این تابع :exc:`TimeoutError` را پرتاب نمی‌کند. Futureها یا Taskهایی که هنگام فرا رسیدن مهلت زمانی انجام نشده‌اند، به‌سادگی در مجموعه دوم برگردانده می‌شوند." msgid "*return_when* indicates when this function should return. It must be one of the following constants:" -msgstr "*return_when* نشان می‌دهد که این تابع چه زمانی باید بازگشت کند. این مقدار باید یکی از ثابت‌های زیر باشد:" +msgstr "\*return_when\* نشان می‌دهد که این تابع چه زمانی باید بازگشت کند. این مقدار باید یکی از ثابت‌های زیر باشد:" msgid "Constant" msgstr "ثابت" @@ -1052,7 +1052,7 @@ msgid "Unlike :func:`~asyncio.wait_for`, ``wait()`` does not cancel the futures msgstr "برخلاف :func:`~asyncio.wait_for`، ``wait()`` در صورت وقوع مهلت زمانی، آینده‌نماها (futures) را لغو نمی‌کند." msgid "If ``wait()`` is cancelled, the futures in *aws* are not cancelled and continue to run." -msgstr "اگر ``wait()`` لغو شود، آینده‌نماها (futures) موجود در *aws* لغو نمی‌شوند و به اجرای خود ادامه می‌دهند." +msgstr "اگر ``wait()`` لغو شود، آینده‌نماها (futures) موجود در \*aws\* لغو نمی‌شوند و به اجرای خود ادامه می‌دهند." msgid "Passing coroutine objects to ``wait()`` directly is forbidden." msgstr "ارسال اشیای هم‌روال به ``wait()`` به‌صورت مستقیم ممنوع است." @@ -1061,7 +1061,7 @@ msgid "Added support for generators yielding tasks." msgstr "پشتیبانی از تولیدگرهایی که وظایف را yield می‌کنند، افزوده شد." msgid "Run :ref:`awaitable objects ` in the *aws* iterable concurrently. The returned object can be iterated to obtain the results of the awaitables as they finish." -msgstr ":ref:`اشیاء awaitable ` موجود در پیمایش‌پذیر *aws* را به‌صورت همزمان اجرا کنید. می‌توانید شیء برگردانده‌شده را پیمایش کنید تا نتایج اشیاء awaitable را به‌محض اتمام هرکدام از آن‌ها به دست آورید." +msgstr ":ref:`اشیاء awaitable ` موجود در پیمایش‌پذیر \*aws\* را به‌صورت همزمان اجرا کنید. می‌توانید شیء برگردانده‌شده را پیمایش کنید تا نتایج اشیاء awaitable را به‌محض اتمام هرکدام از آن‌ها به دست آورید." msgid "The object returned by ``as_completed()`` can be iterated as an :term:`asynchronous iterator` or a plain :term:`iterator`. When asynchronous iteration is used, the originally-supplied awaitables are yielded if they are tasks or futures. This makes it easy to correlate previously-scheduled tasks with their results. Example::" msgstr "می‌توان شیء برگردانده‌شده از ``as_completed()`` را به‌عنوان یک :term:`پیمایش‌گر ناهمگام ` یا یک :term:`پیمایش‌گر ` ساده پیمایش کرد. هنگامی که از پیمایش ناهمگام استفاده می‌شود، awaitableهایی که در ابتدا ارائه شده‌اند، در صورتی که task یا future باشند، بازگشت داده می‌شوند. این کار مرتبط کردن taskهای از پیش زمان‌بندی‌شده با نتایج آن‌ها را آسان می‌کند. مثال::" @@ -1129,7 +1129,7 @@ msgid "``as_completed()`` does not cancel the tasks running the supplied awaitab msgstr "``as_completed()`` وظایف در حال اجرای awaitableهای ارائه‌شده را لغو نمی‌کند: اگر مهلت به پایان برسد یا پیمایش لغو شود، وظایف باقی‌مانده به اجرا ادامه می‌دهند." msgid "Deprecation warning is emitted if not all awaitable objects in the *aws* iterable are Future-like objects and there is no running event loop." -msgstr "اگر تمام اشیای awaitable در پیمایش‌پذیر *aws* اشیای شبه-Future نباشند و حلقه رویدادی در حال اجرا وجود نداشته باشد، هشدار از رده خارج شدن نشان داده می‌شود." +msgstr "اگر تمام اشیای awaitable در پیمایش‌پذیر \*aws\* اشیای شبه-Future نباشند و حلقه رویدادی در حال اجرا وجود نداشته باشد، هشدار از رده خارج شدن نشان داده می‌شود." msgid "The result can now be used as either an :term:`asynchronous iterator` or as a plain :term:`iterator` (previously it was only a plain iterator)." msgstr "نتیجه اکنون می‌تواند هم به‌عنوان یک :term:`پیمایش‌گر ناهمگام ` و هم به‌عنوان یک :term:`پیمایش‌گر ` ساده استفاده شود (پیش‌تر فقط یک پیمایش‌گر ساده بود)." @@ -1138,13 +1138,13 @@ msgid "Running in threads" msgstr "اجرا در نخ‌ها" msgid "Asynchronously run function *func* in a separate thread." -msgstr "تابع *func* را به‌صورت ناهمگام در یک نخ جداگانه اجرا می‌کند." +msgstr "تابع \*func\* را به‌صورت ناهمگام در یک نخ جداگانه اجرا می‌کند." msgid "Any \\*args and \\*\\*kwargs supplied for this function are directly passed to *func*. Also, the current :class:`contextvars.Context` is propagated, allowing context variables from the event loop thread to be accessed in the separate thread." -msgstr "هرگونه \\*args و \\*\\*kwargs که برای این تابع ارائه شود، مستقیماً به *func* ارسال می‌شود. همچنین :class:`contextvars.Context` جاری منتشر می‌شود تا متغیرهای زمینه از نخ حلقه رویداد در نخ جداگانه قابل دسترسی باشند." +msgstr "هرگونه \\*args و \\*\\*kwargs که برای این تابع ارائه شود، مستقیماً به \*func\* ارسال می‌شود. همچنین :class:`contextvars.Context` جاری منتشر می‌شود تا متغیرهای زمینه از نخ حلقه رویداد در نخ جداگانه قابل دسترسی باشند." msgid "Return a coroutine that can be awaited to get the eventual result of *func*." -msgstr "یک هم‌روال برمی‌گرداند که می‌توان آن را await کرد تا نتیجه نهایی *func* به دست آید." +msgstr "یک هم‌روال برمی‌گرداند که می‌توان آن را await کرد تا نتیجه نهایی \*func\* به دست آید." msgid "This coroutine function is primarily intended to be used for executing IO-bound functions/methods that would otherwise block the event loop if they were run in the main thread. For example::" msgstr "این تابع هم‌روال عمدتاً برای اجرای توابع/متدهای وابسته به ورودی/خروجی (IO-bound) در نظر گرفته شده است، توابعی که در غیر این صورت، اگر در نخ اصلی اجرا شوند، حلقه رویداد را مسدود می‌کنند. برای مثال::" @@ -1357,7 +1357,7 @@ msgid "See the :ref:`concurrency and multithreading ` se msgstr "بخش :ref:`همروندی و چندریسمانی ` مستندات را ببینید." msgid "Unlike other asyncio functions this function requires the *loop* argument to be passed explicitly." -msgstr "برخلاف سایر توابع asyncio، این تابع نیاز دارد که آرگومان *loop* به‌صورت صریح ارسال شود." +msgstr "برخلاف سایر توابع asyncio، این تابع نیاز دارد که آرگومان \*loop\* به‌صورت صریح ارسال شود." msgid "Introspection" msgstr "درون‌نگری" @@ -1366,16 +1366,16 @@ msgid "Return the currently running :class:`Task` instance, or ``None`` if no ta msgstr "نمونه‌ی در حال اجرای :class:`Task` را برمی‌گرداند، یا اگر هیچ وظیفه‌ای در حال اجرا نباشد، ``None`` را برمی‌گرداند." msgid "If *loop* is ``None`` :func:`get_running_loop` is used to get the current loop." -msgstr "اگر *loop* برابر ``None`` باشد، از :func:`get_running_loop` برای گرفتن حلقه جاری استفاده می‌شود." +msgstr "اگر \*loop\* برابر ``None`` باشد، از :func:`get_running_loop` برای گرفتن حلقه جاری استفاده می‌شود." msgid "Return a set of not yet finished :class:`Task` objects run by the loop." msgstr "مجموعه‌ای از اشیاء :class:`Task` که هنوز تمام‌نشده‌اند و توسط حلقه اجرا می‌شوند را برمی‌گرداند." msgid "If *loop* is ``None``, :func:`get_running_loop` is used for getting current loop." -msgstr "اگر *loop* برابر ``None`` باشد، برای گرفتن حلقه‌ی جاری از :func:`get_running_loop` استفاده می‌شود." +msgstr "اگر \*loop\* برابر ``None`` باشد، برای گرفتن حلقه‌ی جاری از :func:`get_running_loop` استفاده می‌شود." msgid "Return ``True`` if *obj* is a coroutine object." -msgstr "اگر *obj* یک شیء هم‌روال باشد، ``True`` برمی‌گرداند." +msgstr "اگر \*obj\* یک شیء هم‌روال باشد، ``True`` برمی‌گرداند." msgid "Task object" msgstr "شیء Task" @@ -1384,7 +1384,7 @@ msgid "A :class:`Future-like ` object that runs a Python :ref:`coroutine msgstr "یک شیء :class:`Future-مانند ` که یک :ref:`هم‌روال ` پایتون را اجرا می‌کند. نخ‌ایمن نیست." msgid "Tasks are used to run coroutines in event loops. If a coroutine awaits on a Future, the Task suspends the execution of the coroutine and waits for the completion of the Future. When the Future is *done*, the execution of the wrapped coroutine resumes." -msgstr "از Taskها برای اجرای هم‌روال‌ها در حلقه‌های رویداد استفاده می‌شود. اگر یک هم‌روال روی یک Future await کند، Task اجرای هم‌روال را معلق می‌کند و منتظر کامل شدن Future می‌ماند. هنگامی که Future *انجام‌شده* باشد، اجرای هم‌روال دربرگرفته‌شده از سر گرفته می‌شود." +msgstr "از Taskها برای اجرای هم‌روال‌ها در حلقه‌های رویداد استفاده می‌شود. اگر یک هم‌روال روی یک Future await کند، Task اجرای هم‌روال را معلق می‌کند و منتظر کامل شدن Future می‌ماند. هنگامی که Future \*انجام‌شده\* باشد، اجرای هم‌روال دربرگرفته‌شده از سر گرفته می‌شود." msgid "Event loops use cooperative scheduling: an event loop runs one Task at a time. While a Task awaits for the completion of a Future, the event loop runs other Tasks, callbacks, or performs IO operations." msgstr "حلقه‌های رویداد از زمان‌بندی مشارکتی استفاده می‌کنند: یک حلقه رویداد در هر زمان یک Task را اجرا می‌کند. هنگامی که یک Task برای تکمیل شدن یک Future await می‌کند، حلقه رویداد Taskهای دیگر و کال‌بک‌ها را اجرا می‌کند یا عملیات ورودی/خروجی انجام می‌دهد." @@ -1402,10 +1402,10 @@ msgid ":class:`asyncio.Task` inherits from :class:`Future` all of its APIs excep msgstr ":class:`asyncio.Task` از :class:`Future` همه‌ی APIهای آن را به ارث می‌برد، به‌جز :meth:`Future.set_result` و :meth:`Future.set_exception`." msgid "An optional keyword-only *context* argument allows specifying a custom :class:`contextvars.Context` for the *coro* to run in. If no *context* is provided, the Task copies the current context and later runs its coroutine in the copied context." -msgstr "یک آرگومان *context* اختیاری فقط کلیدواژه‌ای به شما امکان می‌دهد یک :class:`contextvars.Context` سفارشی را برای اجرای *coro* در آن تعیین کنید. اگر *context* ارائه نشود، Task زمینه جاری را کپی می‌کند و بعداً هم‌روال خود را در زمینه کپی‌شده اجرا می‌کند." +msgstr "یک آرگومان \*context\* اختیاری فقط کلیدواژه‌ای به شما امکان می‌دهد یک :class:`contextvars.Context` سفارشی را برای اجرای \*coro\* در آن تعیین کنید. اگر \*context\* ارائه نشود، Task زمینه جاری را کپی می‌کند و بعداً هم‌روال خود را در زمینه کپی‌شده اجرا می‌کند." msgid "An optional keyword-only *eager_start* argument allows eagerly starting the execution of the :class:`asyncio.Task` at task creation time. If set to ``True`` and the event loop is running, the task will start executing the coroutine immediately, until the first time the coroutine blocks. If the coroutine returns or raises without blocking, the task will be finished eagerly and will skip scheduling to the event loop." -msgstr "یک آرگومان اختیاری و فقط کلیدواژه‌ای به نام *eager_start* امکان شروع فوری اجرای :class:`asyncio.Task` را در زمان ایجاد وظیفه فراهم می‌کند. اگر روی ``True`` تنظیم شده باشد و حلقه رویداد در حال اجرا باشد، وظیفه اجرای هم‌روال را بلافاصله آغاز می‌کند، تا نخستین باری که هم‌روال مسدود شود. اگر هم‌روال بدون مسدود شدن بازگشت کند یا استثنایی پرتاب کند، وظیفه به‌صورت فوری به پایان می‌رسد و در حلقه رویداد زمان‌بندی نمی‌شود." +msgstr "یک آرگومان اختیاری و فقط کلیدواژه‌ای به نام \*eager_start\* امکان شروع فوری اجرای :class:`asyncio.Task` را در زمان ایجاد وظیفه فراهم می‌کند. اگر روی ``True`` تنظیم شده باشد و حلقه رویداد در حال اجرا باشد، وظیفه اجرای هم‌روال را بلافاصله آغاز می‌کند، تا نخستین باری که هم‌روال مسدود شود. اگر هم‌روال بدون مسدود شدن بازگشت کند یا استثنایی پرتاب کند، وظیفه به‌صورت فوری به پایان می‌رسد و در حلقه رویداد زمان‌بندی نمی‌شود." msgid "Tasks are :ref:`generic ` over the return type of their wrapped coroutines." msgstr "وظایف نسبت به نوع برگشتی هم‌روال‌های دربرگرفته‌شده‌ی خود :ref:`عام ` هستند." @@ -1414,25 +1414,25 @@ msgid "Added support for the :mod:`contextvars` module." msgstr "پشتیبانی از ماژول :mod:`contextvars` افزوده شد." msgid "Deprecation warning is emitted if *loop* is not specified and there is no running event loop." -msgstr "اگر *loop* مشخص نشده باشد و هیچ حلقه رویدادی در حال اجرا وجود نداشته باشد، هشدار منسوخ‌شدن نشان داده می‌شود." +msgstr "اگر \*loop\* مشخص نشده باشد و هیچ حلقه رویدادی در حال اجرا وجود نداشته باشد، هشدار منسوخ‌شدن نشان داده می‌شود." msgid "Added the *eager_start* parameter." -msgstr "پارامتر *eager_start* اضافه شد." +msgstr "پارامتر \*eager_start\* اضافه شد." msgid "Return ``True`` if the Task is *done*." -msgstr "اگر Task *انجام‌شده* باشد، ``True`` را برمی‌گرداند." +msgstr "اگر Task \*انجام‌شده\* باشد، ``True`` را برمی‌گرداند." msgid "A Task is *done* when the wrapped coroutine either returned a value, raised an exception, or the Task was cancelled." -msgstr "یک وظیفه زمانی *انجام‌شده* است که هم‌روال دربرگرفته‌شده‌ی آن، یا مقداری را برگردانده باشد، یا استثنایی را پرتاب کرده باشد، یا آن وظیفه لغو شده باشد." +msgstr "یک وظیفه زمانی \*انجام‌شده\* است که هم‌روال دربرگرفته‌شده‌ی آن، یا مقداری را برگردانده باشد، یا استثنایی را پرتاب کرده باشد، یا آن وظیفه لغو شده باشد." msgid "Return the result of the Task." msgstr "نتیجه‌ی Task را برمی‌گرداند." msgid "If the Task is *done*, the result of the wrapped coroutine is returned (or if the coroutine raised an exception, that exception is re-raised.)" -msgstr "اگر Task *انجام‌شده* باشد، نتیجه هم‌روال پوشیده‌شده برگردانده می‌شود (یا اگر هم‌روال استثنایی را پرتاب کرده باشد، آن استثنا دوباره پرتاب می‌شود.)" +msgstr "اگر Task \*انجام‌شده\* باشد، نتیجه هم‌روال پوشیده‌شده برگردانده می‌شود (یا اگر هم‌روال استثنایی را پرتاب کرده باشد، آن استثنا دوباره پرتاب می‌شود.)" msgid "If the Task has been *cancelled*, this method raises a :exc:`CancelledError` exception." -msgstr "اگر Task *لغوشده* باشد، این متد استثنای :exc:`CancelledError` را پرتاب می‌کند." +msgstr "اگر Task \*لغوشده\* باشد، این متد استثنای :exc:`CancelledError` را پرتاب می‌کند." msgid "If the Task's result isn't yet available, this method raises an :exc:`InvalidStateError` exception." msgstr "اگر نتیجه‌ی Task هنوز در دسترس نباشد، این متد یک استثنای :exc:`InvalidStateError` پرتاب می‌کند." @@ -1444,10 +1444,10 @@ msgid "If the wrapped coroutine raised an exception that exception is returned. msgstr "اگر هم‌روال پوشیده‌شده استثنایی پرتاب کرد، آن استثنا برگردانده می‌شود. اگر هم‌روال پوشیده‌شده به‌طور عادی بازگشت کرد، این متد ``None`` را برمی‌گرداند." msgid "If the Task isn't *done* yet, this method raises an :exc:`InvalidStateError` exception." -msgstr "اگر Task هنوز *انجام‌شده* نباشد، این متد استثنای :exc:`InvalidStateError` را پرتاب می‌کند." +msgstr "اگر Task هنوز \*انجام‌شده\* نباشد، این متد استثنای :exc:`InvalidStateError` را پرتاب می‌کند." msgid "Add a callback to be run when the Task is *done*." -msgstr "یک کال‌بک اضافه کنید تا هنگامی که Task *انجام‌شده* باشد اجرا شود." +msgstr "یک کال‌بک اضافه کنید تا هنگامی که Task \*انجام‌شده\* باشد اجرا شود." msgid "This method should only be used in low-level callback-based code." msgstr "این متد تنها باید در کد سطح پایین مبتنی بر کال‌بک استفاده شود." @@ -1456,7 +1456,7 @@ msgid "See the documentation of :meth:`Future.add_done_callback` for more detail msgstr "برای جزئیات بیشتر، مستندات :meth:`Future.add_done_callback` را ببینید." msgid "Remove *callback* from the callbacks list." -msgstr "*callback* را از فهرست کال‌بک‌ها حذف کنید." +msgstr "\*callback\* را از فهرست کال‌بک‌ها حذف کنید." msgid "See the documentation of :meth:`Future.remove_done_callback` for more details." msgstr "برای جزئیات بیشتر، به مستندات :meth:`Future.remove_done_callback` مراجعه کنید." @@ -1474,7 +1474,7 @@ msgid "Only one stack frame is returned for a suspended coroutine." msgstr "تنها یک فریم پشته برای یک هم‌روال تعلیق‌شده برگردانده می‌شود." msgid "The optional *limit* argument sets the maximum number of frames to return; by default all available frames are returned. The ordering of the returned list differs depending on whether a stack or a traceback is returned: the newest frames of a stack are returned, but the oldest frames of a traceback are returned. (This matches the behavior of the traceback module.)" -msgstr "آرگومان اختیاری *limit* حداکثر تعداد فریم‌های بازگشتی را تنظیم می‌کند؛ به‌طور پیش‌فرض همه‌ی فریم‌های موجود بازگردانده می‌شوند. ترتیب فهرست بازگشتی بسته به این‌که یک پشته یا یک ردگیری بازگردانده شود، متفاوت است: جدیدترین فریم‌های یک پشته بازگردانده می‌شوند، اما قدیمی‌ترین فریم‌های یک ردگیری بازگردانده می‌شوند. (این با رفتار ماژول traceback مطابقت دارد.)" +msgstr "آرگومان اختیاری \*limit\* حداکثر تعداد فریم‌های بازگشتی را تنظیم می‌کند؛ به‌طور پیش‌فرض همه‌ی فریم‌های موجود بازگردانده می‌شوند. ترتیب فهرست بازگشتی بسته به این‌که یک پشته یا یک ردگیری بازگردانده شود، متفاوت است: جدیدترین فریم‌های یک پشته بازگردانده می‌شوند، اما قدیمی‌ترین فریم‌های یک ردگیری بازگردانده می‌شوند. (این با رفتار ماژول traceback مطابقت دارد.)" msgid "Print the stack or traceback for this Task." msgstr "پشته یا ردگیری پشته‌ی این Task را چاپ می‌کند." @@ -1483,10 +1483,10 @@ msgid "This produces output similar to that of the traceback module for the fram msgstr "این، خروجی مشابهی با خروجی ماژول traceback برای فریم‌های بازیابی‌شده توسط :meth:`get_stack` تولید می‌کند." msgid "The *limit* argument is passed to :meth:`get_stack` directly." -msgstr "آرگومان *limit* مستقیماً به :meth:`get_stack` ارسال می‌شود." +msgstr "آرگومان \*limit\* مستقیماً به :meth:`get_stack` ارسال می‌شود." msgid "The *file* argument is an I/O stream to which the output is written; by default output is written to :data:`sys.stdout`." -msgstr "آرگومان *file* یک جریان ورودی/خروجی است که خروجی به آن نوشته می‌شود؛ به‌طور پیش‌فرض خروجی به :data:`sys.stdout` نوشته می‌شود." +msgstr "آرگومان \*file\* یک جریان ورودی/خروجی است که خروجی به آن نوشته می‌شود؛ به‌طور پیش‌فرض خروجی به :data:`sys.stdout` نوشته می‌شود." msgid "Return the coroutine object wrapped by the :class:`Task`." msgstr "شیء هم‌روالِ دربرگرفته‌شده توسط :class:`Task` را برمی‌گرداند." @@ -1510,7 +1510,7 @@ msgid "Set the name of the Task." msgstr "نام Task را تنظیم کنید." msgid "The *value* argument can be any object, which is then converted to a string." -msgstr "آرگومان *value* می‌تواند هر شیء‌ای باشد که سپس به رشته تبدیل می‌شود." +msgstr "آرگومان \*value\* می‌تواند هر شیء‌ای باشد که سپس به رشته تبدیل می‌شود." msgid "In the default Task implementation, the name will be visible in the :func:`repr` output of a task object." msgstr "در پیاده‌سازی پیش‌فرض Task، نام در خروجی :func:`repr` یک شیء task قابل مشاهده خواهد بود." @@ -1519,7 +1519,7 @@ msgid "Request the Task to be cancelled." msgstr "درخواست لغو Task را بدهید." msgid "If the Task is already *done* or *cancelled*, return ``False``, otherwise, return ``True``." -msgstr "اگر Task از پیش *انجام‌شده* یا *لغوشده* باشد، ``False`` را برمی‌گرداند، در غیر این صورت ``True`` را برمی‌گرداند." +msgstr "اگر Task از پیش \*انجام‌شده\* یا \*لغوشده\* باشد، ``False`` را برمی‌گرداند، در غیر این صورت ``True`` را برمی‌گرداند." msgid "The method arranges for a :exc:`CancelledError` exception to be thrown into the wrapped coroutine on the next cycle of the event loop." msgstr "این متد ترتیبی می‌دهد که استثنای :exc:`CancelledError` در چرخه‌ی بعدی حلقه‌ی رویداد به هم‌روال پوشیده‌شده پرتاب شود." @@ -1528,7 +1528,7 @@ msgid "The coroutine then has a chance to clean up or even deny the request by s msgstr "سپس هم‌روال این فرصت را دارد که پاک‌سازی کند یا حتی با مهار استثنا از طریق یک بلوک :keyword:`try` ... ... ``except CancelledError`` ... :keyword:`finally`، درخواست را رد کند. بنابراین، برخلاف :meth:`Future.cancel`، :meth:`Task.cancel` تضمین نمی‌کند که Task لغو شود، اگرچه مهار کامل لغو رایج نیست و به‌طور فعال نهی شده است. اگر هم‌روال با این حال تصمیم بگیرد لغو را مهار کند، باید علاوه بر گرفتن استثنا، :meth:`Task.uncancel` را نیز فراخوانی کند." msgid "Added the *msg* parameter." -msgstr "پارامتر *msg* اضافه شد." +msgstr "پارامتر \*msg\* اضافه شد." msgid "The ``msg`` parameter is propagated from cancelled task to its awaiter." msgstr "پارامتر ``msg`` از وظیفه لغوشده به awaitکننده‌ی آن منتقل می‌شود." @@ -1606,10 +1606,10 @@ msgstr "" "# main(): cancel_me is cancelled now" msgid "Return ``True`` if the Task is *cancelled*." -msgstr "اگر Task *لغوشده* باشد، ``True`` را برمی‌گرداند." +msgstr "اگر Task \*لغوشده\* باشد، ``True`` را برمی‌گرداند." msgid "The Task is *cancelled* when the cancellation was requested with :meth:`cancel` and the wrapped coroutine propagated the :exc:`CancelledError` exception thrown into it." -msgstr "Task زمانی *لغو می‌شود* که لغو با :meth:`cancel` درخواست شده باشد و هم‌روال دربرگرفته‌شده، استثنای :exc:`CancelledError` پرتاب‌شده به درون آن را منتشر کرده باشد." +msgstr "Task زمانی \*لغو می‌شود\* که لغو با :meth:`cancel` درخواست شده باشد و هم‌روال دربرگرفته‌شده، استثنای :exc:`CancelledError` پرتاب‌شده به درون آن را منتشر کرده باشد." msgid "Decrement the count of cancellation requests to this Task." msgstr "شمار درخواست‌های لغو برای این Task را کاهش می‌دهد." diff --git a/library/doctest.po b/library/doctest.po index 0f7f6b17..cde0090e 100644 --- a/library/doctest.po +++ b/library/doctest.po @@ -340,12 +340,12 @@ msgid "" "Got:\n" " 720" msgstr "" -"پرونده \"./example.txt\"، خط 14، در example.txt\n" -"مثال شکست خورده:\n" +"File \"./example.txt\", line 14, in example.txt\n" +"Failed example:\n" " factorial(6)\n" -"انتظار می‌رفت:\n" +"Expected:\n" " 120\n" -"دریافت شد:\n" +"Got:\n" " 720" msgid "As with :func:`testmod`, :func:`testfile` won't display anything unless an example fails. If an example does fail, then the failing example(s) and the cause(s) of the failure(s) are printed to stdout, using the same format as :func:`!testmod`." diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index b1dd23a7..a5e23662 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -36,25 +36,25 @@ msgid "This document describes the behavior under the default (for :class:`Messa msgstr "این سند رفتار تحت سیاست پیش‌فرض (برای :class:`Message`) یعنی :attr:`~email.policy.Compat32` را توصیف می‌کند. اگر قصد استفاده از سیاست دیگری را دارید، باید به‌جای آن از کلاس :class:`~email.message.EmailMessage` استفاده کنید." msgid "An email message consists of *headers* and a *payload*. Headers must be :rfc:`5322` style names and values, where the field name and value are separated by a colon. The colon is not part of either the field name or the field value. The payload may be a simple text message, or a binary object, or a structured sequence of sub-messages each with their own set of headers and their own payload. The latter type of payload is indicated by the message having a MIME type such as :mimetype:`multipart/\\*` or :mimetype:`message/rfc822`." -msgstr "یک پیام ایمیل از *سرآیندها* و یک *بار * تشکیل می‌شود. سرآیندها باید نام‌ها و مقدارهایی به سبک :rfc:`5322` باشند، که در آن نام فیلد و مقدار آن با یک دونقطه از هم جدا می‌شوند. دونقطه بخشی از نام فیلد یا مقدار فیلد نیست. بار ممکن است یک پیام متنی ساده، یا یک شیء دودویی، یا دنباله‌ای ساختاریافته از پیام‌های فرعی باشد که هرکدام مجموعه‌ای از سرآیندها و بار خود را دارند. نوع اخیر بار با این مشخص می‌شود که پیام دارای یک نوع MIME مانند :mimetype:`multipart/\\*` یا :mimetype:`message/rfc822` باشد." +msgstr "یک پیام ایمیل از \*سرآیندها\* و یک \*بار \* تشکیل می‌شود. سرآیندها باید نام‌ها و مقدارهایی به سبک :rfc:`5322` باشند، که در آن نام فیلد و مقدار آن با یک دونقطه از هم جدا می‌شوند. دونقطه بخشی از نام فیلد یا مقدار فیلد نیست. بار ممکن است یک پیام متنی ساده، یا یک شیء دودویی، یا دنباله‌ای ساختاریافته از پیام‌های فرعی باشد که هرکدام مجموعه‌ای از سرآیندها و بار خود را دارند. نوع اخیر بار با این مشخص می‌شود که پیام دارای یک نوع MIME مانند :mimetype:`multipart/\\*` یا :mimetype:`message/rfc822` باشد." msgid "The conceptual model provided by a :class:`Message` object is that of an ordered dictionary of headers with additional methods for accessing both specialized information from the headers, for accessing the payload, for generating a serialized version of the message, and for recursively walking over the object tree. Note that duplicate headers are supported but special methods must be used to access them." msgstr "مدل مفهومی ارائه‌شده توسط یک شیء :class:`Message`، یک دیکشنری مرتب از سرآیندها به همراه متدهای اضافی برای دسترسی به اطلاعات تخصصی از سرآیندها، دسترسی به بار، تولید یک نسخه سریال‌شده از پیام و پیمایش بازگشتی روی درخت شیء است. توجه داشته باشید که سرآیندهای تکراری پشتیبانی می‌شوند، اما برای دسترسی به آن‌ها باید از متدهای ویژهی استفاده شود." msgid "The :class:`Message` pseudo-dictionary is indexed by the header names, which must be ASCII values. The values of the dictionary are strings that are supposed to contain only ASCII characters; there is some special handling for non-ASCII input, but it doesn't always produce the correct results. Headers are stored and returned in case-preserving form, but field names are matched case-insensitively. There may also be a single envelope header, also known as the *Unix-From* header or the ``From_`` header. The *payload* is either a string or bytes, in the case of simple message objects, or a list of :class:`Message` objects, for MIME container documents (e.g. :mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." -msgstr "شبه‌دیکشنری :class:`Message` با نام سرآیندها اندیس‌دهی می‌شود، که باید مقادیر ASCII باشند. مقادیر این دیکشنری رشته‌هایی هستند که انتظار می‌رود فقط شامل نویسه‌های ASCII باشند؛ برای ورودی غیر ASCII مدیریت ویژه‌ای وجود دارد، اما این مدیریت همیشه نتایج صحیح را تولید نمی‌کند. سرآیندها با حفظ بزرگی و کوچکی حروف ذخیره و برگردانده می‌شوند، اما نام فیلدها بدون حساسیت به بزرگی و کوچکی حروف تطبیق داده می‌شوند. همچنین ممکن است یک سرآیند پاکت (envelope header) واحد وجود داشته باشد، که به آن سرآیند *Unix-From* یا سرآیند ``From_`` نیز گفته می‌شود. *بار* در اشیای پیام ساده، یا یک رشته است یا بایت‌ها، و در اسناد ظرف MIME (مانند :mimetype:`multipart/\\*` و :mimetype:`message/rfc822`) فهرستی از اشیای :class:`Message` است." +msgstr "شبه‌دیکشنری :class:`Message` با نام سرآیندها اندیس‌دهی می‌شود، که باید مقادیر ASCII باشند. مقادیر این دیکشنری رشته‌هایی هستند که انتظار می‌رود فقط شامل نویسه‌های ASCII باشند؛ برای ورودی غیر ASCII مدیریت ویژه‌ای وجود دارد، اما این مدیریت همیشه نتایج صحیح را تولید نمی‌کند. سرآیندها با حفظ بزرگی و کوچکی حروف ذخیره و برگردانده می‌شوند، اما نام فیلدها بدون حساسیت به بزرگی و کوچکی حروف تطبیق داده می‌شوند. همچنین ممکن است یک سرآیند پاکت (envelope header) واحد وجود داشته باشد، که به آن سرآیند \*Unix-From\* یا سرآیند ``From_`` نیز گفته می‌شود. \*بار\* در اشیای پیام ساده، یا یک رشته است یا بایت‌ها، و در اسناد ظرف MIME (مانند :mimetype:`multipart/\\*` و :mimetype:`message/rfc822`) فهرستی از اشیای :class:`Message` است." msgid "Here are the methods of the :class:`Message` class:" msgstr "در اینجا متدهای کلاس :class:`Message` آمده است:" msgid "If *policy* is specified (it must be an instance of a :mod:`~email.policy` class) use the rules it specifies to update and serialize the representation of the message. If *policy* is not set, use the :class:`compat32 ` policy, which maintains backward compatibility with the Python 3.2 version of the email package. For more information see the :mod:`~email.policy` documentation." -msgstr "اگر *policy* مشخص‌شده باشد (باید نمونه‌ای از یک کلاس :mod:`~email.policy` باشد)، از قواعد مشخص‌شده توسط آن برای به‌روزرسانی و سریال‌سازی بازنمایی پیام استفاده می‌شود. اگر *policy* تنظیم‌نشده باشد، از سیاست :class:`compat32 ` استفاده می‌شود که سازگاری با نسخه‌ی بسته‌ی email در پایتون 3.2 را حفظ می‌کند. برای اطلاعات بیشتر، مستندات :mod:`~email.policy` را ببینید." +msgstr "اگر \*policy\* مشخص‌شده باشد (باید نمونه‌ای از یک کلاس :mod:`~email.policy` باشد)، از قواعد مشخص‌شده توسط آن برای به‌روزرسانی و سریال‌سازی بازنمایی پیام استفاده می‌شود. اگر \*policy\* تنظیم‌نشده باشد، از سیاست :class:`compat32 ` استفاده می‌شود که سازگاری با نسخه‌ی بسته‌ی email در پایتون 3.2 را حفظ می‌کند. برای اطلاعات بیشتر، مستندات :mod:`~email.policy` را ببینید." msgid "The *policy* keyword argument was added." -msgstr "آرگومان کلیدواژه‌ای *policy* افزوده شد." +msgstr "آرگومان کلیدواژه‌ای \*policy\* افزوده شد." msgid "Return the entire message flattened as a string. When optional *unixfrom* is true, the envelope header is included in the returned string. *unixfrom* defaults to ``False``. For backward compatibility reasons, *maxheaderlen* defaults to ``0``, so if you want a different value you must override it explicitly (the value specified for *max_line_length* in the policy will be ignored by this method). The *policy* argument may be used to override the default policy obtained from the message instance. This can be used to control some of the formatting produced by the method, since the specified *policy* will be passed to the ``Generator``." -msgstr "کل پیام را به‌صورت یک رشته‌ی تخت‌شده برمی‌گرداند. هرگاه آرگومان اختیاری *unixfrom* درست باشد، سرآیند پاکت در رشته‌ی برگردانده‌شده گنجانده می‌شود. مقدار پیش‌فرض *unixfrom* برابر ``False`` است. به دلایل سازگاری با نسخه‌های پیشین، مقدار پیش‌فرض *maxheaderlen* برابر ``0`` است، بنابراین اگر مقدار دیگری می‌خواهید، باید آن را به‌صراحت بازنویسی کنید (مقدار مشخص‌شده برای *max_line_length* در سیاست توسط این متد نادیده گرفته می‌شود). می‌توان از آرگومان *policy* برای بازنویسی سیاست پیش‌فرض گرفته‌شده از نمونه‌ی پیام استفاده کرد. از آن‌جا که *policy* مشخص‌شده به ``Generator`` ارسال می‌شود، می‌توان از آن برای کنترل برخی از قالب‌بندی‌های تولیدشده توسط این متد استفاده کرد." +msgstr "کل پیام را به‌صورت یک رشته‌ی تخت‌شده برمی‌گرداند. هرگاه آرگومان اختیاری \*unixfrom\* درست باشد، سرآیند پاکت در رشته‌ی برگردانده‌شده گنجانده می‌شود. مقدار پیش‌فرض \*unixfrom\* برابر ``False`` است. به دلایل سازگاری با نسخه‌های پیشین، مقدار پیش‌فرض \*maxheaderlen\* برابر ``0`` است، بنابراین اگر مقدار دیگری می‌خواهید، باید آن را به‌صراحت بازنویسی کنید (مقدار مشخص‌شده برای \*max_line_length\* در سیاست توسط این متد نادیده گرفته می‌شود). می‌توان از آرگومان \*policy\* برای بازنویسی سیاست پیش‌فرض گرفته‌شده از نمونه‌ی پیام استفاده کرد. از آن‌جا که \*policy\* مشخص‌شده به ``Generator`` ارسال می‌شود، می‌توان از آن برای کنترل برخی از قالب‌بندی‌های تولیدشده توسط این متد استفاده کرد." msgid "Flattening the message may trigger changes to the :class:`Message` if defaults need to be filled in to complete the transformation to a string (for example, MIME boundaries may be generated or modified)." msgstr "تخت‌سازی پیام (flattening) ممکن است باعث ایجاد تغییراتی در :class:`Message` شود، اگر برای تکمیل تبدیل به رشته نیاز باشد مقادیر پیش‌فرض پر شوند (برای مثال، ممکن است مرزهای MIME تولید یا اصلاح شوند)." @@ -81,13 +81,13 @@ msgid "If the message object contains binary data that is not encoded according msgstr "اگر شیء پیام حاوی داده‌های دودویی باشد که مطابق استانداردهای RFC کدگذاری‌نشده باشند، داده‌های نامنطبق با نقاط کد یونیکد «نویسه ناشناخته» جایگزین خواهند شد. (همچنین :meth:`.as_bytes` و :class:`~email.generator.BytesGenerator` را ببینید.)" msgid "the *policy* keyword argument was added." -msgstr "آرگومان کلیدواژه‌ای *policy* افزوده شد." +msgstr "آرگومان کلیدواژه‌ای \*policy\* افزوده شد." msgid "Equivalent to :meth:`.as_string`. Allows ``str(msg)`` to produce a string containing the formatted message." msgstr "معادل :meth:`.as_string`. به ``str(msg)`` اجازه می‌دهد رشته‌ای حاوی پیام قالب‌بندی‌شده تولید کند." msgid "Return the entire message flattened as a bytes object. When optional *unixfrom* is true, the envelope header is included in the returned string. *unixfrom* defaults to ``False``. The *policy* argument may be used to override the default policy obtained from the message instance. This can be used to control some of the formatting produced by the method, since the specified *policy* will be passed to the ``BytesGenerator``." -msgstr "کل پیام را به‌صورت یک شیء bytes مسطح‌شده برمی‌گرداند. هنگامی که آرگومان اختیاری *unixfrom* true باشد، سرآیند پاکت (envelope header) در رشته برگردانده‌شده گنجانده می‌شود. *unixfrom* به‌طور پیش‌فرض ``False`` است. می‌توان از آرگومان *policy* برای نادیده گرفتن سیاست پیش‌فرض گرفته‌شده از نمونه پیام استفاده کرد. می‌توان از این کار برای کنترل برخی از قالب‌بندی‌های تولیدشده توسط متد استفاده کرد، زیرا *policy* مشخص‌شده به ``BytesGenerator`` ارسال می‌شود." +msgstr "کل پیام را به‌صورت یک شیء bytes مسطح‌شده برمی‌گرداند. هنگامی که آرگومان اختیاری \*unixfrom\* true باشد، سرآیند پاکت (envelope header) در رشته برگردانده‌شده گنجانده می‌شود. \*unixfrom\* به‌طور پیش‌فرض ``False`` است. می‌توان از آرگومان \*policy\* برای نادیده گرفتن سیاست پیش‌فرض گرفته‌شده از نمونه پیام استفاده کرد. می‌توان از این کار برای کنترل برخی از قالب‌بندی‌های تولیدشده توسط متد استفاده کرد، زیرا \*policy\* مشخص‌شده به ``BytesGenerator`` ارسال می‌شود." msgid "Note that this method is provided as a convenience and may not always format the message the way you want. For example, by default it does not do the mangling of lines that begin with ``From`` that is required by the Unix mbox format. For more flexibility, instantiate a :class:`~email.generator.BytesGenerator` instance and use its :meth:`~email.generator.BytesGenerator.flatten` method directly. For example::" msgstr "توجه داشته باشید که این متد برای سهولت ارائه شده است و ممکن است همیشه پیام را به شکلی که می‌خواهید قالب‌بندی نکند. برای مثال، به‌طور پیش‌فرض، دستکاری سطرهایی که با ``From`` آغاز می‌شوند و قالب mbox یونیکس به آن نیاز دارد را انجام نمی‌دهد. برای انعطاف‌پذیری بیشتر، یک نمونه از :class:`~email.generator.BytesGenerator` ایجاد کنید و مستقیماً از متد :meth:`~email.generator.BytesGenerator.flatten` آن استفاده کنید. برای مثال::" @@ -114,13 +114,13 @@ msgid "Return ``True`` if the message's payload is a list of sub-\\ :class:`Mess msgstr "اگر بار پیام فهرستی از اشیای sub-\\ :class:`Message` باشد، ``True`` را برمی‌گرداند، در غیر این صورت ``False`` را برمی‌گرداند. هنگامی که :meth:`is_multipart` مقدار ``False`` را برمی‌گرداند، بار باید یک شیء رشته باشد (که ممکن است یک بار دودویی کدگذاری‌شده با CTE باشد). (توجه داشته باشید که برگرداندن ``True`` توسط :meth:`is_multipart` لزوماً به این معنا نیست که \"msg.get_content_maintype() == 'multipart'\" مقدار ``True`` را برمی‌گرداند. برای مثال، هنگامی که :class:`Message` از نوع ``message/rfc822`` باشد، ``is_multipart`` مقدار ``True`` را برمی‌گرداند.)" msgid "Set the message's envelope header to *unixfrom*, which should be a string." -msgstr "سرآیند پاکت پیام را روی *unixfrom* تنظیم کنید، که باید یک رشته باشد." +msgstr "سرآیند پاکت پیام را روی \*unixfrom\* تنظیم کنید، که باید یک رشته باشد." msgid "Return the message's envelope header. Defaults to ``None`` if the envelope header was never set." msgstr "سرآیند‌ پاکت پیام را برمی‌گرداند. اگر سرآیند‌ی پاکت هرگز تنظیم نشده باشد، مقدار پیش‌فرض ``None`` است." msgid "Add the given *payload* to the current payload, which must be ``None`` or a list of :class:`Message` objects before the call. After the call, the payload will always be a list of :class:`Message` objects. If you want to set the payload to a scalar object (e.g. a string), use :meth:`set_payload` instead." -msgstr "بار داده‌شده (*payload*) را به بار کنونی اضافه کنید، که باید پیش از فراخوانی ``None`` یا فهرستی از اشیای :class:`Message` باشد. پس از فراخوانی، بار همیشه فهرستی از اشیای :class:`Message` خواهد بود. اگر می‌خواهید بار را روی یک شیء اسکالر (scalar)، برای مثال یک رشته، تنظیم کنید، در عوض از :meth:`set_payload` استفاده کنید." +msgstr "بار داده‌شده (\*payload\*) را به بار کنونی اضافه کنید، که باید پیش از فراخوانی ``None`` یا فهرستی از اشیای :class:`Message` باشد. پس از فراخوانی، بار همیشه فهرستی از اشیای :class:`Message` خواهد بود. اگر می‌خواهید بار را روی یک شیء اسکالر (scalar)، برای مثال یک رشته، تنظیم کنید، در عوض از :meth:`set_payload` استفاده کنید." msgid "This is a legacy method. On the :class:`~email.message.EmailMessage` class its functionality is replaced by :meth:`~email.message.EmailMessage.set_content` and the related ``make`` and ``add`` methods." msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با :meth:`~email.message.EmailMessage.set_content` و متدهای مرتبط ``make`` و ``add`` جایگزین شده است." @@ -129,31 +129,31 @@ msgid "Return the current payload, which will be a list of :class:`Message` obje msgstr "بار فعلی را بازمی‌گرداند، که هنگامی که :meth:`is_multipart` برابر ``True`` باشد، فهرستی از اشیاء :class:`Message` خواهد بود، یا هنگامی که :meth:`is_multipart` برابر ``False`` باشد، یک رشته خواهد بود. اگر بار یک فهرست باشد و شما شیء فهرست را تغییر دهید، بار پیام را درجا تغییر می‌دهید." msgid "With optional argument *i*, :meth:`get_payload` will return the *i*-th element of the payload, counting from zero, if :meth:`is_multipart` is ``True``. An :exc:`IndexError` will be raised if *i* is less than 0 or greater than or equal to the number of items in the payload. If the payload is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, a :exc:`TypeError` is raised." -msgstr "با آرگومان اختیاری *i*، اگر :meth:`is_multipart` برابر ``True`` باشد، :meth:`get_payload` عنصر *i*ام بار را، با شمارش از صفر، برمی‌گرداند. اگر *i* کمتر از ۰ یا بزرگ‌تر یا مساوی تعداد آیتم‌های بار باشد، :exc:`IndexError` پرتاب می‌شود. اگر بار یک رشته باشد (یعنی :meth:`is_multipart` برابر ``False`` باشد) و *i* داده شده باشد، :exc:`TypeError` پرتاب می‌شود." +msgstr "با آرگومان اختیاری \*i\*، اگر :meth:`is_multipart` برابر ``True`` باشد، :meth:`get_payload` عنصر \*i\*ام بار را، با شمارش از صفر، برمی‌گرداند. اگر \*i\* کمتر از ۰ یا بزرگ‌تر یا مساوی تعداد آیتم‌های بار باشد، :exc:`IndexError` پرتاب می‌شود. اگر بار یک رشته باشد (یعنی :meth:`is_multipart` برابر ``False`` باشد) و \*i\* داده شده باشد، :exc:`TypeError` پرتاب می‌شود." msgid "Optional *decode* is a flag indicating whether the payload should be decoded or not, according to the :mailheader:`Content-Transfer-Encoding` header. When ``True`` and the message is not a multipart, the payload will be decoded if this header's value is ``quoted-printable`` or ``base64``. If some other encoding is used, or :mailheader:`Content-Transfer-Encoding` header is missing, the payload is returned as-is (undecoded). In all cases the returned value is binary data. If the message is a multipart and the *decode* flag is ``True``, then ``None`` is returned. If the payload is base64 and it was not perfectly formed (missing padding, characters outside the base64 alphabet), then an appropriate defect will be added to the message's defect property (:class:`~email.errors.InvalidBase64PaddingDefect` or :class:`~email.errors.InvalidBase64CharactersDefect`, respectively)." -msgstr "*decode* اختیاری پرچمی است که نشان می‌دهد بار باید بر اساس سرآیند :mailheader:`Content-Transfer-Encoding` کدگشایی شود یا خیر. هنگامی که ``True`` باشد و پیام چندبخشی نباشد، اگر مقدار این سرآیند ``quoted-printable`` یا ``base64`` باشد، بار کدگشایی خواهد شد. اگر از کدگذاری دیگری استفاده شده باشد یا سرآیند :mailheader:`Content-Transfer-Encoding` وجود نداشته باشد، بار به‌همان‌صورت (کدگشایی‌نشده) برگردانده می‌شود. در همه حالت‌ها، مقدار برگردانده‌شده داده‌های دودویی است. اگر پیام چندبخشی باشد و پرچم *decode* ``True`` باشد، ``None`` برگردانده می‌شود. اگر بار base64 باشد و به‌طور کامل درست تشکیل نشده باشد (نبود پدینگ، نویسه‌های خارج از الفبای base64)، نقص مناسبی به ویژگی نقص پیام افزوده خواهد شد (:class:`~email.errors.InvalidBase64PaddingDefect` یا :class:`~email.errors.InvalidBase64CharactersDefect`، به‌ترتیب)." +msgstr "\*decode\* اختیاری پرچمی است که نشان می‌دهد بار باید بر اساس سرآیند :mailheader:`Content-Transfer-Encoding` کدگشایی شود یا خیر. هنگامی که ``True`` باشد و پیام چندبخشی نباشد، اگر مقدار این سرآیند ``quoted-printable`` یا ``base64`` باشد، بار کدگشایی خواهد شد. اگر از کدگذاری دیگری استفاده شده باشد یا سرآیند :mailheader:`Content-Transfer-Encoding` وجود نداشته باشد، بار به‌همان‌صورت (کدگشایی‌نشده) برگردانده می‌شود. در همه حالت‌ها، مقدار برگردانده‌شده داده‌های دودویی است. اگر پیام چندبخشی باشد و پرچم \*decode\* ``True`` باشد، ``None`` برگردانده می‌شود. اگر بار base64 باشد و به‌طور کامل درست تشکیل نشده باشد (نبود پدینگ، نویسه‌های خارج از الفبای base64)، نقص مناسبی به ویژگی نقص پیام افزوده خواهد شد (:class:`~email.errors.InvalidBase64PaddingDefect` یا :class:`~email.errors.InvalidBase64CharactersDefect`، به‌ترتیب)." msgid "When *decode* is ``False`` (the default) the body is returned as a string without decoding the :mailheader:`Content-Transfer-Encoding`. However, for a :mailheader:`Content-Transfer-Encoding` of 8bit, an attempt is made to decode the original bytes using the ``charset`` specified by the :mailheader:`Content-Type` header, using the ``replace`` error handler. If no ``charset`` is specified, or if the ``charset`` given is not recognized by the email package, the body is decoded using the default ASCII charset." -msgstr "هنگامی که *decode* برابر ``False`` باشد (پیش‌فرض)، بدنه به‌صورت یک رشته بدون کدگشایی بر اساس :mailheader:`Content-Transfer-Encoding` بازگردانده می‌شود. با این حال، برای :mailheader:`Content-Transfer-Encoding` با مقدار 8bit، تلاشی برای کدگشایی بایت‌های اصلی با استفاده از ``charset`` مشخص‌شده توسط سرآیند :mailheader:`Content-Type` و با کنترل‌کننده‌ی خطای ``replace`` صورت می‌گیرد. اگر هیچ ``charset`` مشخص نشده باشد، یا ``charset`` داده‌شده توسط بسته‌ی email شناخته نشود، بدنه با استفاده از نویسه‌گان پیش‌فرض ASCII کدگشایی می‌شود." +msgstr "هنگامی که \*decode\* برابر ``False`` باشد (پیش‌فرض)، بدنه به‌صورت یک رشته بدون کدگشایی بر اساس :mailheader:`Content-Transfer-Encoding` بازگردانده می‌شود. با این حال، برای :mailheader:`Content-Transfer-Encoding` با مقدار 8bit، تلاشی برای کدگشایی بایت‌های اصلی با استفاده از ``charset`` مشخص‌شده توسط سرآیند :mailheader:`Content-Type` و با کنترل‌کننده‌ی خطای ``replace`` صورت می‌گیرد. اگر هیچ ``charset`` مشخص نشده باشد، یا ``charset`` داده‌شده توسط بسته‌ی email شناخته نشود، بدنه با استفاده از نویسه‌گان پیش‌فرض ASCII کدگشایی می‌شود." msgid "This is a legacy method. On the :class:`~email.message.EmailMessage` class its functionality is replaced by :meth:`~email.message.EmailMessage.get_content` and :meth:`~email.message.EmailMessage.iter_parts`." msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با :meth:`~email.message.EmailMessage.get_content` و :meth:`~email.message.EmailMessage.iter_parts` جایگزین شده است." msgid "Set the entire message object's payload to *payload*. It is the client's responsibility to ensure the payload invariants. Optional *charset* sets the message's default character set; see :meth:`set_charset` for details." -msgstr "کل بار شیء پیام را روی *payload* تنظیم کنید. مسئولیت اطمینان از برقراری ناورداهای بار بر عهده کلاینت است. *charset* اختیاری، مجموعه‌ی نویسه‌ی پیش‌فرض پیام را تنظیم می‌کند؛ برای جزئیات :meth:`set_charset` را ببینید." +msgstr "کل بار شیء پیام را روی \*payload\* تنظیم کنید. مسئولیت اطمینان از برقراری ناورداهای بار بر عهده کلاینت است. \*charset\* اختیاری، مجموعه‌ی نویسه‌ی پیش‌فرض پیام را تنظیم می‌کند؛ برای جزئیات :meth:`set_charset` را ببینید." msgid "This is a legacy method. On the :class:`~email.message.EmailMessage` class its functionality is replaced by :meth:`~email.message.EmailMessage.set_content`." msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با :meth:`~email.message.EmailMessage.set_content` جایگزین شده است." msgid "Set the character set of the payload to *charset*, which can either be a :class:`~email.charset.Charset` instance (see :mod:`email.charset`), a string naming a character set, or ``None``. If it is a string, it will be converted to a :class:`~email.charset.Charset` instance. If *charset* is ``None``, the ``charset`` parameter will be removed from the :mailheader:`Content-Type` header (the message will not be otherwise modified). Anything else will generate a :exc:`TypeError`." -msgstr "مجموعه‌ی نویسه‌های بار را روی *charset* تنظیم کنید، که می‌تواند یک نمونه از :class:`~email.charset.Charset` (به :mod:`email.charset` مراجعه کنید)، رشته‌ای که نام یک مجموعه نویسه را مشخص می‌کند، یا ``None`` باشد. اگر یک رشته باشد، به یک نمونه از :class:`~email.charset.Charset` تبدیل خواهد شد. اگر *charset* برابر ``None`` باشد، پارامتر ``charset`` از سرآیند :mailheader:`Content-Type` حذف خواهد شد (پیام به‌جز این مورد تغییر دیگری نخواهد کرد). هر چیز دیگری باعث ایجاد :exc:`TypeError` خواهد شد." +msgstr "مجموعه‌ی نویسه‌های بار را روی \*charset\* تنظیم کنید، که می‌تواند یک نمونه از :class:`~email.charset.Charset` (به :mod:`email.charset` مراجعه کنید)، رشته‌ای که نام یک مجموعه نویسه را مشخص می‌کند، یا ``None`` باشد. اگر یک رشته باشد، به یک نمونه از :class:`~email.charset.Charset` تبدیل خواهد شد. اگر \*charset\* برابر ``None`` باشد، پارامتر ``charset`` از سرآیند :mailheader:`Content-Type` حذف خواهد شد (پیام به‌جز این مورد تغییر دیگری نخواهد کرد). هر چیز دیگری باعث ایجاد :exc:`TypeError` خواهد شد." msgid "If there is no existing :mailheader:`MIME-Version` header one will be added. If there is no existing :mailheader:`Content-Type` header, one will be added with a value of :mimetype:`text/plain`. Whether the :mailheader:`Content-Type` header already exists or not, its ``charset`` parameter will be set to *charset.output_charset*. If *charset.input_charset* and *charset.output_charset* differ, the payload will be re-encoded to the *output_charset*. If there is no existing :mailheader:`Content-Transfer-Encoding` header, then the payload will be transfer-encoded, if needed, using the specified :class:`~email.charset.Charset`, and a header with the appropriate value will be added. If a :mailheader:`Content-Transfer-Encoding` header already exists, the payload is assumed to already be correctly encoded using that :mailheader:`Content-Transfer-Encoding` and is not modified." -msgstr "اگر سرآیند :mailheader:`MIME-Version` از قبل وجود نداشته باشد، یکی افزوده می‌شود. اگر سرآیند :mailheader:`Content-Type` از قبل وجود نداشته باشد، یکی با مقدار :mimetype:`text/plain` افزوده می‌شود. چه سرآیند :mailheader:`Content-Type` از قبل وجود داشته باشد و چه نداشته باشد، پارامتر ``charset`` آن به *charset.output_charset* تنظیم می‌شود. اگر *charset.input_charset* و *charset.output_charset* متفاوت باشند، بار به *output_charset* دوباره کدگذاری می‌شود. اگر سرآیند :mailheader:`Content-Transfer-Encoding` از قبل وجود نداشته باشد، در صورت نیاز، بار با استفاده از :class:`~email.charset.Charset` تعیین‌شده، کدگذاری انتقالی می‌شود و سرآیندی با مقدار مناسب افزوده می‌شود. اگر سرآیند :mailheader:`Content-Transfer-Encoding` از قبل وجود داشته باشد، فرض می‌شود بار از قبل به‌درستی با استفاده از همان :mailheader:`Content-Transfer-Encoding` کدگذاری شده است و تغییر داده نمی‌شود." +msgstr "اگر سرآیند :mailheader:`MIME-Version` از قبل وجود نداشته باشد، یکی افزوده می‌شود. اگر سرآیند :mailheader:`Content-Type` از قبل وجود نداشته باشد، یکی با مقدار :mimetype:`text/plain` افزوده می‌شود. چه سرآیند :mailheader:`Content-Type` از قبل وجود داشته باشد و چه نداشته باشد، پارامتر ``charset`` آن به \*charset.output_charset\* تنظیم می‌شود. اگر \*charset.input_charset\* و \*charset.output_charset\* متفاوت باشند، بار به \*output_charset\* دوباره کدگذاری می‌شود. اگر سرآیند :mailheader:`Content-Transfer-Encoding` از قبل وجود نداشته باشد، در صورت نیاز، بار با استفاده از :class:`~email.charset.Charset` تعیین‌شده، کدگذاری انتقالی می‌شود و سرآیندی با مقدار مناسب افزوده می‌شود. اگر سرآیند :mailheader:`Content-Transfer-Encoding` از قبل وجود داشته باشد، فرض می‌شود بار از قبل به‌درستی با استفاده از همان :mailheader:`Content-Transfer-Encoding` کدگذاری شده است و تغییر داده نمی‌شود." msgid "This is a legacy method. On the :class:`~email.message.EmailMessage` class its functionality is replaced by the *charset* parameter of the :meth:`email.message.EmailMessage.set_content` method." -msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با پارامتر *charset* متد :meth:`email.message.EmailMessage.set_content` جایگزین شده است." +msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با پارامتر \*charset\* متد :meth:`email.message.EmailMessage.set_content` جایگزین شده است." msgid "Return the :class:`~email.charset.Charset` instance associated with the message's payload." msgstr "نمونه‌ی :class:`~email.charset.Charset` مرتبط با بار پیام را برمی‌گرداند." @@ -177,7 +177,7 @@ msgid "Return the total number of headers, including duplicates." msgstr "تعداد کل سرآیند‌ها، شامل تکراری‌ها را برمی‌گرداند." msgid "Return ``True`` if the message object has a field named *name*. Matching is done case-insensitively and *name* should not include the trailing colon. Used for the ``in`` operator, e.g.::" -msgstr "اگر شیء پیام دارای فیلدی به نام *name* باشد، ``True`` را برمی‌گرداند. تطبیق بدون حساسیت به بزرگی و کوچکی حروف انجام می‌شود و *name* نباید شامل دونقطه پایانی باشد. برای عملگر ``in`` استفاده می‌شود، برای مثال::" +msgstr "اگر شیء پیام دارای فیلدی به نام \*name\* باشد، ``True`` را برمی‌گرداند. تطبیق بدون حساسیت به بزرگی و کوچکی حروف انجام می‌شود و \*name\* نباید شامل دونقطه پایانی باشد. برای عملگر ``in`` استفاده می‌شود، برای مثال::" msgid "" "if 'message-id' in myMessage:\n" @@ -187,16 +187,16 @@ msgstr "" " print('Message-ID:', myMessage['message-id'])" msgid "Return the value of the named header field. *name* should not include the colon field separator. If the header is missing, ``None`` is returned; a :exc:`KeyError` is never raised." -msgstr "مقدار فیلد سرآیند نام‌برده‌شده را برمی‌گرداند. *name* نباید شامل دونقطه‌ی جداکننده‌ی فیلد باشد. اگر سرآیند وجود نداشته باشد، ``None`` بازگشت داده می‌شود؛ هرگز :exc:`KeyError` پرتاب نمی‌شود." +msgstr "مقدار فیلد سرآیند نام‌برده‌شده را برمی‌گرداند. \*name\* نباید شامل دونقطه‌ی جداکننده‌ی فیلد باشد. اگر سرآیند وجود نداشته باشد، ``None`` بازگشت داده می‌شود؛ هرگز :exc:`KeyError` پرتاب نمی‌شود." msgid "Note that if the named field appears more than once in the message's headers, exactly which of those field values will be returned is undefined. Use the :meth:`get_all` method to get the values of all the extant named headers." msgstr "توجه داشته باشید که اگر فیلد نام‌برده‌شده بیش از یک بار در سرآیند‌های پیام ظاهر شود، دقیقاً این‌که کدام‌یک از مقادیر آن فیلد برگردانده خواهد شد، تعریف‌نشده است. برای دریافت مقادیر همه‌ی سرآیند‌های نام‌برده‌شده‌ی موجود، از متد :meth:`get_all` استفاده کنید." msgid "Add a header to the message with field name *name* and value *val*. The field is appended to the end of the message's existing fields." -msgstr "یک سرآیند با نام فیلد *name* و مقدار *val* به پیام اضافه کنید. این فیلد به انتهای فیلدهای موجود پیام افزوده می‌شود." +msgstr "یک سرآیند با نام فیلد \*name\* و مقدار \*val\* به پیام اضافه کنید. این فیلد به انتهای فیلدهای موجود پیام افزوده می‌شود." msgid "Note that this does *not* overwrite or delete any existing header with the same name. If you want to ensure that the new header is the only one present in the message with field name *name*, delete the field first, e.g.::" -msgstr "توجه داشته باشید که این کار هیچ سرآیند موجودی با نام یکسان را بازنویسی یا حذف *نمی‌کند*. اگر می‌خواهید اطمینان حاصل کنید که سرآیند جدید تنها سرآیند موجود در پیام با نام فیلد *name* است، ابتدا فیلد را حذف کنید، برای مثال::" +msgstr "توجه داشته باشید که این کار هیچ سرآیند موجودی با نام یکسان را بازنویسی یا حذف \*نمی‌کند\*. اگر می‌خواهید اطمینان حاصل کنید که سرآیند جدید تنها سرآیند موجود در پیام با نام فیلد \*name\* است، ابتدا فیلد را حذف کنید، برای مثال::" msgid "" "del msg['subject']\n" @@ -206,7 +206,7 @@ msgstr "" "msg['subject'] = 'Python roolz!'" msgid "Delete all occurrences of the field with name *name* from the message's headers. No exception is raised if the named field isn't present in the headers." -msgstr "تمام موارد فیلد با نام *name* را از سرآیند‌های پیام حذف می‌کند. اگر فیلد نام‌برده‌شده در سرآیند‌ها وجود نداشته باشد، هیچ استثنایی پرتاب نمی‌شود." +msgstr "تمام موارد فیلد با نام \*name\* را از سرآیند‌های پیام حذف می‌کند. اگر فیلد نام‌برده‌شده در سرآیند‌ها وجود نداشته باشد، هیچ استثنایی پرتاب نمی‌شود." msgid "Return a list of all the message's header field names." msgstr "فهرستی از همه‌ی نام‌های فیلد سرایند پیام را برمی‌گرداند." @@ -218,19 +218,19 @@ msgid "Return a list of 2-tuples containing all the message's field headers and msgstr "فهرستی از تاپل‌های دوتایی شامل تمام سرآیند‌ها و مقادیر فیلدهای پیام را برمی‌گرداند." msgid "Return the value of the named header field. This is identical to :meth:`~object.__getitem__` except that optional *failobj* is returned if the named header is missing (defaults to ``None``)." -msgstr "مقدار فیلد سرآیند با نام مشخص‌شده را برمی‌گرداند. این دقیقاً مانند :meth:`~object.__getitem__` است، با این تفاوت که اگر سرآیند با نام مشخص‌شده وجود نداشته باشد، *failobj* اختیاری برگردانده می‌شود (پیش‌فرض ``None`` است)." +msgstr "مقدار فیلد سرآیند با نام مشخص‌شده را برمی‌گرداند. این دقیقاً مانند :meth:`~object.__getitem__` است، با این تفاوت که اگر سرآیند با نام مشخص‌شده وجود نداشته باشد، \*failobj\* اختیاری برگردانده می‌شود (پیش‌فرض ``None`` است)." msgid "Here are some additional useful methods:" msgstr "در اینجا چند متد مفید دیگر آمده است:" msgid "Return a list of all the values for the field named *name*. If there are no such named headers in the message, *failobj* is returned (defaults to ``None``)." -msgstr "فهرستی از تمام مقدارهای فیلدی به نام *name* برمی‌گرداند. اگر هیچ سرآیند‌ی با این نام در پیام وجود نداشته باشد، *failobj* برگردانده می‌شود (پیش‌فرض ``None`` است)." +msgstr "فهرستی از تمام مقدارهای فیلدی به نام \*name\* برمی‌گرداند. اگر هیچ سرآیند‌ی با این نام در پیام وجود نداشته باشد، \*failobj\* برگردانده می‌شود (پیش‌فرض ``None`` است)." msgid "Extended header setting. This method is similar to :meth:`__setitem__` except that additional header parameters can be provided as keyword arguments. *_name* is the header field to add and *_value* is the *primary* value for the header." -msgstr "تنظیم سرآیند گسترش‌یافته. این متد مشابه :meth:`__setitem__` است، با این تفاوت که می‌توان پارامترهای اضافی سرآیند را به‌عنوان آرگومان‌های کلیدواژه‌ای ارائه کرد. *_name* فیلد سرآیندی است که باید اضافه شود، و *_value* مقدار *اصلی* برای سرآیند است." +msgstr "تنظیم سرآیند گسترش‌یافته. این متد مشابه :meth:`__setitem__` است، با این تفاوت که می‌توان پارامترهای اضافی سرآیند را به‌عنوان آرگومان‌های کلیدواژه‌ای ارائه کرد. \*_name\* فیلد سرآیندی است که باید اضافه شود، و \*_value\* مقدار \*اصلی\* برای سرآیند است." msgid "For each item in the keyword argument dictionary *_params*, the key is taken as the parameter name, with underscores converted to dashes (since dashes are illegal in Python identifiers). Normally, the parameter will be added as ``key=\"value\"`` unless the value is ``None``, in which case only the key will be added. If the value contains non-ASCII characters, it can be specified as a three tuple in the format ``(CHARSET, LANGUAGE, VALUE)``, where ``CHARSET`` is a string naming the charset to be used to encode the value, ``LANGUAGE`` can usually be set to ``None`` or the empty string (see :rfc:`2231` for other possibilities), and ``VALUE`` is the string value containing non-ASCII code points. If a three tuple is not passed and the value contains non-ASCII characters, it is automatically encoded in :rfc:`2231` format using a ``CHARSET`` of ``utf-8`` and a ``LANGUAGE`` of ``None``." -msgstr "برای هر آیتم در دیکشنری آرگومان‌های کلیدواژه‌ای *_params*، کلید به‌عنوان نام پارامتر در نظر گرفته می‌شود و زیرسطرها به خط تیره تبدیل می‌شوند (زیرا خط تیره در شناسه‌های پایتون غیرمجاز است). معمولاً، پارامتر به‌صورت ``key=\"value\"`` اضافه می‌شود، مگر اینکه مقدار ``None`` باشد، که در این صورت فقط کلید اضافه می‌شود. اگر مقدار شامل نویسه‌های غیر ASCII باشد، می‌توان آن را به‌صورت یک سه‌تایی در قالب ``(CHARSET, LANGUAGE, VALUE)`` مشخص کرد، که در آن ``CHARSET`` رشته‌ای است که نام مجموعه‌نویسه مورد استفاده برای کدگذاری مقدار را مشخص می‌کند، ``LANGUAGE`` معمولاً می‌تواند روی ``None`` یا رشته خالی تنظیم شود (برای سایر امکان‌ها :rfc:`2231` را ببینید)، و ``VALUE`` مقدار رشته‌ای حاوی نقاط کد غیر ASCII است. اگر یک سه‌تایی ارسال نشود و مقدار شامل نویسه‌های غیر ASCII باشد، به‌صورت خودکار در قالب :rfc:`2231` با ``CHARSET`` برابر با ``utf-8`` و ``LANGUAGE`` برابر با ``None`` کدگذاری می‌شود." +msgstr "برای هر آیتم در دیکشنری آرگومان‌های کلیدواژه‌ای \*_params\*، کلید به‌عنوان نام پارامتر در نظر گرفته می‌شود و زیرسطرها به خط تیره تبدیل می‌شوند (زیرا خط تیره در شناسه‌های پایتون غیرمجاز است). معمولاً، پارامتر به‌صورت ``key=\"value\"`` اضافه می‌شود، مگر اینکه مقدار ``None`` باشد، که در این صورت فقط کلید اضافه می‌شود. اگر مقدار شامل نویسه‌های غیر ASCII باشد، می‌توان آن را به‌صورت یک سه‌تایی در قالب ``(CHARSET, LANGUAGE, VALUE)`` مشخص کرد، که در آن ``CHARSET`` رشته‌ای است که نام مجموعه‌نویسه مورد استفاده برای کدگذاری مقدار را مشخص می‌کند، ``LANGUAGE`` معمولاً می‌تواند روی ``None`` یا رشته خالی تنظیم شود (برای سایر امکان‌ها :rfc:`2231` را ببینید)، و ``VALUE`` مقدار رشته‌ای حاوی نقاط کد غیر ASCII است. اگر یک سه‌تایی ارسال نشود و مقدار شامل نویسه‌های غیر ASCII باشد، به‌صورت خودکار در قالب :rfc:`2231` با ``CHARSET`` برابر با ``utf-8`` و ``LANGUAGE`` برابر با ``None`` کدگذاری می‌شود." msgid "Here's an example::" msgstr "در اینجا یک مثال آمده است::" @@ -258,10 +258,10 @@ msgid "Which produces ::" msgstr "که تولید می‌کند ::" msgid "Content-Disposition: attachment; filename*=\"iso-8859-1''Fu%DFballer.ppt\"" -msgstr "Content-Disposition: attachment; filename*=\"iso-8859-1''Fu%DFballer.ppt\"" +msgstr "Content-Disposition: attachment; filename\*=\"iso-8859-1''Fu%DFballer.ppt\"" msgid "Replace a header. Replace the first header found in the message that matches *_name*, retaining header order and field name case. If no matching header was found, a :exc:`KeyError` is raised." -msgstr "یک سرآیند را جایگزین می‌کند. نخستین سرآیند یافت‌شده در پیام را که با *_name* مطابقت دارد، با حفظ ترتیب سرآیندها و حالت حروف نام فیلد جایگزین می‌کند. اگر هیچ سرآیند مطابقی یافت نشد، یک :exc:`KeyError` پرتاب می‌شود." +msgstr "یک سرآیند را جایگزین می‌کند. نخستین سرآیند یافت‌شده در پیام را که با \*_name\* مطابقت دارد، با حفظ ترتیب سرآیندها و حالت حروف نام فیلد جایگزین می‌کند. اگر هیچ سرآیند مطابقی یافت نشد، یک :exc:`KeyError` پرتاب می‌شود." msgid "Return the message's content type. The returned string is coerced to lower case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:`Content-Type` header in the message the default type as given by :meth:`get_default_type` will be returned. Since according to :rfc:`2045`, messages always have a default type, :meth:`get_content_type` will always return a value." msgstr "نوع محتوای پیام را بازمی‌گرداند. رشته‌ی بازگردانده‌شده به حروف کوچک تبدیل می‌شود و در قالب :mimetype:`maintype/subtype` خواهد بود. اگر سرآیند :mailheader:`Content-Type` در پیام وجود نداشته باشد، نوع پیش‌فرض داده‌شده توسط :meth:`get_default_type` بازگردانده خواهد شد. از آنجا که طبق :rfc:`2045`، پیام‌ها همیشه یک نوع پیش‌فرض دارند، :meth:`get_content_type` همیشه یک مقدار بازمی‌گرداند." @@ -279,22 +279,22 @@ msgid "Return the default content type. Most messages have a default content ty msgstr "نوع محتوای پیش‌فرض را برمی‌گرداند. بیشتر پیام‌ها نوع محتوای پیش‌فرض :mimetype:`text/plain` دارند، به‌جز پیام‌هایی که زیربخش‌هایی از ظرف‌های :mimetype:`multipart/digest` هستند. چنین زیربخش‌هایی نوع محتوای پیش‌فرض :mimetype:`message/rfc822` دارند." msgid "Set the default content type. *ctype* should either be :mimetype:`text/plain` or :mimetype:`message/rfc822`, although this is not enforced. The default content type is not stored in the :mailheader:`Content-Type` header." -msgstr "نوع محتوای پیش‌فرض را تنظیم کنید. *ctype* باید یکی از :mimetype:`text/plain` یا :mimetype:`message/rfc822` باشد، اگرچه این موضوع اعمال نمی‌شود. نوع محتوای پیش‌فرض در سرآیند :mailheader:`Content-Type` ذخیره نمی‌شود." +msgstr "نوع محتوای پیش‌فرض را تنظیم کنید. \*ctype\* باید یکی از :mimetype:`text/plain` یا :mimetype:`message/rfc822` باشد، اگرچه این موضوع اعمال نمی‌شود. نوع محتوای پیش‌فرض در سرآیند :mailheader:`Content-Type` ذخیره نمی‌شود." msgid "Return the message's :mailheader:`Content-Type` parameters, as a list. The elements of the returned list are 2-tuples of key/value pairs, as split on the ``'='`` sign. The left hand side of the ``'='`` is the key, while the right hand side is the value. If there is no ``'='`` sign in the parameter the value is the empty string, otherwise the value is as described in :meth:`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." -msgstr "پارامترهای :mailheader:`Content-Type` پیام را به‌صورت یک فهرست بازمی‌گرداند. عناصر فهرست برگردانده‌شده تاپل‌های دوتایی از جفت‌های کلید/مقدار هستند که بر اساس علامت ``'='`` تفکیک شده‌اند. سمت چپ علامت ``'='`` کلید است، در حالی که سمت راست آن مقدار است. اگر علامت ``'='`` در پارامتر وجود نداشته باشد، مقدار یک رشته خالی است؛ در غیر این صورت مقدار همان‌گونه است که در :meth:`get_param` توضیح داده شده است و اگر پارامتر اختیاری *unquote* برابر ``True`` باشد (پیش‌فرض)، بدون علامت نقل‌قول می‌شود." +msgstr "پارامترهای :mailheader:`Content-Type` پیام را به‌صورت یک فهرست بازمی‌گرداند. عناصر فهرست برگردانده‌شده تاپل‌های دوتایی از جفت‌های کلید/مقدار هستند که بر اساس علامت ``'='`` تفکیک شده‌اند. سمت چپ علامت ``'='`` کلید است، در حالی که سمت راست آن مقدار است. اگر علامت ``'='`` در پارامتر وجود نداشته باشد، مقدار یک رشته خالی است؛ در غیر این صورت مقدار همان‌گونه است که در :meth:`get_param` توضیح داده شده است و اگر پارامتر اختیاری \*unquote\* برابر ``True`` باشد (پیش‌فرض)، بدون علامت نقل‌قول می‌شود." msgid "Optional *failobj* is the object to return if there is no :mailheader:`Content-Type` header. Optional *header* is the header to search instead of :mailheader:`Content-Type`." -msgstr "*failobj* اختیاری، شیءای است که اگر سرآیند :mailheader:`Content-Type` وجود نداشته باشد، بازگردانده می‌شود. *header* اختیاری، سرآیندی است که به‌جای :mailheader:`Content-Type` جستجو می‌شود." +msgstr "\*failobj\* اختیاری، شیءای است که اگر سرآیند :mailheader:`Content-Type` وجود نداشته باشد، بازگردانده می‌شود. \*header\* اختیاری، سرآیندی است که به‌جای :mailheader:`Content-Type` جستجو می‌شود." msgid "This is a legacy method. On the :class:`~email.message.EmailMessage` class its functionality is replaced by the *params* property of the individual header objects returned by the header access methods." -msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با ویژگی *params* اشیای سرآیند جداگانه‌ای که توسط متدهای دسترسی به سرآیند برگردانده می‌شوند، جایگزین شده است." +msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با ویژگی \*params\* اشیای سرآیند جداگانه‌ای که توسط متدهای دسترسی به سرآیند برگردانده می‌شوند، جایگزین شده است." msgid "Return the value of the :mailheader:`Content-Type` header's parameter *param* as a string. If the message has no :mailheader:`Content-Type` header or if there is no such parameter, then *failobj* is returned (defaults to ``None``)." -msgstr "مقدار پارامتر *param* از سرآیند :mailheader:`Content-Type` را به‌صورت یک رشته برمی‌گرداند. اگر پیام سرآیند :mailheader:`Content-Type` نداشته باشد یا چنین پارامتری وجود نداشته باشد، *failobj* برگردانده می‌شود (پیش‌فرض آن ``None`` است)." +msgstr "مقدار پارامتر \*param\* از سرآیند :mailheader:`Content-Type` را به‌صورت یک رشته برمی‌گرداند. اگر پیام سرآیند :mailheader:`Content-Type` نداشته باشد یا چنین پارامتری وجود نداشته باشد، \*failobj\* برگردانده می‌شود (پیش‌فرض آن ``None`` است)." msgid "Optional *header* if given, specifies the message header to use instead of :mailheader:`Content-Type`." -msgstr "*header* اختیاری، در صورت داده شدن، سرآیند پیامی را مشخص می‌کند که به‌جای :mailheader:`Content-Type` استفاده می‌شود." +msgstr "\*header\* اختیاری، در صورت داده شدن، سرآیند پیامی را مشخص می‌کند که به‌جای :mailheader:`Content-Type` استفاده می‌شود." msgid "Parameter keys are always compared case insensitively. The return value can either be a string, or a 3-tuple if the parameter was :rfc:`2231` encoded. When it's a 3-tuple, the elements of the value are of the form ``(CHARSET, LANGUAGE, VALUE)``. Note that both ``CHARSET`` and ``LANGUAGE`` can be ``None``, in which case you should consider ``VALUE`` to be encoded in the ``us-ascii`` charset. You can usually ignore ``LANGUAGE``." msgstr "کلیدهای پارامتر همیشه بدون حساسیت به بزرگی و کوچکی حروف مقایسه می‌شوند. مقدار بازگشتی می‌تواند یک رشته باشد، یا یک تاپل سه‌تایی در صورتی که پارامتر مطابق :rfc:`2231` کدگذاری شده باشد. هنگامی که یک تاپل سه‌تایی باشد، عناصر مقدار به شکل ``(CHARSET, LANGUAGE, VALUE)`` هستند. توجه داشته باشید که هر دو ``CHARSET`` و ``LANGUAGE`` می‌توانند ``None`` باشند، که در این صورت باید فرض کنید ``VALUE`` با مجموعه‌نویسه ``us-ascii`` کدگذاری شده است. معمولاً می‌توانید ``LANGUAGE`` را نادیده بگیرید." @@ -310,52 +310,52 @@ msgstr "" "param = email.utils.collapse_rfc2231_value(rawparam)" msgid "In any case, the parameter value (either the returned string, or the ``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set to ``False``." -msgstr "در هر صورت، مقدار پارامتر (چه رشته‌ی برگردانده‌شده، چه آیتم ``VALUE`` در ۳-تایی) همیشه بدون علامت نقل‌قول است، مگر اینکه *unquote* روی ``False`` تنظیم شده باشد." +msgstr "در هر صورت، مقدار پارامتر (چه رشته‌ی برگردانده‌شده، چه آیتم ``VALUE`` در ۳-تایی) همیشه بدون علامت نقل‌قول است، مگر اینکه \*unquote\* روی ``False`` تنظیم شده باشد." msgid "Set a parameter in the :mailheader:`Content-Type` header. If the parameter already exists in the header, its value will be replaced with *value*. If the :mailheader:`Content-Type` header as not yet been defined for this message, it will be set to :mimetype:`text/plain` and the new parameter value will be appended as per :rfc:`2045`." -msgstr "پارامتری را در سرآیند :mailheader:`Content-Type` تنظیم کنید. اگر پارامتر از قبل در سرآیند وجود داشته باشد، مقدار آن با *value* جایگزین خواهد شد. اگر سرآیند :mailheader:`Content-Type` هنوز برای این پیام تعریف‌نشده باشد، به :mimetype:`text/plain` تنظیم خواهد شد و مقدار پارامتر جدید مطابق :rfc:`2045` افزوده خواهد شد." +msgstr "پارامتری را در سرآیند :mailheader:`Content-Type` تنظیم کنید. اگر پارامتر از قبل در سرآیند وجود داشته باشد، مقدار آن با \*value\* جایگزین خواهد شد. اگر سرآیند :mailheader:`Content-Type` هنوز برای این پیام تعریف‌نشده باشد، به :mimetype:`text/plain` تنظیم خواهد شد و مقدار پارامتر جدید مطابق :rfc:`2045` افزوده خواهد شد." msgid "Optional *header* specifies an alternative header to :mailheader:`Content-Type`, and all parameters will be quoted as necessary unless optional *requote* is ``False`` (the default is ``True``)." -msgstr "*header* اختیاری یک سرآیند جایگزین به‌جای :mailheader:`Content-Type` مشخص می‌کند، و همه‌ی پارامترها در صورت لزوم داخل علامت نقل‌قول قرار می‌گیرند، مگر آنکه *requote* اختیاری ``False`` باشد (پیش‌فرض ``True`` است)." +msgstr "\*header\* اختیاری یک سرآیند جایگزین به‌جای :mailheader:`Content-Type` مشخص می‌کند، و همه‌ی پارامترها در صورت لزوم داخل علامت نقل‌قول قرار می‌گیرند، مگر آنکه \*requote\* اختیاری ``False`` باشد (پیش‌فرض ``True`` است)." msgid "If optional *charset* is specified, the parameter will be encoded according to :rfc:`2231`. Optional *language* specifies the RFC 2231 language, defaulting to the empty string. Both *charset* and *language* should be strings." -msgstr "اگر *charset* اختیاری مشخص شده باشد، پارامتر مطابق :rfc:`2231` کدگذاری خواهد شد. *language* اختیاری، زبان RFC 2231 را مشخص می‌کند و مقدار پیش‌فرض آن رشته خالی است. هر دو *charset* و *language* باید رشته باشند." +msgstr "اگر \*charset\* اختیاری مشخص شده باشد، پارامتر مطابق :rfc:`2231` کدگذاری خواهد شد. \*language\* اختیاری، زبان RFC 2231 را مشخص می‌کند و مقدار پیش‌فرض آن رشته خالی است. هر دو \*charset\* و \*language\* باید رشته باشند." msgid "If *replace* is ``False`` (the default) the header is moved to the end of the list of headers. If *replace* is ``True``, the header will be updated in place." -msgstr "اگر *replace* برابر ``False`` باشد (حالت پیش‌فرض)، سرآیند به انتهای فهرست سرآیندها منتقل می‌شود. اگر *replace* برابر ``True`` باشد، سرآیند در همان محل به‌روزرسانی می‌شود." +msgstr "اگر \*replace\* برابر ``False`` باشد (حالت پیش‌فرض)، سرآیند به انتهای فهرست سرآیندها منتقل می‌شود. اگر \*replace\* برابر ``True`` باشد، سرآیند در همان محل به‌روزرسانی می‌شود." msgid "``replace`` keyword was added." msgstr "کلیدواژه‌ی ``replace`` افزوده شد." msgid "Remove the given parameter completely from the :mailheader:`Content-Type` header. The header will be re-written in place without the parameter or its value. All values will be quoted as necessary unless *requote* is ``False`` (the default is ``True``). Optional *header* specifies an alternative to :mailheader:`Content-Type`." -msgstr "پارامتر داده‌شده را به‌طور کامل از سرآیند :mailheader:`Content-Type` حذف می‌کند. سرآیند به‌صورت درجا بدون پارامتر یا مقدار آن بازنویسی خواهد شد. همه مقادیر در صورت لزوم داخل علامت نقل‌قول قرار می‌گیرند، مگر اینکه *requote* ``False`` باشد (پیش‌فرض ``True`` است). پارامتر اختیاری *header*، جایگزینی برای :mailheader:`Content-Type` مشخص می‌کند." +msgstr "پارامتر داده‌شده را به‌طور کامل از سرآیند :mailheader:`Content-Type` حذف می‌کند. سرآیند به‌صورت درجا بدون پارامتر یا مقدار آن بازنویسی خواهد شد. همه مقادیر در صورت لزوم داخل علامت نقل‌قول قرار می‌گیرند، مگر اینکه \*requote\* ``False`` باشد (پیش‌فرض ``True`` است). پارامتر اختیاری \*header\*، جایگزینی برای :mailheader:`Content-Type` مشخص می‌کند." msgid "Set the main type and subtype for the :mailheader:`Content-Type` header. *type* must be a string in the form :mimetype:`maintype/subtype`, otherwise a :exc:`ValueError` is raised." -msgstr "نوع اصلی و نوع فرعی را برای سرآیند :mailheader:`Content-Type` تنظیم کنید. *type* باید رشته‌ای به شکل :mimetype:`maintype/subtype` باشد، در غیر این صورت یک :exc:`ValueError` پرتاب می‌شود." +msgstr "نوع اصلی و نوع فرعی را برای سرآیند :mailheader:`Content-Type` تنظیم کنید. \*type\* باید رشته‌ای به شکل :mimetype:`maintype/subtype` باشد، در غیر این صورت یک :exc:`ValueError` پرتاب می‌شود." msgid "This method replaces the :mailheader:`Content-Type` header, keeping all the parameters in place. If *requote* is ``False``, this leaves the existing header's quoting as is, otherwise the parameters will be quoted (the default)." -msgstr "این متد سرآیند :mailheader:`Content-Type` را جایگزین می‌کند و تمام پارامترها را در جای خود نگه می‌دارد. اگر *requote* برابر ``False`` باشد، نقل‌قول سرآیند موجود همان‌طور که هست باقی می‌ماند، در غیر این صورت پارامترها داخل علامت نقل‌قول قرار می‌گیرند (حالت پیش‌فرض)." +msgstr "این متد سرآیند :mailheader:`Content-Type` را جایگزین می‌کند و تمام پارامترها را در جای خود نگه می‌دارد. اگر \*requote\* برابر ``False`` باشد، نقل‌قول سرآیند موجود همان‌طور که هست باقی می‌ماند، در غیر این صورت پارامترها داخل علامت نقل‌قول قرار می‌گیرند (حالت پیش‌فرض)." msgid "An alternative header can be specified in the *header* argument. When the :mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header is also added." -msgstr "می‌توان یک سرآیند جایگزین را در آرگومان *header* مشخص کرد. هنگامی که سرآیند :mailheader:`Content-Type` تنظیم شود، سرآیند :mailheader:`MIME-Version` نیز اضافه می‌شود." +msgstr "می‌توان یک سرآیند جایگزین را در آرگومان \*header\* مشخص کرد. هنگامی که سرآیند :mailheader:`Content-Type` تنظیم شود، سرآیند :mailheader:`MIME-Version` نیز اضافه می‌شود." msgid "This is a legacy method. On the :class:`~email.message.EmailMessage` class its functionality is replaced by the ``make_`` and ``add_`` methods." msgstr "این یک متد قدیمی است. در کلاس :class:`~email.message.EmailMessage`، عملکرد آن با متدهای ``make_`` و ``add_`` جایگزین شده است." msgid "Return the value of the ``filename`` parameter of the :mailheader:`Content-Disposition` header of the message. If the header does not have a ``filename`` parameter, this method falls back to looking for the ``name`` parameter on the :mailheader:`Content-Type` header. If neither is found, or the header is missing, then *failobj* is returned. The returned string will always be unquoted as per :func:`email.utils.unquote`." -msgstr "مقدار پارامتر ``filename`` از سرآیند :mailheader:`Content-Disposition` پیام را برمی‌گرداند. اگر سرآیند پارامتر ``filename`` نداشته باشد، این متد به‌عنوان جایگزین پارامتر ``name`` را در سرآیند :mailheader:`Content-Type` جست‌وجو می‌کند. اگر هیچ‌کدام پیدا نشود یا سرآیند وجود نداشته باشد، *failobj* برگردانده می‌شود. رشته‌ی برگردانده‌شده همیشه مطابق :func:`email.utils.unquote` بدون علامت نقل‌قول خواهد بود." +msgstr "مقدار پارامتر ``filename`` از سرآیند :mailheader:`Content-Disposition` پیام را برمی‌گرداند. اگر سرآیند پارامتر ``filename`` نداشته باشد، این متد به‌عنوان جایگزین پارامتر ``name`` را در سرآیند :mailheader:`Content-Type` جست‌وجو می‌کند. اگر هیچ‌کدام پیدا نشود یا سرآیند وجود نداشته باشد، \*failobj\* برگردانده می‌شود. رشته‌ی برگردانده‌شده همیشه مطابق :func:`email.utils.unquote` بدون علامت نقل‌قول خواهد بود." msgid "Return the value of the ``boundary`` parameter of the :mailheader:`Content-Type` header of the message, or *failobj* if either the header is missing, or has no ``boundary`` parameter. The returned string will always be unquoted as per :func:`email.utils.unquote`." -msgstr "مقدار پارامتر ``boundary`` در سرآیند :mailheader:`Content-Type` پیام را بازمی‌گرداند، یا اگر سرآیند وجود نداشته باشد یا پارامتر ``boundary`` نداشته باشد، *failobj* را بازمی‌گرداند. رشته‌ی بازگشتی همیشه طبق :func:`email.utils.unquote` بدون علامت نقل‌قول خواهد بود." +msgstr "مقدار پارامتر ``boundary`` در سرآیند :mailheader:`Content-Type` پیام را بازمی‌گرداند، یا اگر سرآیند وجود نداشته باشد یا پارامتر ``boundary`` نداشته باشد، \*failobj\* را بازمی‌گرداند. رشته‌ی بازگشتی همیشه طبق :func:`email.utils.unquote` بدون علامت نقل‌قول خواهد بود." msgid "Set the ``boundary`` parameter of the :mailheader:`Content-Type` header to *boundary*. :meth:`set_boundary` will always quote *boundary* if necessary. A :exc:`~email.errors.HeaderParseError` is raised if the message object has no :mailheader:`Content-Type` header." -msgstr "پارامتر ``boundary`` در سرآیند :mailheader:`Content-Type` را روی *boundary* تنظیم کنید. :meth:`set_boundary` همیشه در صورت لزوم *boundary* را داخل علامت نقل‌قول قرار می‌دهد. اگر شیء پیام فاقد سرآیند :mailheader:`Content-Type` باشد، یک :exc:`~email.errors.HeaderParseError` پرتاب می‌شود." +msgstr "پارامتر ``boundary`` در سرآیند :mailheader:`Content-Type` را روی \*boundary\* تنظیم کنید. :meth:`set_boundary` همیشه در صورت لزوم \*boundary\* را داخل علامت نقل‌قول قرار می‌دهد. اگر شیء پیام فاقد سرآیند :mailheader:`Content-Type` باشد، یک :exc:`~email.errors.HeaderParseError` پرتاب می‌شود." msgid "Note that using this method is subtly different than deleting the old :mailheader:`Content-Type` header and adding a new one with the new boundary via :meth:`add_header`, because :meth:`set_boundary` preserves the order of the :mailheader:`Content-Type` header in the list of headers. However, it does *not* preserve any continuation lines which may have been present in the original :mailheader:`Content-Type` header." -msgstr "توجه داشته باشید که استفاده از این متد به‌طور ظریفی با حذف سرآیند قدیمی :mailheader:`Content-Type` و افزودن یک سرآیند جدید با مرز جدید (boundary) از طریق :meth:`add_header` متفاوت است، زیرا :meth:`set_boundary` ترتیب سرآیند :mailheader:`Content-Type` را در فهرست سرآیندها حفظ می‌کند. با این حال، این کار هیچ‌یک از سطرهای ادامه‌ای را که ممکن است در سرآیند اصلی :mailheader:`Content-Type` وجود داشته باشد، حفظ *نمی‌کند*." +msgstr "توجه داشته باشید که استفاده از این متد به‌طور ظریفی با حذف سرآیند قدیمی :mailheader:`Content-Type` و افزودن یک سرآیند جدید با مرز جدید (boundary) از طریق :meth:`add_header` متفاوت است، زیرا :meth:`set_boundary` ترتیب سرآیند :mailheader:`Content-Type` را در فهرست سرآیندها حفظ می‌کند. با این حال، این کار هیچ‌یک از سطرهای ادامه‌ای را که ممکن است در سرآیند اصلی :mailheader:`Content-Type` وجود داشته باشد، حفظ \*نمی‌کند\*." msgid "Return the ``charset`` parameter of the :mailheader:`Content-Type` header, coerced to lower case. If there is no :mailheader:`Content-Type` header, or if that header has no ``charset`` parameter, *failobj* is returned." -msgstr "پارامتر ``charset`` سرآیند :mailheader:`Content-Type` را به‌صورت حروف کوچک برمی‌گرداند. اگر سرآیند :mailheader:`Content-Type` وجود نداشته باشد، یا اگر آن سرآیند پارامتر ``charset`` نداشته باشد، *failobj* برگردانده می‌شود." +msgstr "پارامتر ``charset`` سرآیند :mailheader:`Content-Type` را به‌صورت حروف کوچک برمی‌گرداند. اگر سرآیند :mailheader:`Content-Type` وجود نداشته باشد، یا اگر آن سرآیند پارامتر ``charset`` نداشته باشد، \*failobj\* برگردانده می‌شود." msgid "Note that this method differs from :meth:`get_charset` which returns the :class:`~email.charset.Charset` instance for the default encoding of the message body." msgstr "توجه داشته باشید که این متد با :meth:`get_charset` متفاوت است، که نمونه‌ی :class:`~email.charset.Charset` را برای کدگذاری پیش‌فرض بدنه‌ی پیام برمی‌گرداند." @@ -364,10 +364,10 @@ msgid "Return a list containing the character set names in the message. If the msgstr "فهرستی شامل نام مجموعه‌نویسه‌های موجود در پیام برمی‌گرداند. اگر پیام از نوع :mimetype:`multipart` باشد، فهرست شامل یک المان به‌ازای هر زیربخش در بار خواهد بود، در غیر این صورت، فهرستی به طول ۱ خواهد بود." msgid "Each item in the list will be a string which is the value of the ``charset`` parameter in the :mailheader:`Content-Type` header for the represented subpart. However, if the subpart has no :mailheader:`Content-Type` header, no ``charset`` parameter, or is not of the :mimetype:`text` main MIME type, then that item in the returned list will be *failobj*." -msgstr "هر آیتم در فهرست رشته‌ای خواهد بود که مقدار پارامتر ``charset`` در سرآیند :mailheader:`Content-Type` برای زیربخش بازنمایی‌شده است. با این حال، اگر زیربخش فاقد سرآیند :mailheader:`Content-Type` یا فاقد پارامتر ``charset`` باشد، یا از نوع اصلی MIME :mimetype:`text` نباشد، آن آیتم در فهرست برگردانده‌شده *failobj* خواهد بود." +msgstr "هر آیتم در فهرست رشته‌ای خواهد بود که مقدار پارامتر ``charset`` در سرآیند :mailheader:`Content-Type` برای زیربخش بازنمایی‌شده است. با این حال، اگر زیربخش فاقد سرآیند :mailheader:`Content-Type` یا فاقد پارامتر ``charset`` باشد، یا از نوع اصلی MIME :mimetype:`text` نباشد، آن آیتم در فهرست برگردانده‌شده \*failobj\* خواهد بود." msgid "Return the lowercased value (without parameters) of the message's :mailheader:`Content-Disposition` header if it has one, or ``None``. The possible values for this method are *inline*, *attachment* or ``None`` if the message follows :rfc:`2183`." -msgstr "در صورتی که پیام سرآیند :mailheader:`Content-Disposition` داشته باشد، مقدار با حروف کوچک (بدون پارامترها) آن را برمی‌گرداند؛ در غیر این صورت ``None`` را برمی‌گرداند. در صورتی که پیام از :rfc:`2183` پیروی کند، مقادیر ممکن برای این متد *inline*، *attachment* یا ``None`` هستند." +msgstr "در صورتی که پیام سرآیند :mailheader:`Content-Disposition` داشته باشد، مقدار با حروف کوچک (بدون پارامترها) آن را برمی‌گرداند؛ در غیر این صورت ``None`` را برمی‌گرداند. در صورتی که پیام از :rfc:`2183` پیروی کند، مقادیر ممکن برای این متد \*inline\*، \*attachment\* یا ``None`` هستند." msgid "The :meth:`walk` method is an all-purpose generator which can be used to iterate over all the parts and subparts of a message object tree, in depth-first traversal order. You will typically use :meth:`walk` as the iterator in a ``for`` loop; each iteration returns the next subpart." msgstr "متد :meth:`walk` یک تولیدگر همه‌منظوره است که می‌توان از آن برای پیمایش تمام بخش‌ها و زیربخش‌های یک درخت شیء پیام، به ترتیب پیمایش عمق‌اول استفاده کرد. شما معمولاً از :meth:`walk` به عنوان پیمایش‌گر در یک حلقه ``for`` استفاده می‌کنید؛ هر تکرار، زیربخش بعدی را برمی‌گرداند." @@ -448,16 +448,16 @@ msgid "The format of a MIME document allows for some text between the blank line msgstr "قالب یک سند MIME اجازه می‌دهد که مقداری متن میان خط خالی پس از سرآیند‌ها و نخستین رشته‌ی مرزی چندبخشی وجود داشته باشد. به‌طور معمول، این متن در یک نامه‌خوان آگاه از MIME هرگز قابل مشاهده نیست، زیرا خارج از پوشش استاندارد MIME قرار دارد. با این حال، هنگام مشاهده‌ی متن خام پیام، یا هنگام مشاهده‌ی پیام در نامه‌خوانی که از MIME آگاه نیست، این متن می‌تواند قابل مشاهده شود." msgid "The *preamble* attribute contains this leading extra-armor text for MIME documents. When the :class:`~email.parser.Parser` discovers some text after the headers but before the first boundary string, it assigns this text to the message's *preamble* attribute. When the :class:`~email.generator.Generator` is writing out the plain text representation of a MIME message, and it finds the message has a *preamble* attribute, it will write this text in the area between the headers and the first boundary. See :mod:`email.parser` and :mod:`email.generator` for details." -msgstr "ویژگی *preamble* شامل این متن نگهبان اضافی آغازین (extra-armor) برای اسناد MIME است. هنگامی که :class:`~email.parser.Parser` متنی را پس از سرآیندها اما پیش از نخستین رشته‌ی مرزی پیدا کند، این متن را به ویژگی *preamble* پیام اختصاص می‌دهد. هنگامی که :class:`~email.generator.Generator` در حال نوشتن نمایش متنی ساده‌ی یک پیام MIME است و متوجه شود که پیام دارای ویژگی *preamble* است، این متن را در ناحیه‌ی بین سرآیندها و نخستین مرز می‌نویسد. برای جزئیات، :mod:`email.parser` و :mod:`email.generator` را ببینید." +msgstr "ویژگی \*preamble\* شامل این متن نگهبان اضافی آغازین (extra-armor) برای اسناد MIME است. هنگامی که :class:`~email.parser.Parser` متنی را پس از سرآیندها اما پیش از نخستین رشته‌ی مرزی پیدا کند، این متن را به ویژگی \*preamble\* پیام اختصاص می‌دهد. هنگامی که :class:`~email.generator.Generator` در حال نوشتن نمایش متنی ساده‌ی یک پیام MIME است و متوجه شود که پیام دارای ویژگی \*preamble\* است، این متن را در ناحیه‌ی بین سرآیندها و نخستین مرز می‌نویسد. برای جزئیات، :mod:`email.parser` و :mod:`email.generator` را ببینید." msgid "Note that if the message object has no preamble, the *preamble* attribute will be ``None``." -msgstr "توجه داشته باشید که اگر شیء پیام فاقد *preamble* باشد، ویژگی *preamble* برابر ``None`` خواهد بود." +msgstr "توجه داشته باشید که اگر شیء پیام فاقد \*preamble\* باشد، ویژگی \*preamble\* برابر ``None`` خواهد بود." msgid "The *epilogue* attribute acts the same way as the *preamble* attribute, except that it contains text that appears between the last boundary and the end of the message." -msgstr "ویژگی *epilogue* مانند ویژگی *preamble* عمل می‌کند، با این تفاوت که شامل متنی است که میان آخرین مرز (boundary) و پایان پیام قرار می‌گیرد." +msgstr "ویژگی \*epilogue\* مانند ویژگی \*preamble\* عمل می‌کند، با این تفاوت که شامل متنی است که میان آخرین مرز (boundary) و پایان پیام قرار می‌گیرد." msgid "You do not need to set the epilogue to the empty string in order for the :class:`~email.generator.Generator` to print a newline at the end of the file." msgstr "برای اینکه :class:`~email.generator.Generator` یک خط جدید در پایان پرونده چاپ کند، نیازی نیست بخش پایانی (epilogue) را به رشته خالی تنظیم کنید." msgid "The *defects* attribute contains a list of all the problems found when parsing this message. See :mod:`email.errors` for a detailed description of the possible parsing defects." -msgstr "ویژگی *defects* شامل فهرستی از تمام مشکلات یافت‌شده هنگام تجزیه‌ی این پیام است. برای شرح دقیق نقص‌های ممکن در تجزیه، :mod:`email.errors` را ببینید." +msgstr "ویژگی \*defects\* شامل فهرستی از تمام مشکلات یافت‌شده هنگام تجزیه‌ی این پیام است. برای شرح دقیق نقص‌های ممکن در تجزیه، :mod:`email.errors` را ببینید." diff --git a/library/modulefinder.po b/library/modulefinder.po index 6bdd498e..dd1f3659 100644 --- a/library/modulefinder.po +++ b/library/modulefinder.po @@ -133,7 +133,7 @@ msgid "" "guido.python.ham\n" "baconhameggs" msgstr "" -"ماژول‌های بارگذاری‌شده:\n" +"Loaded modules:\n" "_types:\n" "copyreg: _inverted_registry,_slotnames,__all__\n" "re._compiler: isstring,_sre,_optimize_unicode\n" @@ -147,6 +147,6 @@ msgstr "" "array:\n" "types: __module__,IntType,TypeType\n" "---------------------------------------------------\n" -"ماژول‌های ایمپورت نشده:\n" +"Modules not imported:\n" "guido.python.ham\n" -"baconhameggs" +"baconhameggs" \ No newline at end of file diff --git a/library/optparse.po b/library/optparse.po index f18b406f..e1be37ce 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -1687,10 +1687,10 @@ msgid "" " ...\n" " -n, --noisy be noisy" msgstr "" -"گزینه‌ها:\n" -" --dry-run آسیبی نمی‌رساند\n" +"Options:\n" +" --dry-run do no harm\n" " ...\n" -" -n, --noisy پرسروصدا باشد" +" -n, --noisy be noisy" msgid "It's possible to whittle away the option strings for a previously added option until there are none left, and the user has no way of invoking that option from the command-line. In that case, :mod:`!optparse` removes that option completely, so it doesn't show up in help text or anywhere else. Carrying on with our existing OptionParser::" msgstr "می‌توان رشته‌های گزینه‌ی یک گزینه‌ی پیش‌تر افزوده‌شده را به‌تدریج حذف کرد تا هیچ رشته‌ای باقی نماند و کاربر دیگر راهی برای فراخوانی آن گزینه از خط فرمان نداشته باشد. در این صورت، :mod:`!optparse` آن گزینه را به‌طور کامل حذف می‌کند، بنابراین در متن راهنما یا هیچ جای دیگری نمایش داده نمی‌شود. ادامه‌ی کار با OptionParser موجود::" @@ -1707,10 +1707,10 @@ msgid "" " -n, --noisy be noisy\n" " --dry-run new dry-run option" msgstr "" -"گزینه‌ها:\n" +"Options:\n" " ...\n" -" -n, --noisy پرسروصدا باشد\n" -" --dry-run گزینه‌ی جدید dry-run" +" -n, --noisy be noisy\n" +" --dry-run new dry-run option" msgid "Cleanup" msgstr "پاک‌سازی" diff --git a/library/re.po b/library/re.po index 40c222ca..78916901 100644 --- a/library/re.po +++ b/library/re.po @@ -1355,19 +1355,19 @@ msgid "To extract the filename and numbers from a string like ::" msgstr "برای استخراج نام پرونده و اعداد از رشته‌ای مانند ::" msgid "/usr/sbin/sendmail - 0 errors, 4 warnings" -msgstr "/usr/sbin/sendmail - ۰ خطا، ۴ هشدار" +msgstr "/usr/sbin/sendmail - 0 errors, 4 warnings" msgid "you would use a :c:func:`!scanf` format like ::" msgstr "از یک قالب :c:func:`!scanf` مانند زیر استفاده می‌کنید ::" msgid "%s - %d errors, %d warnings" -msgstr "%s - %d خطا، %d هشدار" +msgstr "%s - %d errors, %d warnings" msgid "The equivalent regular expression would be ::" msgstr "عبارت باقاعده معادل به این صورت خواهد بود ::" msgid "(\\S+) - (\\d+) errors, (\\d+) warnings" -msgstr "(\\S+) - (\\d+) خطا، (\\d+) هشدار" +msgstr "(\\S+) - (\\d+) errors, (\\d+) warnings" msgid "search() vs. match()" msgstr "search() در مقابل match()" diff --git a/library/socket.po b/library/socket.po index 42f47f0f..a7958ab1 100644 --- a/library/socket.po +++ b/library/socket.po @@ -33,7 +33,7 @@ msgid "**Source code:** :source:`Lib/socket.py`" msgstr "**کد منبع:** :source:`Lib/socket.py`" msgid "This module provides access to the BSD *socket* interface. It is available on all modern Unix systems, Windows, MacOS, and probably additional platforms." -msgstr "این ماژول دسترسی به رابط *سوکت* BSD را فراهم می‌کند. این ماژول در تمام سیستم‌های یونیکس مدرن، ویندوز، مک‌اواس و احتمالاً پلتفرم‌های دیگر در دسترس است." +msgstr "این ماژول دسترسی به رابط \*سوکت\* BSD را فراهم می‌کند. این ماژول در تمام سیستم‌های یونیکس مدرن، ویندوز، مک‌اواس و احتمالاً پلتفرم‌های دیگر در دسترس است." msgid "Some behavior may be platform dependent, since calls are made to the operating system socket APIs." msgstr "برخی رفتارها ممکن است وابسته به پلتفرم باشند، زیرا APIهای سوکت سیستم‌عامل فراخوانی می‌شوند." @@ -78,16 +78,16 @@ msgid "Writable :term:`bytes-like object` is now accepted." msgstr "اکنون :term:`bytes-like object` قابل نوشتن پذیرفته می‌شود." msgid "A pair ``(host, port)`` is used for the :const:`AF_INET` address family, where *host* is a string representing either a hostname in internet domain notation like ``'daring.cwi.nl'`` or an IPv4 address like ``'100.50.200.5'``, and *port* is an integer." -msgstr "از یک جفت ``(host, port)`` برای خانواده‌ی نشانی :const:`AF_INET` استفاده می‌شود، که در آن *host* رشته‌ای است که یا یک نام میزبان با نمادگذاری دامنه‌ی اینترنتی مانند ``'daring.cwi.nl'`` یا یک نشانی IPv4 مانند ``'100.50.200.5'`` را نشان می‌دهد، و *port* یک عدد صحیح است." +msgstr "از یک جفت ``(host, port)`` برای خانواده‌ی نشانی :const:`AF_INET` استفاده می‌شود، که در آن \*host\* رشته‌ای است که یا یک نام میزبان با نمادگذاری دامنه‌ی اینترنتی مانند ``'daring.cwi.nl'`` یا یک نشانی IPv4 مانند ``'100.50.200.5'`` را نشان می‌دهد، و \*port\* یک عدد صحیح است." msgid "For IPv4 addresses, two special forms are accepted instead of a host address: ``''`` represents :const:`INADDR_ANY`, which is used to bind to all interfaces, and the string ``''`` represents :const:`INADDR_BROADCAST`. This behavior is not compatible with IPv6, therefore, you may want to avoid these if you intend to support IPv6 with your Python programs." msgstr "برای آدرس‌های IPv4، به جای آدرس میزبان، دو شکل خاص پذیرفته می‌شوند: ``''`` نشان‌دهنده :const:`INADDR_ANY` است که برای مقیدسازی به همه رابط‌ها استفاده می‌شود، و رشته ``''`` نشان‌دهنده :const:`INADDR_BROADCAST` است. این رفتار با IPv6 ناسازگار است، بنابراین، اگر قصد دارید در برنامه‌های پایتون خود از IPv6 پشتیبانی کنید، ممکن است بخواهید از این موارد اجتناب کنید." msgid "For :const:`AF_INET6` address family, a four-tuple ``(host, port, flowinfo, scope_id)`` is used, where *flowinfo* and *scope_id* represent the ``sin6_flowinfo`` and ``sin6_scope_id`` members in :const:`struct sockaddr_in6` in C. For :mod:`!socket` module methods, *flowinfo* and *scope_id* can be omitted just for backward compatibility. Note, however, omission of *scope_id* can cause problems in manipulating scoped IPv6 addresses." -msgstr "برای خانواده‌ی آدرس :const:`AF_INET6`، از یک چهارتایی ``(host, port, flowinfo, scope_id)`` استفاده می‌شود، که در آن *flowinfo* و *scope_id* نشان‌دهنده‌ی اعضای ``sin6_flowinfo`` و ``sin6_scope_id`` در :const:`struct sockaddr_in6` در C هستند. برای متدهای ماژول :mod:`!socket`، می‌توان *flowinfo* و *scope_id* را فقط برای سازگاری با نسخه‌های پیشین حذف کرد. با این حال توجه داشته باشید که حذف *scope_id* می‌تواند در کار با آدرس‌های IPv6 محدوده‌دار مشکل‌ساز شود." +msgstr "برای خانواده‌ی آدرس :const:`AF_INET6`، از یک چهارتایی ``(host, port, flowinfo, scope_id)`` استفاده می‌شود، که در آن \*flowinfo\* و \*scope_id\* نشان‌دهنده‌ی اعضای ``sin6_flowinfo`` و ``sin6_scope_id`` در :const:`struct sockaddr_in6` در C هستند. برای متدهای ماژول :mod:`!socket`، می‌توان \*flowinfo\* و \*scope_id\* را فقط برای سازگاری با نسخه‌های پیشین حذف کرد. با این حال توجه داشته باشید که حذف \*scope_id\* می‌تواند در کار با آدرس‌های IPv6 محدوده‌دار مشکل‌ساز شود." msgid "For multicast addresses (with *scope_id* meaningful) *address* may not contain ``%scope_id`` (or ``zone id``) part. This information is superfluous and may be safely omitted (recommended)." -msgstr "برای آدرس‌های چندپخشی (multicast)، که در آن‌ها *scope_id* معنادار است، لازم نیست *address* شامل بخش ``%scope_id`` (یا ``zone id``) باشد. این اطلاعات اضافی است و می‌توان با اطمینان آن را حذف کرد (توصیه می‌شود)." +msgstr "برای آدرس‌های چندپخشی (multicast)، که در آن‌ها \*scope_id\* معنادار است، لازم نیست \*address\* شامل بخش ``%scope_id`` (یا ``zone id``) باشد. این اطلاعات اضافی است و می‌توان با اطمینان آن را حذف کرد (توصیه می‌شود)." msgid ":const:`AF_NETLINK` sockets are represented as pairs ``(pid, groups)``." msgstr "سوکت‌های :const:`AF_NETLINK` به‌صورت جفت‌های ``(pid, groups)`` نمایش داده می‌شوند." @@ -96,22 +96,22 @@ msgid "Linux-only support for TIPC is available using the :const:`AF_TIPC` addre msgstr "پشتیبانی از TIPC فقط در لینوکس، با استفاده از خانواده‌ی نشانی :const:`AF_TIPC` در دسترس است. TIPC یک پروتکل شبکه‌ای باز و غیرمبتنی بر IP است که برای استفاده در محیط‌های رایانه‌ای خوشه‌ای طراحی شده است. نشانی‌ها به‌صورت یک تاپل نمایش داده می‌شوند و فیلدها به نوع نشانی بستگی دارند. قالب کلی تاپل به‌صورت ``(addr_type, v1, v2, v3 [, scope])`` است، که در آن:" msgid "*addr_type* is one of :const:`TIPC_ADDR_NAMESEQ`, :const:`TIPC_ADDR_NAME`, or :const:`TIPC_ADDR_ID`." -msgstr "*addr_type* یکی از :const:`TIPC_ADDR_NAMESEQ`، :const:`TIPC_ADDR_NAME` یا :const:`TIPC_ADDR_ID` است." +msgstr "\*addr_type\* یکی از :const:`TIPC_ADDR_NAMESEQ`، :const:`TIPC_ADDR_NAME` یا :const:`TIPC_ADDR_ID` است." msgid "*scope* is one of :const:`TIPC_ZONE_SCOPE`, :const:`TIPC_CLUSTER_SCOPE`, and :const:`TIPC_NODE_SCOPE`." -msgstr "*scope* یکی از :const:`TIPC_ZONE_SCOPE`، :const:`TIPC_CLUSTER_SCOPE` و :const:`TIPC_NODE_SCOPE` است." +msgstr "\*scope\* یکی از :const:`TIPC_ZONE_SCOPE`، :const:`TIPC_CLUSTER_SCOPE` و :const:`TIPC_NODE_SCOPE` است." msgid "If *addr_type* is :const:`TIPC_ADDR_NAME`, then *v1* is the server type, *v2* is the port identifier, and *v3* should be 0." -msgstr "اگر *addr_type* برابر :const:`TIPC_ADDR_NAME` باشد، آنگاه *v1* نوع سرور است، *v2* شناسه درگاه است و *v3* باید ۰ باشد." +msgstr "اگر \*addr_type\* برابر :const:`TIPC_ADDR_NAME` باشد، آنگاه \*v1\* نوع سرور است، \*v2\* شناسه درگاه است و \*v3\* باید ۰ باشد." msgid "If *addr_type* is :const:`TIPC_ADDR_NAMESEQ`, then *v1* is the server type, *v2* is the lower port number, and *v3* is the upper port number." -msgstr "اگر *addr_type* برابر با :const:`TIPC_ADDR_NAMESEQ` باشد، آنگاه *v1* نوع سرور، *v2* شماره پورت پایینی و *v3* شماره پورت بالایی است." +msgstr "اگر \*addr_type\* برابر با :const:`TIPC_ADDR_NAMESEQ` باشد، آنگاه \*v1\* نوع سرور، \*v2\* شماره پورت پایینی و \*v3\* شماره پورت بالایی است." msgid "If *addr_type* is :const:`TIPC_ADDR_ID`, then *v1* is the node, *v2* is the reference, and *v3* should be set to 0." -msgstr "اگر *addr_type* برابر :const:`TIPC_ADDR_ID` باشد، آنگاه *v1* گره است، *v2* مرجع است و *v3* باید روی ۰ تنظیم شود." +msgstr "اگر \*addr_type\* برابر :const:`TIPC_ADDR_ID` باشد، آنگاه \*v1\* گره است، \*v2\* مرجع است و \*v3\* باید روی ۰ تنظیم شود." msgid "A tuple ``(interface, )`` is used for the :const:`AF_CAN` address family, where *interface* is a string representing a network interface name like ``'can0'``. The network interface name ``''`` can be used to receive packets from all network interfaces of this family." -msgstr "از یک تاپل ``(interface, )`` برای خانواده آدرس :const:`AF_CAN` استفاده می‌شود، که در آن *interface* رشته‌ای است که نام یک رابط شبکه مانند ``'can0'`` را نشان می‌دهد. می‌توان از نام رابط شبکه ``''`` برای دریافت بسته‌ها از تمام رابط‌های شبکه این خانواده استفاده کرد." +msgstr "از یک تاپل ``(interface, )`` برای خانواده آدرس :const:`AF_CAN` استفاده می‌شود، که در آن \*interface\* رشته‌ای است که نام یک رابط شبکه مانند ``'can0'`` را نشان می‌دهد. می‌توان از نام رابط شبکه ``''`` برای دریافت بسته‌ها از تمام رابط‌های شبکه این خانواده استفاده کرد." msgid ":const:`CAN_ISOTP` protocol requires a tuple ``(interface, rx_addr, tx_addr)`` where both additional parameters are unsigned long integer that represent a CAN identifier (standard or extended)." msgstr "پروتکل :const:`CAN_ISOTP` به یک تاپلبه صورت ``(interface, rx_addr, tx_addr)`` نیاز دارد، که در آن هر دو پارامتر اضافی، عدد صحیح بلند بدون علامت هستند و یک شناسه CAN (استاندارد یا گسترده) را نشان می‌دهند." @@ -171,13 +171,13 @@ msgid ":const:`AF_ALG` is a Linux-only socket based interface to Kernel cryptogr msgstr ":const:`AF_ALG` یک رابط مبتنی بر سوکت و فقط مخصوص لینوکس برای رمزنگاری هسته است. یک سوکت الگوریتم با یک تاپل شامل دو تا چهار المان ``(type, name [, feat [, mask]])`` پیکربندی می‌شود، که در آن:" msgid "*type* is the algorithm type as string, e.g. ``aead``, ``hash``, ``skcipher`` or ``rng``." -msgstr "*type* نوع الگوریتم به‌صورت رشته است، مثلاً ``aead``، ``hash``، ``skcipher`` یا ``rng``." +msgstr "\*type\* نوع الگوریتم به‌صورت رشته است، مثلاً ``aead``، ``hash``، ``skcipher`` یا ``rng``." msgid "*name* is the algorithm name and operation mode as string, e.g. ``sha256``, ``hmac(sha256)``, ``cbc(aes)`` or ``drbg_nopr_ctr_aes256``." -msgstr "*name* نام الگوریتم و حالت عملکرد به‌صورت رشته است، برای مثال ``sha256``، ``hmac(sha256)``، ``cbc(aes)`` یا ``drbg_nopr_ctr_aes256``." +msgstr "\*name\* نام الگوریتم و حالت عملکرد به‌صورت رشته است، برای مثال ``sha256``، ``hmac(sha256)``، ``cbc(aes)`` یا ``drbg_nopr_ctr_aes256``." msgid "*feat* and *mask* are unsigned 32bit integers." -msgstr "*feat* و *mask* اعداد صحیح ۳۲ بیتی بدون علامت هستند." +msgstr "\*feat\* و \*mask\* اعداد صحیح ۳۲ بیتی بدون علامت هستند." msgid "Some algorithm types require more recent Kernels." msgstr "برخی از انواع الگوریتم به هسته‌های جدیدتر نیاز دارند." @@ -192,13 +192,13 @@ msgid ":const:`AF_PACKET` is a low-level interface directly to network devices. msgstr ":const:`AF_PACKET` یک رابط سطح پایین برای دسترسی مستقیم به دستگاه‌های شبکه است. نشانی‌ها به‌صورت تاپل ``(ifname, proto[, pkttype[, hatype[, addr]]])`` نمایش داده می‌شوند که در آن:" msgid "*ifname* - String specifying the device name." -msgstr "*ifname* - رشته‌ای که نام دستگاه را مشخص می‌کند." +msgstr "\*ifname\* - رشته‌ای که نام دستگاه را مشخص می‌کند." msgid "*proto* - The Ethernet protocol number. May be :data:`ETH_P_ALL` to capture all protocols, one of the :ref:`ETHERTYPE_* constants ` or any other Ethernet protocol number." -msgstr "*proto* - شماره‌ی پروتکل اترنت. می‌تواند :data:`ETH_P_ALL` برای ضبط تمام پروتکل‌ها، یکی از :ref:`ثابت‌های ETHERTYPE_* ` یا هر شماره‌ی پروتکل اترنت دیگری باشد." +msgstr "\*proto\* - شماره‌ی پروتکل اترنت. می‌تواند :data:`ETH_P_ALL` برای ضبط تمام پروتکل‌ها، یکی از :ref:`ثابت‌های ETHERTYPE_\* ` یا هر شماره‌ی پروتکل اترنت دیگری باشد." msgid "*pkttype* - Optional integer specifying the packet type:" -msgstr "*pkttype* - عدد صحیح اختیاری برای مشخص کردن نوع بسته:" +msgstr "\*pkttype\* - عدد صحیح اختیاری برای مشخص کردن نوع بسته:" msgid "``PACKET_HOST`` (the default) - Packet addressed to the local host." msgstr "``PACKET_HOST`` (پیش‌فرض) - بسته‌ای که مقصد آن میزبان محلی است." @@ -216,13 +216,13 @@ msgid "``PACKET_OUTGOING`` - Packet originating from the local host that is loop msgstr "``PACKET_OUTGOING`` - بسته‌ای که از میزبان محلی سرچشمه می‌گیرد و به یک سوکت بسته (packet socket) حلقه می‌شود." msgid "*hatype* - Optional integer specifying the ARP hardware address type." -msgstr "*hatype* - عدد صحیح اختیاری برای مشخص کردن نوع نشانی سخت‌افزاری ARP." +msgstr "\*hatype\* - عدد صحیح اختیاری برای مشخص کردن نوع نشانی سخت‌افزاری ARP." msgid "*addr* - Optional bytes-like object specifying the hardware physical address, whose interpretation depends on the device." -msgstr "*addr* - شیء اختیاری ماننده بایت (bytes-like object) که آدرس فیزیکی سخت‌افزار را مشخص می‌کند و تفسیر آن به دستگاه بستگی دارد." +msgstr "\*addr\* - شیء اختیاری ماننده بایت (bytes-like object) که آدرس فیزیکی سخت‌افزار را مشخص می‌کند و تفسیر آن به دستگاه بستگی دارد." msgid ":const:`AF_QIPCRTR` is a Linux-only socket based interface for communicating with services running on co-processors in Qualcomm platforms. The address family is represented as a ``(node, port)`` tuple where the *node* and *port* are non-negative integers." -msgstr ":const:`AF_QIPCRTR` یک رابط مبتنی بر سوکت، فقط مخصوص لینوکس، برای ارتباط با سرویس‌هایی است که روی پردازنده‌های کمکی در پلتفرم‌های Qualcomm اجرا می‌شوند. این خانواده آدرس به‌صورت یک تاپل ``(node, port)`` نمایش داده می‌شود که در آن *node* و *port* اعداد صحیح نامنفی هستند." +msgstr ":const:`AF_QIPCRTR` یک رابط مبتنی بر سوکت، فقط مخصوص لینوکس، برای ارتباط با سرویس‌هایی است که روی پردازنده‌های کمکی در پلتفرم‌های Qualcomm اجرا می‌شوند. این خانواده آدرس به‌صورت یک تاپل ``(node, port)`` نمایش داده می‌شود که در آن \*node\* و \*port\* اعداد صحیح نامنفی هستند." msgid ":const:`IPPROTO_UDPLITE` is a variant of UDP which allows you to specify what portion of a packet is covered with the checksum. It adds two socket options that you can change. ``self.setsockopt(IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV, length)`` will change what portion of outgoing packets are covered by the checksum and ``self.setsockopt(IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV, length)`` will filter out packets which cover too little of their data. In both cases ``length`` should be in ``range(8, 2**16, 8)``." msgstr ":const:`IPPROTO_UDPLITE` گونه‌ای از UDP است که به شما اجازه می‌دهد مشخص کنید چه بخشی از یک بسته تحت پوشش جمع‌آزما (checksum) قرار می‌گیرد. این پروتکل دو گزینه‌ی سوکت اضافه می‌کند که می‌توانید آن‌ها را تغییر دهید. ``self.setsockopt(IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV, length)`` میزان پوشش جمع‌آزما برای بسته‌های خروجی را تغییر می‌دهد و ``self.setsockopt(IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV, length)`` بسته‌هایی را که بخش خیلی کمی از داده‌هایشان تحت پوشش جمع‌آزما قرار می‌گیرد فیلتر می‌کند. در هر دو حالت ``length`` باید در ``range(8, 2**16, 8)`` باشد." @@ -258,7 +258,7 @@ msgid "The ``service_id`` is the service identifier of the registered service." msgstr "``service_id`` شناسه‌ی سرویس ثبت‌شده است." msgid "If you use a hostname in the *host* portion of IPv4/v6 socket address, the program may show a nondeterministic behavior, as Python uses the first address returned from the DNS resolution. The socket address will be resolved differently into an actual IPv4/v6 address, depending on the results from DNS resolution and/or the host configuration. For deterministic behavior use a numeric address in *host* portion." -msgstr "اگر در بخش *host* نشانی سوکت IPv4/v6 از یک نام میزبان استفاده کنید، ممکن است برنامه رفتاری غیرقطعی نشان دهد، زیرا پایتون از اولین نشانی بازگشتی از حل DNS استفاده می‌کند. نشانی سوکت بسته به نتایج حل DNS و/یا پیکربندی میزبان، به‌شکل متفاوتی به یک نشانی IPv4/v6 واقعی حل می‌شود. برای رفتار قطعی، از یک نشانی عددی در بخش *host* استفاده کنید." +msgstr "اگر در بخش \*host\* نشانی سوکت IPv4/v6 از یک نام میزبان استفاده کنید، ممکن است برنامه رفتاری غیرقطعی نشان دهد، زیرا پایتون از اولین نشانی بازگشتی از حل DNS استفاده می‌کند. نشانی سوکت بسته به نتایج حل DNS و/یا پیکربندی میزبان، به‌شکل متفاوتی به یک نشانی IPv4/v6 واقعی حل می‌شود. برای رفتار قطعی، از یک نشانی عددی در بخش \*host\* استفاده کنید." msgid "All errors raise exceptions. The normal exceptions for invalid argument types and out-of-memory conditions can be raised. Errors related to socket or address semantics raise :exc:`OSError` or one of its subclasses." msgstr "همه‌ی خطاها استثنا پرتاب می‌کنند. استثناهای معمول برای انواع نامعتبر آرگومان و شرایط کمبود حافظه ممکن است پرتاب شوند. خطاهای مربوط به معنای سوکت یا آدرس، :exc:`OSError` یا یکی از زیرکلاس‌های آن را پرتاب می‌کنند." @@ -282,13 +282,13 @@ msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`." msgstr "پیرو :pep:`3151`، این کلاس به نام مستعار :exc:`OSError` تبدیل شد." msgid "A subclass of :exc:`OSError`, this exception is raised for address-related errors, i.e. for functions that use *h_errno* in the POSIX C API, including :func:`gethostbyname_ex` and :func:`gethostbyaddr`. The accompanying value is a pair ``(h_errno, string)`` representing an error returned by a library call. *h_errno* is a numeric value, while *string* represents the description of *h_errno*, as returned by the :c:func:`hstrerror` C function." -msgstr "این استثنا که زیرکلاسی از :exc:`OSError` است، برای خطاهای مرتبط با نشانی پرتاب می‌شود، یعنی برای توابعی که از *h_errno* در API C POSIX استفاده می‌کنند، از جمله :func:`gethostbyname_ex` و :func:`gethostbyaddr`. مقدار همراه، یک جفت ``(h_errno, string)`` است که نشان‌دهنده‌ی خطایی است که توسط یک فراخوانی کتابخانه برگردانده شده است. *h_errno* یک مقدار عددی است، در حالی که *string* بیانگر توضیح *h_errno* است، همان‌طور که توسط تابع C :c:func:`hstrerror` برگردانده می‌شود." +msgstr "این استثنا که زیرکلاسی از :exc:`OSError` است، برای خطاهای مرتبط با نشانی پرتاب می‌شود، یعنی برای توابعی که از \*h_errno\* در API C POSIX استفاده می‌کنند، از جمله :func:`gethostbyname_ex` و :func:`gethostbyaddr`. مقدار همراه، یک جفت ``(h_errno, string)`` است که نشان‌دهنده‌ی خطایی است که توسط یک فراخوانی کتابخانه برگردانده شده است. \*h_errno\* یک مقدار عددی است، در حالی که \*string\* بیانگر توضیح \*h_errno\* است، همان‌طور که توسط تابع C :c:func:`hstrerror` برگردانده می‌شود." msgid "This class was made a subclass of :exc:`OSError`." msgstr "این کلاس به زیرکلاسی از :exc:`OSError` تبدیل شد." msgid "A subclass of :exc:`OSError`, this exception is raised for address-related errors by :func:`getaddrinfo` and :func:`getnameinfo`. The accompanying value is a pair ``(error, string)`` representing an error returned by a library call. *string* represents the description of *error*, as returned by the :c:func:`gai_strerror` C function. The numeric *error* value will match one of the :const:`!EAI_\\*` constants defined in this module." -msgstr "این استثنا زیرکلاسی از :exc:`OSError` است و برای خطاهای مرتبط با نشانی توسط :func:`getaddrinfo` و :func:`getnameinfo` پرتاب می‌شود. مقدار همراه آن یک جفت ``(error, string)`` است که نشان‌دهنده‌ی خطایی است که از یک فراخوانی کتابخانه برگردانده شده است. *string* شرح *error* را نشان می‌دهد، همان‌طور که توسط تابع C :c:func:`gai_strerror` برگردانده شده است. مقدار عددی *error* با یکی از ثابت‌های :const:`!EAI_\\*` تعریف‌شده در این ماژول مطابقت خواهد داشت." +msgstr "این استثنا زیرکلاسی از :exc:`OSError` است و برای خطاهای مرتبط با نشانی توسط :func:`getaddrinfo` و :func:`getnameinfo` پرتاب می‌شود. مقدار همراه آن یک جفت ``(error, string)`` است که نشان‌دهنده‌ی خطایی است که از یک فراخوانی کتابخانه برگردانده شده است. \*string\* شرح \*error\* را نشان می‌دهد، همان‌طور که توسط تابع C :c:func:`gai_strerror` برگردانده شده است. مقدار عددی \*error\* با یکی از ثابت‌های :const:`!EAI_\\*` تعریف‌شده در این ماژول مطابقت خواهد داشت." msgid "A deprecated alias of :exc:`TimeoutError`." msgstr "یک نام مستعار منسوخ برای :exc:`TimeoutError`." @@ -303,7 +303,7 @@ msgid "Constants" msgstr "ثابت‌ها" msgid "The AF_* and SOCK_* constants are now :class:`AddressFamily` and :class:`SocketKind` :class:`.IntEnum` collections." -msgstr "ثابت‌های AF_* و SOCK_* اکنون مجموعه‌های :class:`AddressFamily` و :class:`SocketKind` از نوع :class:`.IntEnum` هستند." +msgstr "ثابت‌های AF\_\* و SOCK\_\* اکنون مجموعه‌های :class:`AddressFamily` و :class:`SocketKind` از نوع :class:`.IntEnum` هستند." msgid "These constants represent the address (and protocol) families, used for the first argument to :func:`~socket.socket`. If the :const:`AF_UNIX` constant is not defined then this protocol is unsupported. More constants may be available depending on the system." msgstr "این ثابت‌ها نشان‌دهنده‌ی خانواده‌های آدرس (و پروتکل) هستند و برای اولین آرگومان :func:`~socket.socket` استفاده می‌شوند. اگر ثابت :const:`AF_UNIX` تعریف نشده باشد، این پروتکل پشتیبانی نمی‌شود. بسته به سیستم، ممکن است ثابت‌های بیشتری در دسترس باشند." @@ -492,31 +492,31 @@ msgid "Windows support added." msgstr "پشتیبانی از ویندوز اضافه شد." msgid "Connect to a TCP service listening on the internet *address* (a 2-tuple ``(host, port)``), and return the socket object. This is a higher-level function than :meth:`socket.connect`: if *host* is a non-numeric hostname, it will try to resolve it for both :data:`AF_INET` and :data:`AF_INET6`, and then try to connect to all possible addresses in turn until a connection succeeds. This makes it easy to write clients that are compatible to both IPv4 and IPv6." -msgstr "به یک سرویس TCP که به *نشانی* اینترنتی (یک دوتایی (2-tuple) به شکل ``(host, port)``) گوش می‌دهد متصل می‌شود و شیء سوکت را برمی‌گرداند. این تابع سطح بالاتری نسبت به :meth:`socket.connect` است: اگر *host* یک نام میزبان غیرعددی باشد، تلاش می‌کند آن را برای هر دو :data:`AF_INET` و :data:`AF_INET6` حل کند و سپس تلاش می‌کند به‌ترتیب به تمام نشانی‌های ممکن متصل شود تا اتصالی با موفقیت برقرار شود. این کار نوشتن کلاینت‌هایی را که با هر دو IPv4 و IPv6 سازگار باشند، آسان می‌کند." +msgstr "به یک سرویس TCP که به \*نشانی\* اینترنتی (یک دوتایی (2-tuple) به شکل ``(host, port)``) گوش می‌دهد متصل می‌شود و شیء سوکت را برمی‌گرداند. این تابع سطح بالاتری نسبت به :meth:`socket.connect` است: اگر \*host\* یک نام میزبان غیرعددی باشد، تلاش می‌کند آن را برای هر دو :data:`AF_INET` و :data:`AF_INET6` حل کند و سپس تلاش می‌کند به‌ترتیب به تمام نشانی‌های ممکن متصل شود تا اتصالی با موفقیت برقرار شود. این کار نوشتن کلاینت‌هایی را که با هر دو IPv4 و IPv6 سازگار باشند، آسان می‌کند." msgid "Passing the optional *timeout* parameter will set the timeout on the socket instance before attempting to connect. If no *timeout* is supplied, the global default timeout setting returned by :func:`getdefaulttimeout` is used." -msgstr "با ارسال پارامتر اختیاری *timeout*، مهلت روی نمونه سوکت پیش از تلاش برای اتصال تنظیم می‌شود. اگر *timeout* ارائه نشود، از تنظیم مهلت پیش‌فرض سراسری که توسط :func:`getdefaulttimeout` برگردانده می‌شود، استفاده خواهد شد." +msgstr "با ارسال پارامتر اختیاری \*timeout\*، مهلت روی نمونه سوکت پیش از تلاش برای اتصال تنظیم می‌شود. اگر \*timeout\* ارائه نشود، از تنظیم مهلت پیش‌فرض سراسری که توسط :func:`getdefaulttimeout` برگردانده می‌شود، استفاده خواهد شد." msgid "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the socket to bind to as its source address before connecting. If host or port are '' or 0 respectively the OS default behavior will be used." -msgstr "اگر ارائه شود، *source_address* باید یک تاپل دوتایی (2-tuple) به‌صورت ``(host, port)`` باشد تا سوکت پیش از اتصال، آن را به‌عنوان نشانی مبدأ خود مقید کند . اگر host یا port به‌ترتیب '' یا 0 باشند، رفتار پیش‌فرض سیستم‌عامل استفاده خواهد شد." +msgstr "اگر ارائه شود، \*source_address\* باید یک تاپل دوتایی (2-tuple) به‌صورت ``(host, port)`` باشد تا سوکت پیش از اتصال، آن را به‌عنوان نشانی مبدأ خود مقید کند . اگر host یا port به‌ترتیب '' یا 0 باشند، رفتار پیش‌فرض سیستم‌عامل استفاده خواهد شد." msgid "When a connection cannot be created, an exception is raised. By default, it is the exception from the last address in the list. If *all_errors* is ``True``, it is an :exc:`ExceptionGroup` containing the errors of all attempts." -msgstr "هنگامی که ایجاد یک اتصال ممکن نباشد، یک استثنا پرتاب می‌شود. به‌طور پیش‌فرض، این استثنا مربوط به آخرین نشانی در فهرست است. اگر *all_errors* برابر ``True`` باشد، یک :exc:`ExceptionGroup` حاوی خطاهای تمام تلاش‌ها خواهد بود." +msgstr "هنگامی که ایجاد یک اتصال ممکن نباشد، یک استثنا پرتاب می‌شود. به‌طور پیش‌فرض، این استثنا مربوط به آخرین نشانی در فهرست است. اگر \*all_errors\* برابر ``True`` باشد، یک :exc:`ExceptionGroup` حاوی خطاهای تمام تلاش‌ها خواهد بود." msgid "*source_address* was added." -msgstr "*source_address* اضافه شد." +msgstr "\*source_address\* اضافه شد." msgid "*all_errors* was added." -msgstr "*all_errors* افزوده شد." +msgstr "\*all_errors\* افزوده شد." msgid "Convenience function which creates a TCP socket bound to *address* (a 2-tuple ``(host, port)``) and returns the socket object." -msgstr "تابع سهولت‌بخشی که یک سوکت TCP مقید به *address* (یک ۲-تایی ``(host, port)``) را ایجاد می‌کند و شیء سوکت را برمی‌گرداند." +msgstr "تابع سهولت‌بخشی که یک سوکت TCP مقید به \*address\* (یک ۲-تایی ``(host, port)``) را ایجاد می‌کند و شیء سوکت را برمی‌گرداند." msgid "*family* should be either :data:`AF_INET` or :data:`AF_INET6`. *backlog* is the queue size passed to :meth:`socket.listen`; if not specified , a default reasonable value is chosen. *reuse_port* dictates whether to set the :data:`SO_REUSEPORT` socket option." -msgstr "*family* باید یکی از :data:`AF_INET` یا :data:`AF_INET6` باشد. *backlog* اندازه صفی است که به :meth:`socket.listen` داده می‌شود؛ اگر مشخص نشده باشد، یک مقدار پیش‌فرض مناسب انتخاب می‌شود. *reuse_port* تعیین می‌کند که آیا گزینه سوکت :data:`SO_REUSEPORT` تنظیم شود یا خیر." +msgstr "\*family\* باید یکی از :data:`AF_INET` یا :data:`AF_INET6` باشد. \*backlog\* اندازه صفی است که به :meth:`socket.listen` داده می‌شود؛ اگر مشخص نشده باشد، یک مقدار پیش‌فرض مناسب انتخاب می‌شود. \*reuse_port\* تعیین می‌کند که آیا گزینه سوکت :data:`SO_REUSEPORT` تنظیم شود یا خیر." msgid "If *dualstack_ipv6* is true, *family* is :data:`AF_INET6` and the platform supports it the socket will be able to accept both IPv4 and IPv6 connections, else it will raise :exc:`ValueError`. Most POSIX platforms and Windows are supposed to support this functionality. When this functionality is enabled the address returned by :meth:`socket.getpeername` when an IPv4 connection occurs will be an IPv6 address represented as an IPv4-mapped IPv6 address. If *dualstack_ipv6* is false it will explicitly disable this functionality on platforms that enable it by default (e.g. Linux). This parameter can be used in conjunction with :func:`has_dualstack_ipv6`:" -msgstr "اگر *dualstack_ipv6* درست باشد، *family* برابر با :data:`AF_INET6` باشد و سکو از آن پشتیبانی کند، سوکت می‌تواند هر دو اتصال IPv4 و IPv6 را بپذیرد؛ در غیر این صورت، استثنای :exc:`ValueError` پرتاب می‌شود. انتظار می‌رود بیشتر سکوهای POSIX و ویندوز از این قابلیت پشتیبانی کنند. هنگامی که این قابلیت فعال باشد، آدرس برگردانده‌شده توسط :meth:`socket.getpeername` در صورت وقوع یک اتصال IPv4، یک آدرس IPv6 خواهد بود که به‌صورت آدرس IPv6 نگاشت‌شده به IPv4 (IPv4-mapped IPv6 address) نمایش داده می‌شود. اگر *dualstack_ipv6* نادرست باشد، این قابلیت در سکوهای که آن را به‌طور پیش‌فرض فعال می‌کنند (مانند لینوکس) به‌صراحت غیرفعال می‌شود. این پارامتر می‌تواند همراه با :func:`has_dualstack_ipv6` استفاده شود:" +msgstr "اگر \*dualstack_ipv6\* درست باشد، \*family\* برابر با :data:`AF_INET6` باشد و سکو از آن پشتیبانی کند، سوکت می‌تواند هر دو اتصال IPv4 و IPv6 را بپذیرد؛ در غیر این صورت، استثنای :exc:`ValueError` پرتاب می‌شود. انتظار می‌رود بیشتر سکوهای POSIX و ویندوز از این قابلیت پشتیبانی کنند. هنگامی که این قابلیت فعال باشد، آدرس برگردانده‌شده توسط :meth:`socket.getpeername` در صورت وقوع یک اتصال IPv4، یک آدرس IPv6 خواهد بود که به‌صورت آدرس IPv6 نگاشت‌شده به IPv4 (IPv4-mapped IPv6 address) نمایش داده می‌شود. اگر \*dualstack_ipv6\* نادرست باشد، این قابلیت در سکوهای که آن را به‌طور پیش‌فرض فعال می‌کنند (مانند لینوکس) به‌صراحت غیرفعال می‌شود. این پارامتر می‌تواند همراه با :func:`has_dualstack_ipv6` استفاده شود:" msgid "" "import socket\n" @@ -536,13 +536,13 @@ msgstr "" " s = socket.create_server(addr)" msgid "On POSIX platforms the :data:`SO_REUSEADDR` socket option is set in order to immediately reuse previous sockets which were bound on the same *address* and remained in TIME_WAIT state." -msgstr "در پلتفرم‌های POSIX، گزینه‌ی سوکت :data:`SO_REUSEADDR` تنظیم می‌شود تا امکان استفاده‌ی فوری از سوکت‌های پیشینی که به همان *آدرس* پیوند داده شده‌اند و در وضعیت TIME_WAIT باقی مانده‌اند، فراهم شود." +msgstr "در پلتفرم‌های POSIX، گزینه‌ی سوکت :data:`SO_REUSEADDR` تنظیم می‌شود تا امکان استفاده‌ی فوری از سوکت‌های پیشینی که به همان \*آدرس\* پیوند داده شده‌اند و در وضعیت TIME_WAIT باقی مانده‌اند، فراهم شود." msgid "Return ``True`` if the platform supports creating a TCP socket which can handle both IPv4 and IPv6 connections." msgstr "اگر سکو از ایجاد یک سوکت TCP که بتواند هر دو اتصال IPv4 و IPv6 را مدیریت کند پشتیبانی کند، ``True`` را برمی‌گرداند." msgid "Duplicate the file descriptor *fd* (an integer as returned by a file object's :meth:`~io.IOBase.fileno` method) and build a socket object from the result. Address family, socket type and protocol number are as for the :func:`~socket.socket` function. The file descriptor should refer to a socket, but this is not checked --- subsequent operations on the object may fail if the file descriptor is invalid. This function is rarely needed, but can be used to get or set socket options on a socket passed to a program as standard input or output (such as a server started by the Unix inet daemon). The socket is assumed to be in blocking mode." -msgstr "توصیف‌گر پرونده *fd* (یک عدد صحیح که توسط متد :meth:`~io.IOBase.fileno` یک شیء پرونده برگردانده می‌شود) تکثیر می‌شود و از نتیجه، یک شیء سوکت ساخته می‌شود. خانواده آدرس، نوع سوکت و شماره پروتکل همانند تابع :func:`~socket.socket` هستند. توصیف‌گر پرونده باید به یک سوکت ارجاع دهد، اما این موضوع بررسی نمی‌شود --- عملیات‌های بعدی روی شیء ممکن است در صورت نامعتبر بودن توصیف‌گر پرونده با شکست مواجه شوند. این تابع به‌ندرت مورد نیاز است، اما می‌توان از آن برای دریافت یا تنظیم گزینه‌های سوکت روی سوکتی که به‌عنوان ورودی یا خروجی استاندارد به برنامه داده شده است استفاده کرد (مانند سروری که توسط دیمن inet در یونیکس راه‌اندازی شده است). فرض می‌شود سوکت در حالت مسدودکننده قرار دارد." +msgstr "توصیف‌گر پرونده \*fd\* (یک عدد صحیح که توسط متد :meth:`~io.IOBase.fileno` یک شیء پرونده برگردانده می‌شود) تکثیر می‌شود و از نتیجه، یک شیء سوکت ساخته می‌شود. خانواده آدرس، نوع سوکت و شماره پروتکل همانند تابع :func:`~socket.socket` هستند. توصیف‌گر پرونده باید به یک سوکت ارجاع دهد، اما این موضوع بررسی نمی‌شود --- عملیات‌های بعدی روی شیء ممکن است در صورت نامعتبر بودن توصیف‌گر پرونده با شکست مواجه شوند. این تابع به‌ندرت مورد نیاز است، اما می‌توان از آن برای دریافت یا تنظیم گزینه‌های سوکت روی سوکتی که به‌عنوان ورودی یا خروجی استاندارد به برنامه داده شده است استفاده کرد (مانند سروری که توسط دیمن inet در یونیکس راه‌اندازی شده است). فرض می‌شود سوکت در حالت مسدودکننده قرار دارد." msgid "The newly created socket is :ref:`non-inheritable `." msgstr "سوکت تازه‌ایجادشده :ref:`غیرقابل ارث‌بری ` است." @@ -566,10 +566,10 @@ msgid "This function wraps the C function ``getaddrinfo`` of the underlying syst msgstr "این تابع، پوششی برای تابع ``getaddrinfo`` زبان C در سیستم زیرین است." msgid "Translate the *host*/*port* argument into a sequence of 5-tuples that contain all the necessary arguments for creating a socket connected to that service. *host* is a domain name, a string representation of an IPv4/v6 address or ``None``. *port* is a string service name such as ``'http'``, a numeric port number or ``None``. By passing ``None`` as the value of *host* and *port*, you can pass ``NULL`` to the underlying C API." -msgstr "آرگومان *host*/*port* را به دنباله‌ای از تاپل‌های ۵تایی تبدیل می‌کند که شامل همه آرگومان‌های لازم برای ایجاد سوکتی متصل به آن سرویس است. *host* یک نام دامنه، نمایش رشته‌ای از یک آدرس IPv4/v6 یا ``None`` است. *port* یک نام سرویس رشته‌ای مانند ``'http'``، یک شماره پورت عددی یا ``None`` است. با ارسال ``None`` به‌عنوان مقدار *host* و *port*، می‌توانید ``NULL`` را به API زیربنایی C ارسال کنید." +msgstr "آرگومان \*host\*/\*port\* را به دنباله‌ای از تاپل‌های ۵تایی تبدیل می‌کند که شامل همه آرگومان‌های لازم برای ایجاد سوکتی متصل به آن سرویس است. \*host\* یک نام دامنه، نمایش رشته‌ای از یک آدرس IPv4/v6 یا ``None`` است. \*port\* یک نام سرویس رشته‌ای مانند ``'http'``، یک شماره پورت عددی یا ``None`` است. با ارسال ``None`` به‌عنوان مقدار \*host\* و \*port\*، می‌توانید ``NULL`` را به API زیربنایی C ارسال کنید." msgid "The *family*, *type* and *proto* arguments can be optionally specified in order to provide options and limit the list of addresses returned. Pass their default values (:data:`AF_UNSPEC`, 0, and 0, respectively) to not limit the results. See the note below for details." -msgstr "آرگومان‌های *family*، *type* و *proto* را می‌توان به‌صورت اختیاری مشخص کرد تا گزینه‌ها فراهم شوند و فهرست نشانی‌های بازگردانده‌شده محدود شود. برای اینکه نتایج محدود نشوند، مقادیر پیش‌فرض آن‌ها (به‌ترتیب :data:`AF_UNSPEC`، 0 و 0) را ارسال کنید. برای جزئیات، یادداشت زیر را ببینید." +msgstr "آرگومان‌های \*family\*، \*type\* و \*proto\* را می‌توان به‌صورت اختیاری مشخص کرد تا گزینه‌ها فراهم شوند و فهرست نشانی‌های بازگردانده‌شده محدود شود. برای اینکه نتایج محدود نشوند، مقادیر پیش‌فرض آن‌ها (به‌ترتیب :data:`AF_UNSPEC`، 0 و 0) را ارسال کنید. برای جزئیات، یادداشت زیر را ببینید." msgid "The *flags* argument can be one or several of the ``AI_*`` constants, and will influence how results are computed and returned. For example, :const:`AI_NUMERICHOST` will disable domain name resolution and will raise an error if *host* is a domain name." msgstr "آرگومان *flags* می‌تواند یک یا چند مورد از ثابت‌های ``AI_*`` باشد و بر چگونگی محاسبه و برگرداندن نتایج تأثیر می‌گذارد. برای مثال، :const:`AI_NUMERICHOST` حل نام دامنه را غیرفعال می‌کند و اگر *host* یک نام دامنه باشد، خطایی پرتاب می‌کند." @@ -581,19 +581,19 @@ msgid "``(family, type, proto, canonname, sockaddr)``" msgstr "``(family, type, proto, canonname, sockaddr)``" msgid "In these tuples, *family*, *type*, *proto* are all integers and are meant to be passed to the :func:`~socket.socket` function. *canonname* will be a string representing the canonical name of the *host* if :const:`AI_CANONNAME` is part of the *flags* argument; else *canonname* will be empty. *sockaddr* is a tuple describing a socket address, whose format depends on the returned *family* (a ``(address, port)`` 2-tuple for :const:`AF_INET`, a ``(address, port, flowinfo, scope_id)`` 4-tuple for :const:`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." -msgstr "در این تاپل‌ها، *family*، *type* و *proto* همگی اعداد صحیح هستند و باید به تابع :func:`~socket.socket` فرستاده شوند. اگر :const:`AI_CANONNAME` بخشی از آرگومان *flags* باشد، *canonname* رشته‌ای خواهد بود که نام متعارف *host* را نشان می‌دهد؛ در غیر این صورت *canonname* خالی خواهد بود. *sockaddr* تاپلی است که نشانی سوکت را توصیف می‌کند و قالب آن به *family* برگردانده‌شده بستگی دارد (یک تاپل ۲تایی ``(address, port)`` برای :const:`AF_INET`، یک تاپل ۴تایی ``(address, port, flowinfo, scope_id)`` برای :const:`AF_INET6`) و باید به متد :meth:`socket.connect` فرستاده شود." +msgstr "در این تاپل‌ها، \*family\*، \*type\* و \*proto\* همگی اعداد صحیح هستند و باید به تابع :func:`~socket.socket` فرستاده شوند. اگر :const:`AI_CANONNAME` بخشی از آرگومان \*flags\* باشد، \*canonname\* رشته‌ای خواهد بود که نام متعارف \*host\* را نشان می‌دهد؛ در غیر این صورت \*canonname\* خالی خواهد بود. \*sockaddr\* تاپلی است که نشانی سوکت را توصیف می‌کند و قالب آن به \*family\* برگردانده‌شده بستگی دارد (یک تاپل ۲تایی ``(address, port)`` برای :const:`AF_INET`، یک تاپل ۴تایی ``(address, port, flowinfo, scope_id)`` برای :const:`AF_INET6`) و باید به متد :meth:`socket.connect` فرستاده شود." msgid "If you intend to use results from :func:`!getaddrinfo` to create a socket (rather than, for example, retrieve *canonname*), consider limiting the results by *type* (e.g. :data:`SOCK_STREAM` or :data:`SOCK_DGRAM`) and/or *proto* (e.g. :data:`IPPROTO_TCP` or :data:`IPPROTO_UDP`) that your application can handle." -msgstr "اگر قصد دارید از نتایج :func:`!getaddrinfo` برای ایجاد یک سوکت استفاده کنید (نه مثلاً برای بازیابی *canonname*)، در نظر بگیرید که نتایج را بر اساس *type* (مثلاً :data:`SOCK_STREAM` یا :data:`SOCK_DGRAM`) و/یا *proto* (مثلاً :data:`IPPROTO_TCP` یا :data:`IPPROTO_UDP`) که برنامه شما می‌تواند از آن‌ها پشتیبانی کند، محدود کنید." +msgstr "اگر قصد دارید از نتایج :func:`!getaddrinfo` برای ایجاد یک سوکت استفاده کنید (نه مثلاً برای بازیابی \*canonname\*)، در نظر بگیرید که نتایج را بر اساس \*type\* (مثلاً :data:`SOCK_STREAM` یا :data:`SOCK_DGRAM`) و/یا \*proto\* (مثلاً :data:`IPPROTO_TCP` یا :data:`IPPROTO_UDP`) که برنامه شما می‌تواند از آن‌ها پشتیبانی کند، محدود کنید." msgid "The behavior with default values of *family*, *type*, *proto* and *flags* is system-specific." -msgstr "رفتار با مقادیر پیش‌فرض *family*، *type*، *proto* و *flags* وابسته به سیستم است." +msgstr "رفتار با مقادیر پیش‌فرض \*family\*، \*type\*، \*proto\* و \*flags\* وابسته به سیستم است." msgid "Many systems (for example, most Linux configurations) will return a sorted list of all matching addresses. These addresses should generally be tried in order until a connection succeeds (possibly tried in parallel, for example, using a `Happy Eyeballs`_ algorithm). In these cases, limiting the *type* and/or *proto* can help eliminate unsuccessful or unusable connection attempts." -msgstr "بسیاری از سیستم‌ها (برای مثال، بیشتر پیکربندی‌های لینوکس) فهرست مرتب‌شده‌ای از همه‌ی نشانی‌های منطبق برمی‌گردانند. این نشانی‌ها معمولاً باید به‌ترتیب امتحان شوند تا اتصال با موفقیت برقرار شود (ممکن است به‌صورت موازی نیز امتحان شوند، برای مثال با استفاده از یک الگوریتم `Happy Eyeballs`_). در این موارد، محدود کردن *type* و/یا *proto* می‌تواند به حذف تلاش‌های اتصال بی‌نتیجه یا غیرقابل‌استفاده کمک کند." +msgstr "بسیاری از سیستم‌ها (برای مثال، بیشتر پیکربندی‌های لینوکس) فهرست مرتب‌شده‌ای از همه‌ی نشانی‌های منطبق برمی‌گردانند. این نشانی‌ها معمولاً باید به‌ترتیب امتحان شوند تا اتصال با موفقیت برقرار شود (ممکن است به‌صورت موازی نیز امتحان شوند، برای مثال با استفاده از یک الگوریتم `Happy Eyeballs`_). در این موارد، محدود کردن \*type\* و/یا \*proto\* می‌تواند به حذف تلاش‌های اتصال بی‌نتیجه یا غیرقابل‌استفاده کمک کند." msgid "Some systems will, however, only return a single address. (For example, this was reported on Solaris and AIX configurations.) On these systems, limiting the *type* and/or *proto* helps ensure that this address is usable." -msgstr "با این حال، برخی سیستم‌ها تنها یک نشانی را برمی‌گردانند. (برای مثال، این مورد در پیکربندی‌های Solaris و AIX گزارش شده است.) در این سیستم‌ها، محدود کردن *type* و/یا *proto* کمک می‌کند اطمینان حاصل شود که این نشانی قابل استفاده باشد." +msgstr "با این حال، برخی سیستم‌ها تنها یک نشانی را برمی‌گردانند. (برای مثال، این مورد در پیکربندی‌های Solaris و AIX گزارش شده است.) در این سیستم‌ها، محدود کردن \*type\* و/یا \*proto\* کمک می‌کند اطمینان حاصل شود که این نشانی قابل استفاده باشد." msgid "Raises an :ref:`auditing event ` ``socket.getaddrinfo`` with arguments ``host``, ``port``, ``family``, ``type``, ``protocol``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.getaddrinfo`` را با آرگومان‌های ``host``، ``port``، ``family``، ``type`` و ``protocol`` پرتاب می‌کند." @@ -621,7 +621,7 @@ msgid "for IPv6 multicast addresses, string representing an address will not con msgstr "برای نشانی‌های چندپخشی (multicast) در IPv6، رشته‌ی نشان‌دهنده‌ی یک نشانی حاوی بخش ``%scope_id`` نخواهد بود." msgid "Return a fully qualified domain name for *name*. If *name* is omitted or empty, it is interpreted as the local host. To find the fully qualified name, the hostname returned by :func:`gethostbyaddr` is checked, followed by aliases for the host, if available. The first name which includes a period is selected. In case no fully qualified domain name is available and *name* was provided, it is returned unchanged. If *name* was empty or equal to ``'0.0.0.0'``, the hostname from :func:`gethostname` is returned." -msgstr "یک نام دامنه کامل (fully qualified domain name) برای *name* برمی‌گرداند. اگر *name* حذف‌شده یا خالی باشد، به‌عنوان میزبان محلی در نظر گرفته می‌شود. برای یافتن نام کامل، نام میزبان برگردانده‌شده توسط :func:`gethostbyaddr` بررسی می‌شود و سپس نام‌های مستعار میزبان، در صورت موجود بودن، بررسی می‌شوند. اولین نامی که شامل یک نقطه باشد انتخاب می‌شود. در صورتی که هیچ نام دامنه کاملی در دسترس نباشد و *name* ارائه شده باشد، بدون تغییر برگردانده می‌شود. اگر *name* خالی یا برابر با ``'0.0.0.0'`` باشد، نام میزبان حاصل از :func:`gethostname` برگردانده می‌شود." +msgstr "یک نام دامنه کامل (fully qualified domain name) برای \*name\* برمی‌گرداند. اگر \*name\* حذف‌شده یا خالی باشد، به‌عنوان میزبان محلی در نظر گرفته می‌شود. برای یافتن نام کامل، نام میزبان برگردانده‌شده توسط :func:`gethostbyaddr` بررسی می‌شود و سپس نام‌های مستعار میزبان، در صورت موجود بودن، بررسی می‌شوند. اولین نامی که شامل یک نقطه باشد انتخاب می‌شود. در صورتی که هیچ نام دامنه کاملی در دسترس نباشد و \*name\* ارائه شده باشد، بدون تغییر برگردانده می‌شود. اگر \*name\* خالی یا برابر با ``'0.0.0.0'`` باشد، نام میزبان حاصل از :func:`gethostname` برگردانده می‌شود." msgid "Translate a host name to IPv4 address format. The IPv4 address is returned as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 address itself it is returned unchanged. See :func:`gethostbyname_ex` for a more complete interface. :func:`gethostbyname` does not support IPv6 name resolution, and :func:`getaddrinfo` should be used instead for IPv4/v6 dual stack support." msgstr "نام میزبان را به قالب نشانی IPv4 ترجمه می‌کند. نشانی IPv4 به‌صورت یک رشته برگردانده می‌شود، مانند ``'100.50.200.5'``. اگر نام میزبان خودش یک نشانی IPv4 باشد، بدون تغییر برگردانده می‌شود. برای یک رابط کامل‌تر :func:`gethostbyname_ex` را ببینید. :func:`gethostbyname` از حل نام IPv6 پشتیبانی نمی‌کند، و برای پشتیبانی از پشته دوگانه IPv4/v6 باید به‌جای آن از :func:`getaddrinfo` استفاده شود." @@ -630,7 +630,7 @@ msgid "Raises an :ref:`auditing event ` ``socket.gethostbyname`` with msgstr "یک :ref:`رویداد حسابرسی ` ``socket.gethostbyname`` را با آرگومان ``hostname`` پرتاب می‌کند." msgid "Translate a host name to IPv4 address format, extended interface. Return a 3-tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the host's primary host name, *aliaslist* is a (possibly empty) list of alternative host names for the same address, and *ipaddrlist* is a list of IPv4 addresses for the same interface on the same host (often but not always a single address). :func:`gethostbyname_ex` does not support IPv6 name resolution, and :func:`getaddrinfo` should be used instead for IPv4/v6 dual stack support." -msgstr "یک نام میزبان را به قالب نشانی IPv4 ترجمه می‌کند؛ رابط گسترش‌یافته. یک ۳‌تایی ``(hostname, aliaslist, ipaddrlist)`` برمی‌گرداند که در آن *hostname* نام میزبان اصلی آن میزبان است، *aliaslist* فهرستی (احتمالاً خالی) از نام‌های میزبان جایگزین برای همان نشانی است، و *ipaddrlist* فهرستی از نشانی‌های IPv4 برای همان رابط در همان میزبان است (اغلب، اما نه همیشه، یک نشانی واحد). :func:`gethostbyname_ex` از حل نام IPv6 پشتیبانی نمی‌کند، و برای پشتیبانی از پشته دوگانه‌ی IPv4/v6 باید به‌جای آن از :func:`getaddrinfo` استفاده شود." +msgstr "یک نام میزبان را به قالب نشانی IPv4 ترجمه می‌کند؛ رابط گسترش‌یافته. یک ۳‌تایی ``(hostname, aliaslist, ipaddrlist)`` برمی‌گرداند که در آن \*hostname\* نام میزبان اصلی آن میزبان است، \*aliaslist\* فهرستی (احتمالاً خالی) از نام‌های میزبان جایگزین برای همان نشانی است، و \*ipaddrlist\* فهرستی از نشانی‌های IPv4 برای همان رابط در همان میزبان است (اغلب، اما نه همیشه، یک نشانی واحد). :func:`gethostbyname_ex` از حل نام IPv6 پشتیبانی نمی‌کند، و برای پشتیبانی از پشته دوگانه‌ی IPv4/v6 باید به‌جای آن از :func:`getaddrinfo` استفاده شود." msgid "Return a string containing the hostname of the machine where the Python interpreter is currently executing." msgstr "رشته‌ای را برمی‌گرداند که حاوی نام میزبان ماشینی است که مفسر پایتون در حال حاضر روی آن اجرا می‌شود." @@ -642,19 +642,19 @@ msgid "Note: :func:`gethostname` doesn't always return the fully qualified domai msgstr "توجه: :func:`gethostname` همیشه نام دامنه‌ی کاملاً مشخص (fully qualified domain name) را برنمی‌گرداند؛ برای این کار از :func:`getfqdn` استفاده کنید." msgid "Return a 3-tuple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the primary host name responding to the given *ip_address*, *aliaslist* is a (possibly empty) list of alternative host names for the same address, and *ipaddrlist* is a list of IPv4/v6 addresses for the same interface on the same host (most likely containing only a single address). To find the fully qualified domain name, use the function :func:`getfqdn`. :func:`gethostbyaddr` supports both IPv4 and IPv6." -msgstr "یک تاپل ۳-تایی ``(hostname, aliaslist, ipaddrlist)`` برمی‌گرداند که در آن *hostname* نام میزبان اصلی پاسخ‌دهنده به *ip_address* داده‌شده است، *aliaslist* فهرستی (احتمالاً خالی) از نام‌های میزبان جایگزین برای همان نشانی است، و *ipaddrlist* فهرستی از نشانی‌های IPv4/v6 برای همان رابط در همان میزبان است (که به احتمال زیاد فقط شامل یک نشانی می‌شود). برای یافتن نام دامنه‌ی کامل، از تابع :func:`getfqdn` استفاده کنید. :func:`gethostbyaddr` از هر دو IPv4 و IPv6 پشتیبانی می‌کند." +msgstr "یک تاپل ۳-تایی ``(hostname, aliaslist, ipaddrlist)`` برمی‌گرداند که در آن \*hostname\* نام میزبان اصلی پاسخ‌دهنده به \*ip_address\* داده‌شده است، \*aliaslist\* فهرستی (احتمالاً خالی) از نام‌های میزبان جایگزین برای همان نشانی است، و \*ipaddrlist\* فهرستی از نشانی‌های IPv4/v6 برای همان رابط در همان میزبان است (که به احتمال زیاد فقط شامل یک نشانی می‌شود). برای یافتن نام دامنه‌ی کامل، از تابع :func:`getfqdn` استفاده کنید. :func:`gethostbyaddr` از هر دو IPv4 و IPv6 پشتیبانی می‌کند." msgid "Raises an :ref:`auditing event ` ``socket.gethostbyaddr`` with argument ``ip_address``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.gethostbyaddr`` را با آرگومان ``ip_address`` پرتاب می‌کند." msgid "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. Depending on the settings of *flags*, the result can contain a fully qualified domain name or numeric address representation in *host*. Similarly, *port* can contain a string port name or a numeric port number." -msgstr "نشانی سوکت *sockaddr* را به یک تاپل دوتایی ``(host, port)`` تبدیل می‌کند. بسته به تنظیمات *flags*، نتیجه می‌تواند شامل یک نام دامنه‌ی کامل یا نمایش عددی نشانی در *host* باشد. به‌طور مشابه، *port* می‌تواند شامل یک نام پورت به‌صورت رشته یا یک شماره پورت عددی باشد." +msgstr "نشانی سوکت \*sockaddr\* را به یک تاپل دوتایی ``(host, port)`` تبدیل می‌کند. بسته به تنظیمات \*flags\*، نتیجه می‌تواند شامل یک نام دامنه‌ی کامل یا نمایش عددی نشانی در \*host\* باشد. به‌طور مشابه، \*port\* می‌تواند شامل یک نام پورت به‌صورت رشته یا یک شماره پورت عددی باشد." msgid "For IPv6 addresses, ``%scope_id`` is appended to the host part if *sockaddr* contains meaningful *scope_id*. Usually this happens for multicast addresses." -msgstr "برای آدرس‌های IPv6، اگر *sockaddr* شامل *scope_id* معناداری باشد، ``%scope_id`` به بخش میزبان افزوده می‌شود. معمولاً این حالت برای آدرس‌های چندپخشی (multicast) رخ می‌دهد." +msgstr "برای آدرس‌های IPv6، اگر \*sockaddr\* شامل \*scope_id\* معناداری باشد، ``%scope_id`` به بخش میزبان افزوده می‌شود. معمولاً این حالت برای آدرس‌های چندپخشی (multicast) رخ می‌دهد." msgid "For more information about *flags* you can consult :manpage:`getnameinfo(3)`." -msgstr "برای اطلاعات بیشتر درباره‌ی *flags* می‌توانید به :manpage:`getnameinfo(3)` مراجعه کنید." +msgstr "برای اطلاعات بیشتر درباره‌ی \*flags\* می‌توانید به :manpage:`getnameinfo(3)` مراجعه کنید." msgid "Raises an :ref:`auditing event ` ``socket.getnameinfo`` with argument ``sockaddr``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.getnameinfo`` را با آرگومان ``sockaddr`` پرتاب می‌کند." @@ -681,7 +681,7 @@ msgid "Convert 16-bit positive integers from network to host byte order. On mac msgstr "اعداد صحیح مثبت ۱۶ بیتی را از ترتیب بایت شبکه به ترتیب بایت میزبان تبدیل می‌کند. در ماشین‌هایی که ترتیب بایت میزبان همان ترتیب بایت شبکه است، این عملیات بی‌اثر (no-op) است؛ در غیر این صورت، یک عملیات جابه‌جایی ۲ بایتی انجام می‌دهد." msgid "Raises :exc:`OverflowError` if *x* does not fit in a 16-bit unsigned integer." -msgstr "اگر *x* در یک عدد صحیح بدون علامت ۱۶‌بیتی نگنجد، :exc:`OverflowError` را پرتاب می‌کند." +msgstr "اگر \*x\* در یک عدد صحیح بدون علامت ۱۶‌بیتی نگنجد، :exc:`OverflowError` را پرتاب می‌کند." msgid "Convert 32-bit positive integers from host to network byte order. On machines where the host byte order is the same as network byte order, this is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "اعداد صحیح مثبت ۳۲ بیتی را از ترتیب بایت میزبان به ترتیب بایت شبکه تبدیل می‌کند. در ماشین‌هایی که ترتیب بایت میزبان با ترتیب بایت شبکه یکسان است، اینیک عملیات بی‌اثر (no-op) است؛ در غیر این صورت، یک عملیات جابجایی ۴ بایتی را انجام می‌دهد." @@ -711,7 +711,7 @@ msgid "Convert an IP address from its family-specific string format to a packed, msgstr "یک نشانی IP را از قالب رشته‌ای مختص خانواده‌اش به قالب دودویی فشرده تبدیل می‌کند. :func:`inet_pton` زمانی مفید است که یک کتابخانه یا پروتکل شبکه به یک شیء از نوع :c:struct:`in_addr` (مشابه :func:`inet_aton`) یا :c:struct:`in6_addr` نیاز داشته باشد." msgid "Supported values for *address_family* are currently :const:`AF_INET` and :const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:`OSError` will be raised. Note that exactly what is valid depends on both the value of *address_family* and the underlying implementation of :c:func:`inet_pton`." -msgstr "مقادیر پشتیبانی‌شده برای *address_family* در حال حاضر :const:`AF_INET` و :const:`AF_INET6` هستند. اگر رشته‌ی نشانی IP *ip_string* نامعتبر باشد، :exc:`OSError` پرتاب می‌شود. توجه داشته باشید که دقیقاً آنچه معتبر است، هم به مقدار *address_family* و هم به پیاده‌سازی زیربنایی :c:func:`inet_pton` بستگی دارد." +msgstr "مقادیر پشتیبانی‌شده برای \*address_family\* در حال حاضر :const:`AF_INET` و :const:`AF_INET6` هستند. اگر رشته‌ی نشانی IP \*ip_string\* نامعتبر باشد، :exc:`OSError` پرتاب می‌شود. توجه داشته باشید که دقیقاً آنچه معتبر است، هم به مقدار \*address_family\* و هم به پیاده‌سازی زیربنایی :c:func:`inet_pton` بستگی دارد." msgid "Windows support added" msgstr "پشتیبانی از ویندوز افزوده شد" @@ -720,16 +720,16 @@ msgid "Convert a packed IP address (a :term:`bytes-like object` of some number o msgstr "یک نشانی IP فشرده (یک :term:`شیء شبه‌بایت ` با تعدادی بایت) را به نمایش رشته‌ای استاندارد و مختص خانواده‌ی آن (برای مثال، ``'7.10.0.5'`` یا ``'5aef:2b::8'``) تبدیل می‌کند. :func:`inet_ntop` هنگامی مفید است که یک کتابخانه یا پروتکل شبکه شیءای از نوع :c:struct:`in_addr` (مشابه :func:`inet_ntoa`) یا :c:struct:`in6_addr` برمی‌گرداند." msgid "Supported values for *address_family* are currently :const:`AF_INET` and :const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length for the specified address family, :exc:`ValueError` will be raised. :exc:`OSError` is raised for errors from the call to :func:`inet_ntop`." -msgstr "مقادیر پشتیبانی‌شده برای *address_family* در حال حاضر :const:`AF_INET` و :const:`AF_INET6` هستند. اگر طول شیء bytes *packed_ip* برای خانواده‌ی نشانی مشخص‌شده صحیح نباشد، :exc:`ValueError` پرتاب خواهد شد. :exc:`OSError` برای خطاهای ناشی از فراخوانی :func:`inet_ntop` پرتاب می‌شود." +msgstr "مقادیر پشتیبانی‌شده برای \*address_family\* در حال حاضر :const:`AF_INET` و :const:`AF_INET6` هستند. اگر طول شیء bytes \*packed_ip\* برای خانواده‌ی نشانی مشخص‌شده صحیح نباشد، :exc:`ValueError` پرتاب خواهد شد. :exc:`OSError` برای خطاهای ناشی از فراخوانی :func:`inet_ntop` پرتاب می‌شود." msgid "Return the total length, without trailing padding, of an ancillary data item with associated data of the given *length*. This value can often be used as the buffer size for :meth:`~socket.recvmsg` to receive a single item of ancillary data, but :rfc:`3542` requires portable applications to use :func:`CMSG_SPACE` and thus include space for padding, even when the item will be the last in the buffer. Raises :exc:`OverflowError` if *length* is outside the permissible range of values." -msgstr "طول کل یک آیتم داده‌ی جانبی با داده‌ی مرتبط به طول *length* داده‌شده را، بدون پرکننده‌ی انتهایی (padding)، برمی‌گرداند. این مقدار اغلب می‌تواند به‌عنوان اندازه‌ی بافربرای دریافت یک آیتم داده‌ی جانبی از طریق :meth:`~socket.recvmsg` استفاده شود، اما :rfc:`3542` برنامه‌های قابل‌حمل را ملزم می‌کند که از :func:`CMSG_SPACE` استفاده کنند و بنابراین فضایی برای پرکننده (padding) در نظر بگیرند، حتی وقتی آیتم آخرین آیتم در بافر باشد. اگر *length* خارج از محدوده‌ی مجاز مقادیر باشد، :exc:`OverflowError` پرتاب می‌شود." +msgstr "طول کل یک آیتم داده‌ی جانبی با داده‌ی مرتبط به طول \*length\* داده‌شده را، بدون پرکننده‌ی انتهایی (padding)، برمی‌گرداند. این مقدار اغلب می‌تواند به‌عنوان اندازه‌ی بافربرای دریافت یک آیتم داده‌ی جانبی از طریق :meth:`~socket.recvmsg` استفاده شود، اما :rfc:`3542` برنامه‌های قابل‌حمل را ملزم می‌کند که از :func:`CMSG_SPACE` استفاده کنند و بنابراین فضایی برای پرکننده (padding) در نظر بگیرند، حتی وقتی آیتم آخرین آیتم در بافر باشد. اگر \*length\* خارج از محدوده‌ی مجاز مقادیر باشد، :exc:`OverflowError` پرتاب می‌شود." msgid "Most Unix platforms." msgstr "بیشتر پلتفرم‌های یونیکس." msgid "Return the buffer size needed for :meth:`~socket.recvmsg` to receive an ancillary data item with associated data of the given *length*, along with any trailing padding. The buffer space needed to receive multiple items is the sum of the :func:`CMSG_SPACE` values for their associated data lengths. Raises :exc:`OverflowError` if *length* is outside the permissible range of values." -msgstr "اندازه‌ی بافر موردنیاز برای :meth:`~socket.recvmsg` را برمی‌گرداند تا یک آیتم داده‌ی جانبی با داده‌ی مرتبط به طول *length* داده‌شده، به‌همراه هرگونه پرکننده‌ی انتهایی (padding) دریافت شود. فضای بافر موردنیاز برای دریافت چند آیتم، مجموع مقادیر :func:`CMSG_SPACE` برای طول‌های داده‌ی مرتبط آن‌ها است. اگر *length* خارج از محدوده‌ی مجاز مقادیر باشد، :exc:`OverflowError` پرتاب می‌شود." +msgstr "اندازه‌ی بافر موردنیاز برای :meth:`~socket.recvmsg` را برمی‌گرداند تا یک آیتم داده‌ی جانبی با داده‌ی مرتبط به طول \*length\* داده‌شده، به‌همراه هرگونه پرکننده‌ی انتهایی (padding) دریافت شود. فضای بافر موردنیاز برای دریافت چند آیتم، مجموع مقادیر :func:`CMSG_SPACE` برای طول‌های داده‌ی مرتبط آن‌ها است. اگر \*length\* خارج از محدوده‌ی مجاز مقادیر باشد، :exc:`OverflowError` پرتاب می‌شود." msgid "Note that some systems might support ancillary data without providing this function. Also note that setting the buffer size using the results of this function may not precisely limit the amount of ancillary data that can be received, since additional data may be able to fit into the padding area." msgstr "توجه داشته باشید که برخی سیستم‌ها ممکن است بدون ارائه‌ی این تابع، از داده‌های جانبی پشتیبانی کنند. همچنین توجه داشته باشید که تنظیم اندازه‌ی بافر با استفاده از نتایج این تابع ممکن است دقیقاً میزان داده‌های جانبی قابل دریافت را محدود نکند، زیرا ممکن است داده‌های اضافی بتوانند در ناحیه‌ی پدینگ (padding) جای گیرند." @@ -744,7 +744,7 @@ msgid "Set the default timeout in seconds (float) for new socket objects. When msgstr "مهلت پیش‌فرض را بر حسب ثانیه (float) برای اشیای جدید سوکت تنظیم کنید. هنگامی که ماژول socket برای اولین بار ایمپورت می‌شود، مقدار پیش‌فرض ``None`` است. برای مقادیر ممکن و معانی مربوط به آن‌ها :meth:`~socket.settimeout` را ببینید." msgid "Set the machine's hostname to *name*. This will raise an :exc:`OSError` if you don't have enough rights." -msgstr "نام میزبان ماشین را روی *name* تنظیم می‌کند. اگر دسترسی کافی نداشته باشید، این کار یک :exc:`OSError` را پرتاب می‌کند." +msgstr "نام میزبان ماشین را روی \*name\* تنظیم می‌کند. اگر دسترسی کافی نداشته باشید، این کار یک :exc:`OSError` را پرتاب می‌کند." msgid "Raises an :ref:`auditing event ` ``socket.sethostname`` with argument ``name``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.sethostname`` را با آرگومان ``name`` پرتاب می‌کند." @@ -783,13 +783,13 @@ msgid "Return a network interface name corresponding to an interface index numbe msgstr "نام رابط شبکه متناظر با شماره اندیس رابط را برمی‌گرداند. اگر رابطی با اندیس داده‌شده وجود نداشته باشد، :exc:`OSError` رخ می‌دهد." msgid "Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket *sock*. The *fds* parameter is a sequence of file descriptors. Consult :meth:`~socket.sendmsg` for the documentation of these parameters." -msgstr "فهرست توصیف‌گرهای پرونده *fds* را از طریق یک سوکت :const:`AF_UNIX` با نام *sock* ارسال کنید. پارامتر *fds* یک دنباله از توصیف‌گرهای پرونده است. برای مستندات این پارامترها به :meth:`~socket.sendmsg` مراجعه کنید." +msgstr "فهرست توصیف‌گرهای پرونده \*fds\* را از طریق یک سوکت :const:`AF_UNIX` با نام \*sock\* ارسال کنید. پارامتر \*fds\* یک دنباله از توصیف‌گرهای پرونده است. برای مستندات این پارامترها به :meth:`~socket.sendmsg` مراجعه کنید." msgid "Unix platforms supporting :meth:`~socket.sendmsg` and :const:`SCM_RIGHTS` mechanism." msgstr "سکوهای یونیکسی که از :meth:`~socket.sendmsg` و سازوکار :const:`SCM_RIGHTS` پشتیبانی می‌کنند." msgid "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket *sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`~socket.recvmsg` for the documentation of these parameters." -msgstr "حداکثر *maxfds* توصیف‌گر پرونده را از یک سوکت :const:`AF_UNIX` به نام *sock* دریافت می‌کند. مقدار ``(msg, list(fds), flags, addr)`` را برمی‌گرداند. برای مستندات این پارامترها به :meth:`~socket.recvmsg` مراجعه کنید." +msgstr "حداکثر \*maxfds\* توصیف‌گر پرونده را از یک سوکت :const:`AF_UNIX` به نام \*sock\* دریافت می‌کند. مقدار ``(msg, list(fds), flags, addr)`` را برمی‌گرداند. برای مستندات این پارامترها به :meth:`~socket.recvmsg` مراجعه کنید." msgid "Unix platforms supporting :meth:`~socket.recvmsg` and :const:`SCM_RIGHTS` mechanism." msgstr "سکوهای یونیکسی که از :meth:`~socket.recvmsg` و سازوکار :const:`SCM_RIGHTS` پشتیبانی می‌کنند." @@ -804,7 +804,7 @@ msgid "Create a new socket using the given address family, socket type and proto msgstr "با استفاده از خانواده آدرس، نوع سوکت و شماره پروتکل داده‌شده، یک سوکت جدید ایجاد کنید. خانواده آدرس باید :const:`AF_INET` (پیش‌فرض)، :const:`AF_INET6`، :const:`AF_UNIX`، :const:`AF_CAN`، :const:`AF_PACKET` یا :const:`AF_RDS` باشد. نوع سوکت باید :const:`SOCK_STREAM` (پیش‌فرض)، :const:`SOCK_DGRAM`، :const:`SOCK_RAW` یا شاید یکی از سایر ثابت‌های ``SOCK_`` باشد. شماره پروتکل معمولاً صفر است و می‌تواند حذف شود، یا در صورتی که خانواده آدرس :const:`AF_CAN` باشد، پروتکل باید یکی از :const:`CAN_RAW`، :const:`CAN_BCM`، :const:`CAN_ISOTP` یا :const:`CAN_J1939` باشد." msgid "If *fileno* is specified, the values for *family*, *type*, and *proto* are auto-detected from the specified file descriptor. Auto-detection can be overruled by calling the function with explicit *family*, *type*, or *proto* arguments. This only affects how Python represents e.g. the return value of :meth:`socket.getpeername` but not the actual OS resource. Unlike :func:`socket.fromfd`, *fileno* will return the same socket and not a duplicate. This may help close a detached socket using :meth:`socket.close`." -msgstr "اگر *fileno* مشخص شده باشد، مقادیر *family*، *type* و *proto* به‌صورت خودکار از توصیف‌گر پرونده مشخص‌شده تشخیص داده می‌شوند. می‌توان با فراخوانی تابع با آرگومان‌های صریح *family*، *type* یا *proto*، تشخیص خودکار را لغو کرد. این موضوع فقط بر نحوه‌ی بازنمایی پایتون، برای مثال مقدار بازگشتی :meth:`socket.getpeername`، تأثیر می‌گذارد، نه بر منبع واقعی سیستم‌عامل. برخلاف :func:`socket.fromfd`، *fileno* همان سوکت را برمی‌گرداند، نه یک سوکت تکراری. این ممکن است به بستن یک سوکت جداشده با استفاده از :meth:`socket.close` کمک کند." +msgstr "اگر \*fileno\* مشخص شده باشد، مقادیر \*family\*، \*type\* و \*proto\* به‌صورت خودکار از توصیف‌گر پرونده مشخص‌شده تشخیص داده می‌شوند. می‌توان با فراخوانی تابع با آرگومان‌های صریح \*family\*، \*type\* یا \*proto\*، تشخیص خودکار را لغو کرد. این موضوع فقط بر نحوه‌ی بازنمایی پایتون، برای مثال مقدار بازگشتی :meth:`socket.getpeername`، تأثیر می‌گذارد، نه بر منبع واقعی سیستم‌عامل. برخلاف :func:`socket.fromfd`، \*fileno\* همان سوکت را برمی‌گرداند، نه یک سوکت تکراری. این ممکن است به بستن یک سوکت جداشده با استفاده از :meth:`socket.close` کمک کند." msgid "Raises an :ref:`auditing event ` ``socket.__new__`` with arguments ``self``, ``family``, ``type``, ``protocol``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.__new__`` را با آرگومان‌های ``self``، ``family``، ``type``، ``protocol`` پرتاب می‌کند." @@ -819,7 +819,7 @@ msgid "The CAN_ISOTP protocol was added." msgstr "پروتکل CAN_ISOTP افزوده شد." msgid "When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied to *type* they are cleared, and :attr:`socket.type` will not reflect them. They are still passed to the underlying system ``socket()`` call. Therefore," -msgstr "هنگامی که پرچم‌های بیتی :const:`SOCK_NONBLOCK` یا :const:`SOCK_CLOEXEC` به *type* اعمال شوند، این پرچم‌ها پاک می‌شوند و :attr:`socket.type` آن‌ها را بازتاب نخواهد داد. آن‌ها همچنان به فراخوانی سیستمی زیربنایی ``socket()`` ارسال می‌شوند. بنابراین،" +msgstr "هنگامی که پرچم‌های بیتی :const:`SOCK_NONBLOCK` یا :const:`SOCK_CLOEXEC` به \*type\* اعمال شوند، این پرچم‌ها پاک می‌شوند و :attr:`socket.type` آن‌ها را بازتاب نخواهد داد. آن‌ها همچنان به فراخوانی سیستمی زیربنایی ``socket()`` ارسال می‌شوند. بنابراین،" msgid "" "sock = socket.socket(\n" @@ -846,7 +846,7 @@ msgid "Support for the :term:`context manager` protocol was added. Exiting the msgstr "پشتیبانی از پروتکل :term:`context manager` افزوده شد. خروج از مدیر زمینه معادل فراخوانی :meth:`~socket.close` است." msgid "Accept a connection. The socket must be bound to an address and listening for connections. The return value is a pair ``(conn, address)`` where *conn* is a *new* socket object usable to send and receive data on the connection, and *address* is the address bound to the socket on the other end of the connection." -msgstr "پذیرش یک اتصال. سوکت باید به یک آدرس مقید شده و در حال گوش‌دادن به اتصال‌ها باشد. مقدار بازگشتی یک جفت ``(conn, address)`` است که در آن *conn* یک شیء سوکت *جدید* است که می‌توان از آن برای ارسال و دریافت داده روی اتصال استفاده کرد، و *address* آدرسی است که به سوکت در سمت دیگر اتصال مقید شده است." +msgstr "پذیرش یک اتصال. سوکت باید به یک آدرس مقید شده و در حال گوش‌دادن به اتصال‌ها باشد. مقدار بازگشتی یک جفت ``(conn, address)`` است که در آن \*conn\* یک شیء سوکت \*جدید\* است که می‌توان از آن برای ارسال و دریافت داده روی اتصال استفاده کرد، و \*address\* آدرسی است که به سوکت در سمت دیگر اتصال مقید شده است." msgid "The socket is now non-inheritable." msgstr "سوکت اکنون غیرقابل ارث‌بری است." @@ -855,7 +855,7 @@ msgid "If the system call is interrupted and the signal handler does not raise a msgstr "اگر فراخوانی سیستمی قطع شود و هندلر سیگنال استثنایی پرتاب نکند، متد اکنون به‌جای پرتاب استثنای :exc:`InterruptedError`، فراخوانی سیستمی را دوباره تلاش می‌کند (برای دلیل آن :pep:`475` را ببینید)." msgid "Bind the socket to *address*. The socket must not already be bound. The format of *address* depends on the address family --- see :ref:`socket-addresses`." -msgstr "سوکت را به *address* مقید کنید. سوکت نباید از قبل مقید شده باشد. قالب *address* به خانواده آدرس بستگی دارد — :ref:`socket-addresses` را ببینید." +msgstr "سوکت را به \*address\* مقید کنید. سوکت نباید از قبل مقید شده باشد. قالب \*address\* به خانواده آدرس بستگی دارد — :ref:`socket-addresses` را ببینید." msgid "Raises an :ref:`auditing event ` ``socket.bind`` with arguments ``self``, ``address``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.bind`` را با آرگومان‌های ``self`` و ``address`` پرتاب می‌کند." @@ -873,7 +873,7 @@ msgid ":meth:`close` releases the resource associated with a connection but does msgstr ":meth:`close` منبع مرتبط با یک اتصال را آزاد می‌کند، اما لزوماً اتصال را بلافاصله نمی‌بندد. اگر می‌خواهید اتصال را به‌موقع ببندید، پیش از :meth:`close`، :meth:`shutdown` را فراخوانی کنید." msgid "Connect to a remote socket at *address*. The format of *address* depends on the address family --- see :ref:`socket-addresses`." -msgstr "به یک سوکتدوردست در *address* متصل شوید. قالب *address* به خانواده‌ی نشانی (address family) وابسته است — :ref:`socket-addresses` را ببینید." +msgstr "به یک سوکتدوردست در \*address\* متصل شوید. قالب \*address\* به خانواده‌ی نشانی (address family) وابسته است — :ref:`socket-addresses` را ببینید." msgid "If the connection is interrupted by a signal, the method waits until the connection completes, or raises a :exc:`TimeoutError` on timeout, if the signal handler doesn't raise an exception and the socket is blocking or has a timeout. For non-blocking sockets, the method raises an :exc:`InterruptedError` exception if the connection is interrupted by a signal (or the exception raised by the signal handler)." msgstr "اگر یک سیگنال اتصال را قطع کند، در صورتی که هندلر سیگنال استثنایی پرتاب نکند و سوکت مسدودکننده یا دارای مهلت زمانی باشد، متد تا کامل شدن اتصال صبر می‌کند یا در صورت مهلت زمانی، :exc:`TimeoutError` پرتاب می‌کند. برای سوکت‌های غیرمسدودکننده، اگر یک سیگنال اتصال را قطع کند، متد استثنای :exc:`InterruptedError` (یا استثنای پرتاب‌شده توسط هندلر سیگنال) را پرتاب می‌کند." @@ -909,7 +909,7 @@ msgid "Return the socket's own address. This is useful to find out the port num msgstr "نشانی خود سوکت را برمی‌گرداند. این کار برای مثال برای یافتن شماره پورت یک سوکت IPv4/v6 مفید است. قالب نشانی برگردانده‌شده به خانواده نشانی بستگی دارد --- :ref:`socket-addresses` را ببینید." msgid "Return the value of the given socket option (see the Unix man page :manpage:`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* etc. `) are defined in this module. If *buflen* is absent, an integer option is assumed and its integer value is returned by the function. If *buflen* is present, it specifies the maximum length of the buffer used to receive the option in, and this buffer is returned as a bytes object. It is up to the caller to decode the contents of the buffer (see the optional built-in module :mod:`struct` for a way to decode C structures encoded as byte strings)." -msgstr "مقدار گزینه‌ی سوکت داده‌شده را برمی‌گرداند (به صفحه‌ی man یونیکس :manpage:`getsockopt(2)` مراجعه کنید). ثابت‌های نمادین مورد نیاز (:ref:`SO_\\* etc. `) در این ماژول تعریف شده‌اند. اگر *buflen* وجود نداشته باشد، یک گزینه از نوع عدد صحیح فرض می‌شود و مقدار عدد صحیح آن توسط تابع بازگردانده می‌شود. اگر *buflen* وجود داشته باشد، حداکثر طول بافری را که برای دریافت گزینه استفاده می‌شود، مشخص می‌کند و این بافر به‌عنوان یک شیء bytes بازگردانده می‌شود. کدگشایی محتویات بافر بر عهده‌ی فراخواننده است (برای آشنایی با روشی برای کدگشایی ساختارهای C کدگذاری‌شده به‌صورت رشته‌های بایتی، ماژول توکار اختیاری :mod:`struct` را ببینید)." +msgstr "مقدار گزینه‌ی سوکت داده‌شده را برمی‌گرداند (به صفحه‌ی man یونیکس :manpage:`getsockopt(2)` مراجعه کنید). ثابت‌های نمادین مورد نیاز (:ref:`SO_\\* etc. `) در این ماژول تعریف شده‌اند. اگر \*buflen\* وجود نداشته باشد، یک گزینه از نوع عدد صحیح فرض می‌شود و مقدار عدد صحیح آن توسط تابع بازگردانده می‌شود. اگر \*buflen\* وجود داشته باشد، حداکثر طول بافری را که برای دریافت گزینه استفاده می‌شود، مشخص می‌کند و این بافر به‌عنوان یک شیء bytes بازگردانده می‌شود. کدگشایی محتویات بافر بر عهده‌ی فراخواننده است (برای آشنایی با روشی برای کدگشایی ساختارهای C کدگذاری‌شده به‌صورت رشته‌های بایتی، ماژول توکار اختیاری :mod:`struct` را ببینید)." msgid "Return ``True`` if socket is in blocking mode, ``False`` if in non-blocking." msgstr "اگر سوکت در حالت مسدودکننده باشد، ``True`` و اگر در حالت غیرمسدودکننده باشد، ``False`` بازمی‌گرداند." @@ -930,13 +930,13 @@ msgid "Currently only the following control codes are supported: ``SIO_RCVALL``, msgstr "در حال حاضر فقط کدهای کنترلی زیر پشتیبانی می‌شوند: ``SIO_RCVALL``، ``SIO_KEEPALIVE_VALS`` و ``SIO_LOOPBACK_FAST_PATH``." msgid "Enable a server to accept connections. If *backlog* is specified, it must be at least 0 (if it is lower, it is set to 0); it specifies the number of unaccepted connections that the system will allow before refusing new connections. If not specified, a default reasonable value is chosen." -msgstr "یک سرور را برای پذیرش اتصال‌ها فعال می‌کند. اگر *backlog* مشخص شده باشد، باید حداقل ۰ باشد (اگر کمتر باشد، روی ۰ تنظیم می‌شود)؛ این مقدار تعداد اتصال‌های پذیرفته‌نشده‌ای را مشخص می‌کند که سیستم پیش از رد کردن اتصال‌های جدید مجاز می‌داند. اگر مشخص نشده باشد، یک مقدار پیش‌فرض معقول انتخاب می‌شود." +msgstr "یک سرور را برای پذیرش اتصال‌ها فعال می‌کند. اگر \*backlog\* مشخص شده باشد، باید حداقل ۰ باشد (اگر کمتر باشد، روی ۰ تنظیم می‌شود)؛ این مقدار تعداد اتصال‌های پذیرفته‌نشده‌ای را مشخص می‌کند که سیستم پیش از رد کردن اتصال‌های جدید مجاز می‌داند. اگر مشخص نشده باشد، یک مقدار پیش‌فرض معقول انتخاب می‌شود." msgid "The *backlog* parameter is now optional." -msgstr "پارامتر *backlog* اکنون اختیاری است." +msgstr "پارامتر \*backlog\* اکنون اختیاری است." msgid "Return a :term:`file object` associated with the socket. The exact returned type depends on the arguments given to :meth:`makefile`. These arguments are interpreted the same way as by the built-in :func:`open` function, except the only supported *mode* values are ``'r'`` (default), ``'w'``, ``'b'``, or a combination of those." -msgstr "یک :term:`file object` مرتبط با سوکت را برمی‌گرداند. نوع دقیق بازگشتی به آرگومان‌های داده‌شده به :meth:`makefile` بستگی دارد. این آرگومان‌ها به همان شیوه‌ای که تابع توکار :func:`open` آن‌ها را تفسیر می‌کند، تفسیر می‌شوند، با این تفاوت که تنها مقادیر پشتیبانی‌شده برای *mode*، ``'r'`` (پیش‌فرض)، ``'w'``، ``'b'`` یا ترکیبی از آن‌ها هستند." +msgstr "یک :term:`file object` مرتبط با سوکت را برمی‌گرداند. نوع دقیق بازگشتی به آرگومان‌های داده‌شده به :meth:`makefile` بستگی دارد. این آرگومان‌ها به همان شیوه‌ای که تابع توکار :func:`open` آن‌ها را تفسیر می‌کند، تفسیر می‌شوند، با این تفاوت که تنها مقادیر پشتیبانی‌شده برای \*mode\*، ``'r'`` (پیش‌فرض)، ``'w'``، ``'b'`` یا ترکیبی از آن‌ها هستند." msgid "The socket must be in blocking mode; it can have a timeout, but the file object's internal buffer may end up in an inconsistent state if a timeout occurs." msgstr "سوکت باید در حالت مسدودکننده باشد؛ می‌تواند مهلت زمانی داشته باشد، اما اگر مهلت زمانی رخ دهد، بافر داخلی شیء پرونده ممکن است در وضعیت ناسازگار قرار گیرد." @@ -948,28 +948,28 @@ msgid "On Windows, the file-like object created by :meth:`makefile` cannot be us msgstr "در ویندوز، نمی‌توان از شیء شبه‌پرونده ایجادشده توسط :meth:`makefile` در مواردی که یک شیء پرونده دارای توصیف‌گر پرونده انتظار می‌رود استفاده کرد، مانند آرگومان‌های جریان :meth:`subprocess.Popen`." msgid "Receive data from the socket. The return value is a bytes object representing the data received. The maximum amount of data to be received at once is specified by *bufsize*. A returned empty bytes object indicates that the client has disconnected. See the Unix manual page :manpage:`recv(2)` for the meaning of the optional argument *flags*; it defaults to zero." -msgstr "داده‌ها را از سوکت دریافت می‌کند. مقدار بازگشتی یک شیء bytes است که داده‌های دریافت‌شده را نشان می‌دهد. حداکثر مقدار داده‌ای که یکجا دریافت می‌شود، با *bufsize* مشخص می‌شود. بازگشت یک شیء bytes خالی نشان می‌دهد که کلاینت قطع شده است. برای معنای آرگومان اختیاری *flags*، صفحه راهنمای Unix :manpage:`recv(2)` را ببینید؛ مقدار پیش‌فرض آن صفر است." +msgstr "داده‌ها را از سوکت دریافت می‌کند. مقدار بازگشتی یک شیء bytes است که داده‌های دریافت‌شده را نشان می‌دهد. حداکثر مقدار داده‌ای که یکجا دریافت می‌شود، با \*bufsize\* مشخص می‌شود. بازگشت یک شیء bytes خالی نشان می‌دهد که کلاینت قطع شده است. برای معنای آرگومان اختیاری \*flags\*، صفحه راهنمای Unix :manpage:`recv(2)` را ببینید؛ مقدار پیش‌فرض آن صفر است." msgid "Receive data from the socket. The return value is a pair ``(bytes, address)`` where *bytes* is a bytes object representing the data received and *address* is the address of the socket sending the data. See the Unix manual page :manpage:`recv(2)` for the meaning of the optional argument *flags*; it defaults to zero. The format of *address* depends on the address family --- see :ref:`socket-addresses`." -msgstr "داده‌ها را از سوکت دریافت می‌کند. مقدار بازگشتی یک جفت ``(bytes, address)`` است که در آن *bytes* یک شیء bytes است که داده‌های دریافتی را نشان می‌دهد و *address* نشانی سوکت ارسال‌کننده‌ی داده‌ها است. برای معنای آرگومان اختیاری *flags*، صفحه‌ی راهنمای Unix :manpage:`recv(2)` را ببینید؛ مقدار پیش‌فرض آن ۰ است. قالب *address* به خانواده‌ی نشانی بستگی دارد --- :ref:`socket-addresses` را ببینید." +msgstr "داده‌ها را از سوکت دریافت می‌کند. مقدار بازگشتی یک جفت ``(bytes, address)`` است که در آن \*bytes\* یک شیء bytes است که داده‌های دریافتی را نشان می‌دهد و \*address\* نشانی سوکت ارسال‌کننده‌ی داده‌ها است. برای معنای آرگومان اختیاری \*flags\*، صفحه‌ی راهنمای Unix :manpage:`recv(2)` را ببینید؛ مقدار پیش‌فرض آن ۰ است. قالب \*address\* به خانواده‌ی نشانی بستگی دارد --- :ref:`socket-addresses` را ببینید." msgid "For multicast IPv6 address, first item of *address* does not contain ``%scope_id`` part anymore. In order to get full IPv6 address use :func:`getnameinfo`." -msgstr "برای نشانی چندپخشی IPv6، اولین آیتم *address* دیگر شامل بخش ``%scope_id`` نمی‌شود. برای دریافت نشانی کامل IPv6 از :func:`getnameinfo` استفاده کنید." +msgstr "برای نشانی چندپخشی IPv6، اولین آیتم \*address\* دیگر شامل بخش ``%scope_id`` نمی‌شود. برای دریافت نشانی کامل IPv6 از :func:`getnameinfo` استفاده کنید." msgid "Receive normal data (up to *bufsize* bytes) and ancillary data from the socket. The *ancbufsize* argument sets the size in bytes of the internal buffer used to receive the ancillary data; it defaults to 0, meaning that no ancillary data will be received. Appropriate buffer sizes for ancillary data can be calculated using :func:`CMSG_SPACE` or :func:`CMSG_LEN`, and items which do not fit into the buffer might be truncated or discarded. The *flags* argument defaults to 0 and has the same meaning as for :meth:`recv`." -msgstr "داده‌های عادی (تا *bufsize* بایت) و داده‌های کمکی را از سوکت دریافت می‌کند. آرگومان *ancbufsize* اندازه‌ی بافر داخلی را بر حسب بایت برای دریافت داده‌های کمکی تعیین می‌کند؛ مقدار پیش‌فرض آن ۰ است، به این معنا که هیچ داده‌ی کمکی دریافت نخواهد شد. اندازه‌های مناسب بافر برای داده‌های کمکی را می‌توان با استفاده از :func:`CMSG_SPACE` یا :func:`CMSG_LEN` محاسبه کرد، و آیتم‌هایی که در بافر نمی‌گنجند ممکن است بریده یا دور ریخته شوند. آرگومان *flags* به‌طور پیش‌فرض مقدار ۰ دارد و همان معنایی را دارد که برای :meth:`recv` دارد." +msgstr "داده‌های عادی (تا \*bufsize\* بایت) و داده‌های کمکی را از سوکت دریافت می‌کند. آرگومان \*ancbufsize\* اندازه‌ی بافر داخلی را بر حسب بایت برای دریافت داده‌های کمکی تعیین می‌کند؛ مقدار پیش‌فرض آن ۰ است، به این معنا که هیچ داده‌ی کمکی دریافت نخواهد شد. اندازه‌های مناسب بافر برای داده‌های کمکی را می‌توان با استفاده از :func:`CMSG_SPACE` یا :func:`CMSG_LEN` محاسبه کرد، و آیتم‌هایی که در بافر نمی‌گنجند ممکن است بریده یا دور ریخته شوند. آرگومان \*flags\* به‌طور پیش‌فرض مقدار ۰ دارد و همان معنایی را دارد که برای :meth:`recv` دارد." msgid "The return value is a 4-tuple: ``(data, ancdata, msg_flags, address)``. The *data* item is a :class:`bytes` object holding the non-ancillary data received. The *ancdata* item is a list of zero or more tuples ``(cmsg_level, cmsg_type, cmsg_data)`` representing the ancillary data (control messages) received: *cmsg_level* and *cmsg_type* are integers specifying the protocol level and protocol-specific type respectively, and *cmsg_data* is a :class:`bytes` object holding the associated data. The *msg_flags* item is the bitwise OR of various flags indicating conditions on the received message; see your system documentation for details. If the receiving socket is unconnected, *address* is the address of the sending socket, if available; otherwise, its value is unspecified." -msgstr "مقدار بازگشتی یک تاپل ۴تایی است: ``(data, ancdata, msg_flags, address)``. آیتم *data* یک شیء :class:`bytes` حاوی داده‌های غیرجانبی دریافت‌شده است. آیتم *ancdata* فهرستی از صفر یا چند تاپل ``(cmsg_level, cmsg_type, cmsg_data)`` است که داده‌های جانبی (پیام‌های کنترلی) دریافت‌شده را نشان می‌دهد: *cmsg_level* و *cmsg_type* اعداد صحیحی هستند که به ترتیب سطح پروتکل و نوع مختص پروتکل را مشخص می‌کنند، و *cmsg_data* یک شیء :class:`bytes` حاوی داده مرتبط است. آیتم *msg_flags* حاصل یای بیتی (bitwise OR) پرچم‌های مختلفی است که شرایط پیام دریافتی را نشان می‌دهند؛ برای جزئیات، مستندات سیستم خود را ببینید. اگر سوکت دریافت‌کننده متصل نباشد، *address* نشانی سوکت فرستنده است، در صورتی که در دسترس باشد؛ در غیر این صورت، مقدار آن نامشخص است." +msgstr "مقدار بازگشتی یک تاپل ۴تایی است: ``(data, ancdata, msg_flags, address)``. آیتم \*data\* یک شیء :class:`bytes` حاوی داده‌های غیرجانبی دریافت‌شده است. آیتم \*ancdata\* فهرستی از صفر یا چند تاپل ``(cmsg_level, cmsg_type, cmsg_data)`` است که داده‌های جانبی (پیام‌های کنترلی) دریافت‌شده را نشان می‌دهد: \*cmsg_level\* و \*cmsg_type\* اعداد صحیحی هستند که به ترتیب سطح پروتکل و نوع مختص پروتکل را مشخص می‌کنند، و \*cmsg_data\* یک شیء :class:`bytes` حاوی داده مرتبط است. آیتم \*msg_flags\* حاصل یای بیتی (bitwise OR) پرچم‌های مختلفی است که شرایط پیام دریافتی را نشان می‌دهند؛ برای جزئیات، مستندات سیستم خود را ببینید. اگر سوکت دریافت‌کننده متصل نباشد، \*address\* نشانی سوکت فرستنده است، در صورتی که در دسترس باشد؛ در غیر این صورت، مقدار آن نامشخص است." msgid "On some systems, :meth:`sendmsg` and :meth:`recvmsg` can be used to pass file descriptors between processes over an :const:`AF_UNIX` socket. When this facility is used (it is often restricted to :const:`SOCK_STREAM` sockets), :meth:`recvmsg` will return, in its ancillary data, items of the form ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)``, where *fds* is a :class:`bytes` object representing the new file descriptors as a binary array of the native C :c:expr:`int` type. If :meth:`recvmsg` raises an exception after the system call returns, it will first attempt to close any file descriptors received via this mechanism." -msgstr "در برخی از سیستم‌ها، می‌توان از :meth:`sendmsg` و :meth:`recvmsg` برای انتقال توصیف‌گرهای پرونده بین فرآیندها از طریق یک سوکت :const:`AF_UNIX` استفاده کرد. هنگامی که از این قابلیت استفاده شود (که اغلب به سوکت‌های :const:`SOCK_STREAM` محدود است)، :meth:`recvmsg` در داده‌های جانبی خود، آیتم‌هایی را به شکل ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)`` برمی‌گرداند، که در آن *fds* یک شیء :class:`bytes` است که توصیف‌گرهای پرونده جدید را به‌صورت یک آرایه دودویی از نوع بومی :c:expr:`int` در C نشان می‌دهد. اگر :meth:`recvmsg` پس از بازگشت فراخوانی سیستم، استثنایی پرتاب کند، ابتدا تلاش می‌کند هر توصیف‌گر پرونده دریافت‌شده از طریق این سازوکار را ببندد." +msgstr "در برخی از سیستم‌ها، می‌توان از :meth:`sendmsg` و :meth:`recvmsg` برای انتقال توصیف‌گرهای پرونده بین فرآیندها از طریق یک سوکت :const:`AF_UNIX` استفاده کرد. هنگامی که از این قابلیت استفاده شود (که اغلب به سوکت‌های :const:`SOCK_STREAM` محدود است)، :meth:`recvmsg` در داده‌های جانبی خود، آیتم‌هایی را به شکل ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)`` برمی‌گرداند، که در آن \*fds\* یک شیء :class:`bytes` است که توصیف‌گرهای پرونده جدید را به‌صورت یک آرایه دودویی از نوع بومی :c:expr:`int` در C نشان می‌دهد. اگر :meth:`recvmsg` پس از بازگشت فراخوانی سیستم، استثنایی پرتاب کند، ابتدا تلاش می‌کند هر توصیف‌گر پرونده دریافت‌شده از طریق این سازوکار را ببندد." msgid "Some systems do not indicate the truncated length of ancillary data items which have been only partially received. If an item appears to extend beyond the end of the buffer, :meth:`recvmsg` will issue a :exc:`RuntimeWarning`, and will return the part of it which is inside the buffer provided it has not been truncated before the start of its associated data." msgstr "برخی سیستم‌ها طول بریده‌شده‌ی آیتم‌های داده‌ی جانبی را که تنها به‌طور ناقص دریافت شده‌اند، نشان نمی‌دهند. اگر به نظر برسد آیتمی از انتهای بافر فراتر می‌رود، :meth:`recvmsg` یک :exc:`RuntimeWarning` صادر می‌کند و بخشی از آن را که درون بافر است برمی‌گرداند، به شرطی که پیش از شروع داده‌ی مرتبط آن بریده نشده باشد." msgid "On systems which support the :const:`!SCM_RIGHTS` mechanism, the following function will receive up to *maxfds* file descriptors, returning the message data and a list containing the descriptors (while ignoring unexpected conditions such as unrelated control messages being received). See also :meth:`sendmsg`. ::" -msgstr "در سیستم‌هایی که از سازوکار :const:`!SCM_RIGHTS` پشتیبانی می‌کنند، تابع زیر حداکثر *maxfds* توصیف‌گر پرونده را دریافت می‌کند و داده پیام و فهرستی حاوی توصیف‌گرها را برمی‌گرداند (در حالی که شرایط غیرمنتظره‌ای مانند دریافت پیام‌های کنترلی نامرتبط را نادیده می‌گیرد). همچنین :meth:`sendmsg` را ببینید. ::" +msgstr "در سیستم‌هایی که از سازوکار :const:`!SCM_RIGHTS` پشتیبانی می‌کنند، تابع زیر حداکثر \*maxfds\* توصیف‌گر پرونده را دریافت می‌کند و داده پیام و فهرستی حاوی توصیف‌گرها را برمی‌گرداند (در حالی که شرایط غیرمنتظره‌ای مانند دریافت پیام‌های کنترلی نامرتبط را نادیده می‌گیرد). همچنین :meth:`sendmsg` را ببینید. ::" msgid "" "import socket, array\n" @@ -995,10 +995,10 @@ msgstr "" " return msg, list(fds)" msgid "Receive normal data and ancillary data from the socket, behaving as :meth:`recvmsg` would, but scatter the non-ancillary data into a series of buffers instead of returning a new bytes object. The *buffers* argument must be an iterable of objects that export writable buffers (e.g. :class:`bytearray` objects); these will be filled with successive chunks of the non-ancillary data until it has all been written or there are no more buffers. The operating system may set a limit (:func:`~os.sysconf` value ``SC_IOV_MAX``) on the number of buffers that can be used. The *ancbufsize* and *flags* arguments have the same meaning as for :meth:`recvmsg`." -msgstr "داده‌های عادی و داده‌های جانبی را از سوکت دریافت می‌کند، همان‌گونه که :meth:`recvmsg` عمل می‌کند، اما داده‌های غیرجانبی را به‌جای برگرداندن یک شیء bytes جدید، در مجموعه‌ای از بافرها پخش می‌کند. آرگومان *buffers* باید یک پیمایش‌پذیر از اشیایی باشد که بافرهای قابل‌نوشتن را در دسترس قرار می‌دهند (مانند اشیاء :class:`bytearray`)؛ این بافرها با تکه‌های متوالی از داده‌های غیرجانبی پر می‌شوند تا همه آن داده‌ها نوشته شوند یا دیگر بافری باقی نمانده باشد. ممکن است سیستم‌عامل محدودیتی (مقدار :func:`~os.sysconf` یعنی ``SC_IOV_MAX``) برای تعداد بافرهایی که می‌توان از آن‌ها استفاده کرد تعیین کند. آرگومان‌های *ancbufsize* و *flags* همان معنایی را دارند که برای :meth:`recvmsg` دارند." +msgstr "داده‌های عادی و داده‌های جانبی را از سوکت دریافت می‌کند، همان‌گونه که :meth:`recvmsg` عمل می‌کند، اما داده‌های غیرجانبی را به‌جای برگرداندن یک شیء bytes جدید، در مجموعه‌ای از بافرها پخش می‌کند. آرگومان \*buffers\* باید یک پیمایش‌پذیر از اشیایی باشد که بافرهای قابل‌نوشتن را در دسترس قرار می‌دهند (مانند اشیاء :class:`bytearray`)؛ این بافرها با تکه‌های متوالی از داده‌های غیرجانبی پر می‌شوند تا همه آن داده‌ها نوشته شوند یا دیگر بافری باقی نمانده باشد. ممکن است سیستم‌عامل محدودیتی (مقدار :func:`~os.sysconf` یعنی ``SC_IOV_MAX``) برای تعداد بافرهایی که می‌توان از آن‌ها استفاده کرد تعیین کند. آرگومان‌های \*ancbufsize\* و \*flags\* همان معنایی را دارند که برای :meth:`recvmsg` دارند." msgid "The return value is a 4-tuple: ``(nbytes, ancdata, msg_flags, address)``, where *nbytes* is the total number of bytes of non-ancillary data written into the buffers, and *ancdata*, *msg_flags* and *address* are the same as for :meth:`recvmsg`." -msgstr "مقدار بازگشتی یک تاپل ۴تایی است: ``(nbytes, ancdata, msg_flags, address)``، که در آن *nbytes* تعداد کل بایت‌های داده غیرجانبی نوشته‌شده در بافرها است، و *ancdata*، *msg_flags* و *address* همانند :meth:`recvmsg` هستند." +msgstr "مقدار بازگشتی یک تاپل ۴تایی است: ``(nbytes, ancdata, msg_flags, address)``، که در آن \*nbytes\* تعداد کل بایت‌های داده غیرجانبی نوشته‌شده در بافرها است، و \*ancdata\*، \*msg_flags\* و \*address\* همانند :meth:`recvmsg` هستند." msgid "Example::" msgstr "مثال::" @@ -1029,31 +1029,31 @@ msgstr "" "[bytearray(b'Mary'), bytearray(b'01 had a 9'), bytearray(b'little lamb---')]" msgid "Receive data from the socket, writing it into *buffer* instead of creating a new bytestring. The return value is a pair ``(nbytes, address)`` where *nbytes* is the number of bytes received and *address* is the address of the socket sending the data. See the Unix manual page :manpage:`recv(2)` for the meaning of the optional argument *flags*; it defaults to zero. The format of *address* depends on the address family --- see :ref:`socket-addresses`." -msgstr "داده‌ها را از سوکت دریافت می‌کند و به‌جای ایجاد یک رشته بایتی جدید، آن‌ها را در *buffer* می‌نویسد. مقدار بازگشتی یک جفت ``(nbytes, address)`` است که در آن *nbytes* تعداد بایت‌های دریافت‌شده و *address* نشانی سوکت ارسال‌کننده داده‌ها است. برای آگاهی از معنای آرگومان اختیاری *flags*، به صفحه راهنمای Unix :manpage:`recv(2)` مراجعه کنید؛ مقدار پیش‌فرض آن صفر است. قالب *address* به خانواده نشانی بستگی دارد — به :ref:`socket-addresses` مراجعه کنید." +msgstr "داده‌ها را از سوکت دریافت می‌کند و به‌جای ایجاد یک رشته بایتی جدید، آن‌ها را در \*buffer\* می‌نویسد. مقدار بازگشتی یک جفت ``(nbytes, address)`` است که در آن \*nbytes\* تعداد بایت‌های دریافت‌شده و \*address\* نشانی سوکت ارسال‌کننده داده‌ها است. برای آگاهی از معنای آرگومان اختیاری \*flags\*، به صفحه راهنمای Unix :manpage:`recv(2)` مراجعه کنید؛ مقدار پیش‌فرض آن صفر است. قالب \*address\* به خانواده نشانی بستگی دارد — به :ref:`socket-addresses` مراجعه کنید." msgid "Receive up to *nbytes* bytes from the socket, storing the data into a buffer rather than creating a new bytestring. If *nbytes* is not specified (or 0), receive up to the size available in the given buffer. Returns the number of bytes received. See the Unix manual page :manpage:`recv(2)` for the meaning of the optional argument *flags*; it defaults to zero." -msgstr "حداکثر *nbytes* بایت را از سوکت دریافت می‌کند و داده‌ها را به جای ایجاد یک رشته بایتی جدید، در یک بافر ذخیره می‌کند. اگر *nbytes* مشخص نشده باشد (یا ۰)، حداکثر به اندازه فضای موجود در بافر داده‌شده دریافت می‌شود. تعداد بایت‌های دریافت‌شده را برمی‌گرداند. برای معنای آرگومان اختیاری *flags*، به صفحه راهنمای یونیکس :manpage:`recv(2)` مراجعه کنید؛ مقدار پیش‌فرض آن صفر است." +msgstr "حداکثر \*nbytes\* بایت را از سوکت دریافت می‌کند و داده‌ها را به جای ایجاد یک رشته بایتی جدید، در یک بافر ذخیره می‌کند. اگر \*nbytes\* مشخص نشده باشد (یا ۰)، حداکثر به اندازه فضای موجود در بافر داده‌شده دریافت می‌شود. تعداد بایت‌های دریافت‌شده را برمی‌گرداند. برای معنای آرگومان اختیاری \*flags\*، به صفحه راهنمای یونیکس :manpage:`recv(2)` مراجعه کنید؛ مقدار پیش‌فرض آن صفر است." msgid "Send data to the socket. The socket must be connected to a remote socket. The optional *flags* argument has the same meaning as for :meth:`recv`. Returns the number of bytes sent. Applications are responsible for checking that all data has been sent; if only some of the data was transmitted, the application needs to attempt delivery of the remaining data. For further information on this topic, consult the :ref:`socket-howto`." -msgstr "داده‌ها را به سوکت ارسال کنید. سوکت باید به یک سوکت راه‌دور متصل باشد. آرگومان اختیاری *flags* همان معنای مورد استفاده در :meth:`recv` را دارد. تعداد بایت‌های ارسال‌شده را برمی‌گرداند. برنامه‌ها مسئول بررسی این هستند که همه داده‌ها ارسال شده‌اند؛ اگر تنها بخشی از داده‌ها منتقل شد، برنامه باید برای ارسال داده‌های باقی‌مانده تلاش کند. برای اطلاعات بیشتر درباره این موضوع، به :ref:`socket-howto` مراجعه کنید." +msgstr "داده‌ها را به سوکت ارسال کنید. سوکت باید به یک سوکت راه‌دور متصل باشد. آرگومان اختیاری \*flags\* همان معنای مورد استفاده در :meth:`recv` را دارد. تعداد بایت‌های ارسال‌شده را برمی‌گرداند. برنامه‌ها مسئول بررسی این هستند که همه داده‌ها ارسال شده‌اند؛ اگر تنها بخشی از داده‌ها منتقل شد، برنامه باید برای ارسال داده‌های باقی‌مانده تلاش کند. برای اطلاعات بیشتر درباره این موضوع، به :ref:`socket-howto` مراجعه کنید." msgid "Send data to the socket. The socket must be connected to a remote socket. The optional *flags* argument has the same meaning as for :meth:`recv`. Unlike :meth:`send`, this method continues to send data from *bytes* until either all data has been sent or an error occurs. ``None`` is returned on success. On error, an exception is raised, and there is no way to determine how much data, if any, was successfully sent." -msgstr "داده‌ها را به سوکت ارسال می‌کند. سوکت باید به یک سوکت راه دور متصل باشد. آرگومان اختیاری *flags* همان معنایی را دارد که برای :meth:`recv` دارد. برخلاف :meth:`send`، این متد به ارسال داده از *bytes* ادامه می‌دهد تا اینکه یا همه داده‌ها ارسال شوند یا خطایی رخ دهد. در صورت موفقیت، ``None`` برگردانده می‌شود. در صورت خطا، استثنایی پرتاب می‌شود و هیچ راهی برای تعیین اینکه چه مقدار داده، در صورت وجود، با موفقیت ارسال شده است، وجود ندارد." +msgstr "داده‌ها را به سوکت ارسال می‌کند. سوکت باید به یک سوکت راه دور متصل باشد. آرگومان اختیاری \*flags\* همان معنایی را دارد که برای :meth:`recv` دارد. برخلاف :meth:`send`، این متد به ارسال داده از \*bytes\* ادامه می‌دهد تا اینکه یا همه داده‌ها ارسال شوند یا خطایی رخ دهد. در صورت موفقیت، ``None`` برگردانده می‌شود. در صورت خطا، استثنایی پرتاب می‌شود و هیچ راهی برای تعیین اینکه چه مقدار داده، در صورت وجود، با موفقیت ارسال شده است، وجود ندارد." msgid "The socket timeout is no longer reset each time data is sent successfully. The socket timeout is now the maximum total duration to send all data." msgstr "مهلت زمانی سوکت دیگر هر بار که داده با موفقیت ارسال می‌شود، بازنشانی نمی‌شود. مهلت زمانی سوکت اکنون حداکثر مدت‌زمان کل برای ارسال تمام داده‌ها است." msgid "Send data to the socket. The socket should not be connected to a remote socket, since the destination socket is specified by *address*. The optional *flags* argument has the same meaning as for :meth:`recv`. Return the number of bytes sent. The format of *address* depends on the address family --- see :ref:`socket-addresses`." -msgstr "داده را به سوکت ارسال می‌کند. سوکت نباید به یک سوکت دوردست متصل باشد، زیرا سوکت مقصد توسط *address* مشخص می‌شود. آرگومان اختیاری *flags* همان معنایی را دارد که برای :meth:`recv` دارد. تعداد بایت‌های ارسال‌شده را برمی‌گرداند. قالب *address* به خانواده‌ی نشانی بستگی دارد — :ref:`socket-addresses` را ببینید." +msgstr "داده را به سوکت ارسال می‌کند. سوکت نباید به یک سوکت دوردست متصل باشد، زیرا سوکت مقصد توسط \*address\* مشخص می‌شود. آرگومان اختیاری \*flags\* همان معنایی را دارد که برای :meth:`recv` دارد. تعداد بایت‌های ارسال‌شده را برمی‌گرداند. قالب \*address\* به خانواده‌ی نشانی بستگی دارد — :ref:`socket-addresses` را ببینید." msgid "Raises an :ref:`auditing event ` ``socket.sendto`` with arguments ``self``, ``address``." msgstr "یک :ref:`رویداد حسابرسی ` ``socket.sendto`` را با آرگومان‌های ``self`` و ``address`` پرتاب می‌کند." msgid "Send normal and ancillary data to the socket, gathering the non-ancillary data from a series of buffers and concatenating it into a single message. The *buffers* argument specifies the non-ancillary data as an iterable of :term:`bytes-like objects ` (e.g. :class:`bytes` objects); the operating system may set a limit (:func:`~os.sysconf` value ``SC_IOV_MAX``) on the number of buffers that can be used. The *ancdata* argument specifies the ancillary data (control messages) as an iterable of zero or more tuples ``(cmsg_level, cmsg_type, cmsg_data)``, where *cmsg_level* and *cmsg_type* are integers specifying the protocol level and protocol-specific type respectively, and *cmsg_data* is a bytes-like object holding the associated data. Note that some systems (in particular, systems without :func:`CMSG_SPACE`) might support sending only one control message per call. The *flags* argument defaults to 0 and has the same meaning as for :meth:`send`. If *address* is supplied and not ``None``, it sets a destination address for the message. The return value is the number of bytes of non-ancillary data sent." -msgstr "داده‌های عادی و جانبی را به سوکت ارسال می‌کند؛ داده‌های غیرجانبی را از مجموعه‌ای از بافرها گردآوری کرده و در یک پیام واحد به هم می‌چسباند. آرگومان *buffers* داده‌های غیرجانبی را به‌صورت یک پیمایش‌پذیر از :term:`اشیاء شبه‌بایت ` مشخص می‌کند (برای مثال اشیاء :class:`bytes`)؛ سیستم‌عامل ممکن است محدودیتی (مقدار ``SC_IOV_MAX`` از :func:`~os.sysconf`) بر تعداد بافرهای قابل استفاده تعیین کند. آرگومان *ancdata* داده‌های جانبی (پیام‌های کنترلی) را به‌صورت یک پیمایش‌پذیر از صفر یا چند تاپل ``(cmsg_level, cmsg_type, cmsg_data)`` مشخص می‌کند، که در آن *cmsg_level* و *cmsg_type* اعداد صحیحی هستند که به‌ترتیب سطح پروتکل و نوع خاص پروتکل را مشخص می‌کنند، و *cmsg_data* یک شیء شبه‌بایت حاوی داده مرتبط است. توجه داشته باشید که برخی سیستم‌ها (به‌ویژه سیستم‌های بدون :func:`CMSG_SPACE`) ممکن است تنها از ارسال یک پیام کنترلی در هر فراخوانی پشتیبانی کنند. آرگومان *flags* به‌طور پیش‌فرض ۰ است و همان معنای :meth:`send` را دارد. اگر *address* ارائه شود و ``None`` نباشد، آدرس مقصدی برای پیام تنظیم می‌کند. مقدار بازگشتی تعداد بایت‌های داده غیرجانبی ارسال‌شده است." +msgstr "داده‌های عادی و جانبی را به سوکت ارسال می‌کند؛ داده‌های غیرجانبی را از مجموعه‌ای از بافرها گردآوری کرده و در یک پیام واحد به هم می‌چسباند. آرگومان \*buffers\* داده‌های غیرجانبی را به‌صورت یک پیمایش‌پذیر از :term:`اشیاء شبه‌بایت ` مشخص می‌کند (برای مثال اشیاء :class:`bytes`)؛ سیستم‌عامل ممکن است محدودیتی (مقدار ``SC_IOV_MAX`` از :func:`~os.sysconf`) بر تعداد بافرهای قابل استفاده تعیین کند. آرگومان \*ancdata\* داده‌های جانبی (پیام‌های کنترلی) را به‌صورت یک پیمایش‌پذیر از صفر یا چند تاپل ``(cmsg_level, cmsg_type, cmsg_data)`` مشخص می‌کند، که در آن \*cmsg_level\* و \*cmsg_type\* اعداد صحیحی هستند که به‌ترتیب سطح پروتکل و نوع خاص پروتکل را مشخص می‌کنند، و \*cmsg_data\* یک شیء شبه‌بایت حاوی داده مرتبط است. توجه داشته باشید که برخی سیستم‌ها (به‌ویژه سیستم‌های بدون :func:`CMSG_SPACE`) ممکن است تنها از ارسال یک پیام کنترلی در هر فراخوانی پشتیبانی کنند. آرگومان \*flags\* به‌طور پیش‌فرض ۰ است و همان معنای :meth:`send` را دارد. اگر \*address\* ارائه شود و ``None`` نباشد، آدرس مقصدی برای پیام تنظیم می‌کند. مقدار بازگشتی تعداد بایت‌های داده غیرجانبی ارسال‌شده است." msgid "The following function sends the list of file descriptors *fds* over an :const:`AF_UNIX` socket, on systems which support the :const:`!SCM_RIGHTS` mechanism. See also :meth:`recvmsg`. ::" -msgstr "تابع زیر فهرست توصیف‌گرهای پرونده *fds* را از طریق یک سوکت :const:`AF_UNIX` در سیستم‌هایی که از سازوکار :const:`!SCM_RIGHTS` پشتیبانی می‌کنند، ارسال می‌کند. همچنین :meth:`recvmsg` را ببینید. ::" +msgstr "تابع زیر فهرست توصیف‌گرهای پرونده \*fds\* را از طریق یک سوکت :const:`AF_UNIX` در سیستم‌هایی که از سازوکار :const:`!SCM_RIGHTS` پشتیبانی می‌کنند، ارسال می‌کند. همچنین :meth:`recvmsg` را ببینید. ::" msgid "" "import socket, array\n" @@ -1073,13 +1073,13 @@ msgid "Specialized version of :meth:`~socket.sendmsg` for :const:`AF_ALG` socket msgstr "نسخه‌ی تخصصی :meth:`~socket.sendmsg` برای سوکت :const:`AF_ALG` است. حالت، IV، طول داده‌های مرتبط با AEAD و پرچم‌ها را برای سوکت :const:`AF_ALG` تنظیم می‌کند." msgid "Send a file until EOF is reached by using high-performance :mod:`os.sendfile` and return the total number of bytes which were sent. *file* must be a regular file object opened in binary mode. If :mod:`os.sendfile` is not available (e.g. Windows) or *file* is not a regular file :meth:`send` will be used instead. *offset* tells from where to start reading the file. If specified, *count* is the total number of bytes to transmit as opposed to sending the file until EOF is reached. File position is updated on return or also in case of error in which case :meth:`file.tell() ` can be used to figure out the number of bytes which were sent. The socket must be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." -msgstr "یک پرونده را تا رسیدن به EOF با استفاده از :mod:`os.sendfile` با کارایی بالا ارسال می‌کند و تعداد کل بایت‌های ارسال‌شده را برمی‌گرداند. *file* باید یک شیء پرونده معمولی باشد که در حالت دودویی باز شده است. اگر :mod:`os.sendfile` در دسترس نباشد (برای مثال ویندوز) یا *file* یک پرونده معمولی نباشد، به‌جای آن از :meth:`send` استفاده خواهد شد. *offset* مشخص می‌کند که خواندن پرونده از کجا آغاز شود. در صورت تعیین شدن، *count* تعداد کل بایت‌هایی است که باید منتقل شوند، برخلاف ارسال پرونده تا رسیدن به EOF. موقعیت پرونده هنگام بازگشت و همچنین در صورت بروز خطا به‌روزرسانی می‌شود؛ در این صورت می‌توان از :meth:`file.tell() ` برای تشخیص تعداد بایت‌های ارسال‌شده استفاده کرد. سوکت باید از نوع :const:`SOCK_STREAM` باشد. سوکت‌های غیرمسدودکننده پشتیبانی نمی‌شوند." +msgstr "یک پرونده را تا رسیدن به EOF با استفاده از :mod:`os.sendfile` با کارایی بالا ارسال می‌کند و تعداد کل بایت‌های ارسال‌شده را برمی‌گرداند. \*file\* باید یک شیء پرونده معمولی باشد که در حالت دودویی باز شده است. اگر :mod:`os.sendfile` در دسترس نباشد (برای مثال ویندوز) یا \*file\* یک پرونده معمولی نباشد، به‌جای آن از :meth:`send` استفاده خواهد شد. \*offset\* مشخص می‌کند که خواندن پرونده از کجا آغاز شود. در صورت تعیین شدن، \*count\* تعداد کل بایت‌هایی است که باید منتقل شوند، برخلاف ارسال پرونده تا رسیدن به EOF. موقعیت پرونده هنگام بازگشت و همچنین در صورت بروز خطا به‌روزرسانی می‌شود؛ در این صورت می‌توان از :meth:`file.tell() ` برای تشخیص تعداد بایت‌های ارسال‌شده استفاده کرد. سوکت باید از نوع :const:`SOCK_STREAM` باشد. سوکت‌های غیرمسدودکننده پشتیبانی نمی‌شوند." msgid "Set the :ref:`inheritable flag ` of the socket's file descriptor or socket's handle." msgstr ":ref:`پرچم ارث‌پذیری ` توصیف‌گر پرونده سوکت یا دسته‌ی سوکت را تنظیم کنید." msgid "Set blocking or non-blocking mode of the socket: if *flag* is false, the socket is set to non-blocking, else to blocking mode." -msgstr "حالت مسدودکننده یا غیرمسدودکننده‌ی سوکت را تنظیم می‌کند: اگر *flag* نادرست باشد، سوکت در حالت غیرمسدودکننده تنظیم می‌شود، در غیر این صورت در حالت مسدودکننده تنظیم می‌شود." +msgstr "حالت مسدودکننده یا غیرمسدودکننده‌ی سوکت را تنظیم می‌کند: اگر \*flag\* نادرست باشد، سوکت در حالت غیرمسدودکننده تنظیم می‌شود، در غیر این صورت در حالت مسدودکننده تنظیم می‌شود." msgid "This method is a shorthand for certain :meth:`~socket.settimeout` calls:" msgstr "این متد میان‌بری برای برخی فراخوانی‌های :meth:`~socket.settimeout` است:" @@ -1094,7 +1094,7 @@ msgid "The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket msgstr "این متد دیگر پرچم :const:`SOCK_NONBLOCK` را روی :attr:`socket.type` اعمال نمی‌کند." msgid "Set a timeout on blocking socket operations. The *value* argument can be a nonnegative real number expressing seconds, or ``None``. If a non-zero value is given, subsequent socket operations will raise a :exc:`timeout` exception if the timeout period *value* has elapsed before the operation has completed. If zero is given, the socket is put in non-blocking mode. If ``None`` is given, the socket is put in blocking mode." -msgstr "برای عملیات‌های مسدودکننده سوکت یک مهلت تنظیم کنید. آرگومان *value* می‌تواند یک عدد حقیقی نامنفی بیان‌کننده ثانیه‌ها، یا ``None`` باشد. اگر مقدار غیرصفر داده شود، در عملیات‌های بعدی سوکت، چنانچه دوره مهلت *value* پیش از تکمیل عملیات سپری شده باشد، استثنای :exc:`timeout` پرتاب خواهد شد. اگر ۰ داده شود، سوکت در حالت غیرمسدودکننده قرار می‌گیرد. اگر ``None`` داده شود، سوکت در حالت مسدودکننده قرار می‌گیرد." +msgstr "برای عملیات‌های مسدودکننده سوکت یک مهلت تنظیم کنید. آرگومان \*value\* می‌تواند یک عدد حقیقی نامنفی بیان‌کننده ثانیه‌ها، یا ``None`` باشد. اگر مقدار غیرصفر داده شود، در عملیات‌های بعدی سوکت، چنانچه دوره مهلت \*value\* پیش از تکمیل عملیات سپری شده باشد، استثنای :exc:`timeout` پرتاب خواهد شد. اگر ۰ داده شود، سوکت در حالت غیرمسدودکننده قرار می‌گیرد. اگر ``None`` داده شود، سوکت در حالت مسدودکننده قرار می‌گیرد." msgid "For further information, please consult the :ref:`notes on socket timeouts `." msgstr "برای اطلاعات بیشتر، لطفاً :ref:`یادداشت‌های مربوط به مهلت‌های زمانی سوکت ` را مطالعه کنید." @@ -1103,19 +1103,19 @@ msgid "The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket msgstr "این متد دیگر پرچم :const:`SOCK_NONBLOCK` را روی :attr:`socket.type` تغییر وضعیت نمی‌دهد." msgid "Set the value of the given socket option (see the Unix manual page :manpage:`setsockopt(2)`). The needed symbolic constants are defined in this module (:ref:`!SO_\\* etc. `). The value can be an integer, ``None`` or a :term:`bytes-like object` representing a buffer. In the latter case it is up to the caller to ensure that the bytestring contains the proper bits (see the optional built-in module :mod:`struct` for a way to encode C structures as bytestrings). When *value* is set to ``None``, *optlen* argument is required. It's equivalent to calling :c:func:`!setsockopt` C function with ``optval=NULL`` and ``optlen=optlen``." -msgstr "مقدار گزینه‌ی سوکت داده‌شده را تنظیم می‌کند (صفحه‌ی راهنمای یونیکس :manpage:`setsockopt(2)` را ببینید). ثابت‌های نمادین مورد نیاز در این ماژول تعریف شده‌اند (:ref:`!SO_\\* etc. `). مقدار می‌تواند یک عدد صحیح، ``None`` یا یک :term:`bytes-like object` باشد که نشان‌دهنده‌ی یک بافر است. در حالت آخر، این بر عهده‌ی فراخواننده است که اطمینان حاصل کند رشته‌بایت حاوی بیت‌های مناسب است (برای راهی جهت کدگذاری ساختارهای C به‌صورت رشته‌بایت‌ها، ماژول توکار اختیاری :mod:`struct` را ببینید). هنگامی که *value* روی ``None`` تنظیم شود، آرگومان *optlen* الزامی است. این معادل فراخوانی تابع C :c:func:`!setsockopt` با ``optval=NULL`` و ``optlen=optlen`` است." +msgstr "مقدار گزینه‌ی سوکت داده‌شده را تنظیم می‌کند (صفحه‌ی راهنمای یونیکس :manpage:`setsockopt(2)` را ببینید). ثابت‌های نمادین مورد نیاز در این ماژول تعریف شده‌اند (:ref:`!SO_\\* etc. `). مقدار می‌تواند یک عدد صحیح، ``None`` یا یک :term:`bytes-like object` باشد که نشان‌دهنده‌ی یک بافر است. در حالت آخر، این بر عهده‌ی فراخواننده است که اطمینان حاصل کند رشته‌بایت حاوی بیت‌های مناسب است (برای راهی جهت کدگذاری ساختارهای C به‌صورت رشته‌بایت‌ها، ماژول توکار اختیاری :mod:`struct` را ببینید). هنگامی که \*value\* روی ``None`` تنظیم شود، آرگومان \*optlen\* الزامی است. این معادل فراخوانی تابع C :c:func:`!setsockopt` با ``optval=NULL`` و ``optlen=optlen`` است." msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "شکل setsockopt(level, optname, None, optlen: int) اضافه شد." msgid "Shut down one or both halves of the connection. If *how* is :const:`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, further sends are disallowed. If *how* is :const:`SHUT_RDWR`, further sends and receives are disallowed." -msgstr "یک یا هر دو نیمه‌ی اتصال را خاموش کنید. اگر *how* برابر :const:`SHUT_RD` باشد، دریافت‌های بعدی مجاز نیستند. اگر *how* برابر :const:`SHUT_WR` باشد، ارسال‌های بعدی مجاز نیستند. اگر *how* برابر :const:`SHUT_RDWR` باشد، ارسال‌ها و دریافت‌های بعدی مجاز نیستند." +msgstr "یک یا هر دو نیمه‌ی اتصال را خاموش کنید. اگر \*how\* برابر :const:`SHUT_RD` باشد، دریافت‌های بعدی مجاز نیستند. اگر \*how\* برابر :const:`SHUT_WR` باشد، ارسال‌های بعدی مجاز نیستند. اگر \*how\* برابر :const:`SHUT_RDWR` باشد، ارسال‌ها و دریافت‌های بعدی مجاز نیستند." msgid "Duplicate a socket and prepare it for sharing with a target process. The target process must be provided with *process_id*. The resulting bytes object can then be passed to the target process using some form of interprocess communication and the socket can be recreated there using :func:`fromshare`. Once this method has been called, it is safe to close the socket since the operating system has already duplicated it for the target process." -msgstr "سوکت را تکثیر می‌کند و آن را برای اشتراک‌گذاری با یک فرایند هدف آماده می‌کند. فرایند هدف باید با *process_id* مشخص شود. سپس می‌توان شیء bytes حاصل را با استفاده از نوعی ارتباط بین‌فرایندی به فرایند هدف منتقل کرد و سوکت را در آن‌جا با استفاده از :func:`fromshare` دوباره ایجاد کرد. پس از فراخوانی این متد، بستن سوکت بی‌خطر است، زیرا سیستم‌عامل پیش‌تر آن را برای فرایند هدف تکثیر کرده است." +msgstr "سوکت را تکثیر می‌کند و آن را برای اشتراک‌گذاری با یک فرایند هدف آماده می‌کند. فرایند هدف باید با \*process_id\* مشخص شود. سپس می‌توان شیء bytes حاصل را با استفاده از نوعی ارتباط بین‌فرایندی به فرایند هدف منتقل کرد و سوکت را در آن‌جا با استفاده از :func:`fromshare` دوباره ایجاد کرد. پس از فراخوانی این متد، بستن سوکت بی‌خطر است، زیرا سیستم‌عامل پیش‌تر آن را برای فرایند هدف تکثیر کرده است." msgid "Note that there are no methods :meth:`!read` or :meth:`!write`; use :meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." -msgstr "توجه داشته باشید که متدهای :meth:`!read` یا :meth:`!write` وجود ندارند؛ در عوض از :meth:`~socket.recv` و :meth:`~socket.send` بدون آرگومان *flags* استفاده کنید." +msgstr "توجه داشته باشید که متدهای :meth:`!read` یا :meth:`!write` وجود ندارند؛ در عوض از :meth:`~socket.recv` و :meth:`~socket.send` بدون آرگومان \*flags\* استفاده کنید." msgid "Socket objects also have these (read-only) attributes that correspond to the values given to the :class:`~socket.socket` constructor." msgstr "اشیای سوکت همچنین دارای این ویژگی‌های (فقط‌خواندنی) هستند که با مقادیر داده‌شده به سازنده‌ی :class:`~socket.socket` مطابقت دارند." @@ -1139,16 +1139,16 @@ msgid "A socket object can be in one of three modes: blocking, non-blocking, or msgstr "یک شیء سوکت می‌تواند در یکی از سه حالت باشد: مسدودکننده، غیرمسدودکننده، یا مهلت زمانی . سوکت‌ها به‌طور پیش‌فرض همیشه در حالت مسدودکننده ایجاد می‌شوند، اما می‌توان این حالت را با فراخوانی :func:`setdefaulttimeout` تغییر داد." msgid "In *blocking mode*, operations block until complete or the system returns an error (such as connection timed out)." -msgstr "در *حالت مسدودکننده*، عملیات‌ها تا زمانی که کامل شوند یا سیستم خطایی برگرداند، مسدود می‌شوند (مانند اتمام مهلت اتصال)." +msgstr "در \*حالت مسدودکننده\*، عملیات‌ها تا زمانی که کامل شوند یا سیستم خطایی برگرداند، مسدود می‌شوند (مانند اتمام مهلت اتصال)." msgid "In *non-blocking mode*, operations fail (with an error that is unfortunately system-dependent) if they cannot be completed immediately: functions from the :mod:`select` module can be used to know when and whether a socket is available for reading or writing." -msgstr "در *حالت غیرمسدود*، عملیات‌ها در صورتی شکست می‌خورند که نتوانند بلافاصله کامل شوند (با خطایی که متأسفانه به سیستم وابسته است): برای تشخیص اینکه چه زمانی و آیا یک سوکت برای خواندن یا نوشتن در دسترس است، می‌توان از توابع ماژول :mod:`select` استفاده کرد." +msgstr "در \*حالت غیرمسدود\*، عملیات‌ها در صورتی شکست می‌خورند که نتوانند بلافاصله کامل شوند (با خطایی که متأسفانه به سیستم وابسته است): برای تشخیص اینکه چه زمانی و آیا یک سوکت برای خواندن یا نوشتن در دسترس است، می‌توان از توابع ماژول :mod:`select` استفاده کرد." msgid "In *timeout mode*, operations fail if they cannot be completed within the timeout specified for the socket (they raise a :exc:`timeout` exception) or if the system returns an error." -msgstr "در *حالت مهلت *، عملیات‌ها ناموفق می‌شوند اگر نتوانند در مهلت تعیین‌شده برای سوکت تکمیل شوند (آن‌ها استثانای :exc:`timeout` را پرتاب می‌کنند) یا اگر سیستم خطایی برگرداند." +msgstr "در \*حالت مهلت \*، عملیات‌ها ناموفق می‌شوند اگر نتوانند در مهلت تعیین‌شده برای سوکت تکمیل شوند (آن‌ها استثانای :exc:`timeout` را پرتاب می‌کنند) یا اگر سیستم خطایی برگرداند." msgid "At the operating system level, sockets in *timeout mode* are internally set in non-blocking mode. Also, the blocking and timeout modes are shared between file descriptors and socket objects that refer to the same network endpoint. This implementation detail can have visible consequences if e.g. you decide to use the :meth:`~socket.fileno` of a socket." -msgstr "در سطح سیستم‌عامل، سوکت‌هایی که در *حالت مهلت زمانی* هستند، به‌صورت داخلی در حالت غیرمسدودکننده تنظیم می‌شوند. همچنین حالت‌های مسدودکننده و مهلت زمانی بین توصیف‌گرهای پرونده و اشیای سوکتی که به یک پایانه شبکه یکسان اشاره می‌کنند، مشترک هستند. این جزئیات پیاده‌سازی می‌تواند پیامدهای قابل‌مشاهده‌ای داشته باشد، برای مثال اگر تصمیم بگیرید از :meth:`~socket.fileno` یک سوکت استفاده کنید." +msgstr "در سطح سیستم‌عامل، سوکت‌هایی که در \*حالت مهلت زمانی\* هستند، به‌صورت داخلی در حالت غیرمسدودکننده تنظیم می‌شوند. همچنین حالت‌های مسدودکننده و مهلت زمانی بین توصیف‌گرهای پرونده و اشیای سوکتی که به یک پایانه شبکه یکسان اشاره می‌کنند، مشترک هستند. این جزئیات پیاده‌سازی می‌تواند پیامدهای قابل‌مشاهده‌ای داشته باشد، برای مثال اگر تصمیم بگیرید از :meth:`~socket.fileno` یک سوکت استفاده کنید." msgid "Timeouts and the ``connect`` method" msgstr "مهلت‌ها و متد ``connect``" @@ -1163,10 +1163,10 @@ msgid "If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by th msgstr "اگر :func:`getdefaulttimeout` برابر :const:`None` نباشد، سوکت‌های برگردانده‌شده توسط متد :meth:`~socket.accept` آن مهلت زمانی را به ارث می‌برند. در غیر این صورت، رفتار به تنظیمات سوکت گوش‌دهنده بستگی دارد:" msgid "if the listening socket is in *blocking mode* or in *timeout mode*, the socket returned by :meth:`~socket.accept` is in *blocking mode*;" -msgstr "اگر سوکت گوش‌کننده در *حالت مسدودکننده* یا در *حالت timeout* باشد، سوکت برگردانده‌شده توسط :meth:`~socket.accept` در *حالت مسدودکننده* است؛" +msgstr "اگر سوکت گوش‌کننده در \*حالت مسدودکننده\* یا در \*حالت timeout\* باشد، سوکت برگردانده‌شده توسط :meth:`~socket.accept` در \*حالت مسدودکننده\* است؛" msgid "if the listening socket is in *non-blocking mode*, whether the socket returned by :meth:`~socket.accept` is in blocking or non-blocking mode is operating system-dependent. If you want to ensure cross-platform behaviour, it is recommended you manually override this setting." -msgstr "اگر سوکت شنونده در *حالت غیرمسدود* باشد، مسدود یا غیرمسدود بودن سوکتی که :meth:`~socket.accept` برمی‌گرداند، به سیستم‌عامل وابسته است. اگر می‌خواهید رفتار بین‌سکویی را تضمین کنید، توصیه می‌شود این تنظیم را به‌صورت دستی بازنویسی کنید." +msgstr "اگر سوکت شنونده در \*حالت غیرمسدود\* باشد، مسدود یا غیرمسدود بودن سوکتی که :meth:`~socket.accept` برمی‌گرداند، به سیستم‌عامل وابسته است. اگر می‌خواهید رفتار بین‌سکویی را تضمین کنید، توصیه می‌شود این تنظیم را به‌صورت دستی بازنویسی کنید." msgid "Example" msgstr "مثال" @@ -1527,10 +1527,10 @@ msgid "For an introduction to socket programming (in C), see the following paper msgstr "برای آشنایی با برنامه‌نویسی سوکت (به زبان C)، مقاله‌های زیر را ببینید:" msgid "*An Introductory 4.3BSD Interprocess Communication Tutorial*, by Stuart Sechrest" -msgstr "*آموزش مقدماتی ارتباط بین‌فرایندی 4.3BSD*، اثر Stuart Sechrest" +msgstr "\*آموزش مقدماتی ارتباط بین‌فرایندی 4.3BSD\*، اثر Stuart Sechrest" msgid "*An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. Leffler et al," -msgstr "*آموزش پیشرفته ارتباط بین‌فرایندی 4.3BSD*، اثر Samuel J. Leffler و دیگران،" +msgstr "\*آموزش پیشرفته ارتباط بین‌فرایندی 4.3BSD\*، اثر Samuel J. Leffler و دیگران،" msgid "both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections PS1:7 and PS1:8). The platform-specific reference material for the various socket-related system calls are also a valuable source of information on the details of socket semantics. For Unix, refer to the manual pages; for Windows, see the WinSock (or Winsock 2) specification. For IPv6-ready APIs, readers may want to refer to :rfc:`3493` titled Basic Socket Interface Extensions for IPv6." msgstr "هر دو در UNIX Programmer's Manual، Supplementary Documents 1 (بخش‌های PS1:7 و PS1:8). مستندات مرجع مختص هر سکو برای فراخوانی‌های سیستمی مختلف مرتبط با سوکت نیز منبع ارزشمندی برای اطلاعات درباره‌ی جزئیات معناشناسی سوکت است. برای Unix، به صفحات راهنما مراجعه کنید؛ برای Windows، مشخصات WinSock (یا Winsock 2) را ببینید. برای APIهای آماده برای IPv6، خوانندگان ممکن است بخواهند به :rfc:`3493` با عنوان Basic Socket Interface Extensions for IPv6 مراجعه کنند." diff --git a/library/sqlite3.po b/library/sqlite3.po index 90da107e..60f88c4e 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -375,9 +375,9 @@ msgid "" " )" msgstr "" "CREATE TABLE test(\n" -" i integer primary key, ! به دنبال مبدلی به نام \"integer\" می‌گردد\n" -" p point, ! به دنبال مبدلی به نام \"point\" می‌گردد\n" -" n number(10) ! به دنبال مبدلی به نام \"number\" می‌گردد\n" +" i integer primary key, ! will look up a converter named \"integer\"\n" +" p point, ! will look up a converter named \"point\"\n" +" n number(10) ! will look up a converter named \"number\"\n" " )" msgid "This flag may be combined with :const:`PARSE_COLNAMES` using the ``|`` (bitwise or) operator." @@ -390,7 +390,7 @@ msgid "Pass this flag value to the *detect_types* parameter of :func:`connect` t msgstr "این مقدار پرچم را به پارامتر *detect_types* از :func:`connect` بدهید تا با استفاده از نام نوع، که از نام ستون پرس‌وجو تجزیه می‌شود، به‌عنوان کلید دیکشنری مبدل، یک تابع مبدل را جستجو کنید. نام ستون پرس‌وجو باید داخل علامت نقل‌قول دوتایی (``\"``) و نام نوع باید داخل کروشه (``[]``) قرار گیرد." msgid "SELECT MAX(p) as \"p [point]\" FROM test; ! will look up converter \"point\"" -msgstr "SELECT MAX(p) as \"p [point]\" FROM test; ! مبدل (converter) \"point\" را جست‌وجو خواهد کرد" +msgstr "SELECT MAX(p) as \"p [point]\" FROM test; ! will look up converter \"point\"" msgid "This flag may be combined with :const:`PARSE_DECLTYPES` using the ``|`` (bitwise or) operator." msgstr "می‌توان این پرچم را با :const:`PARSE_DECLTYPES` با استفاده از عملگر ``|`` (یای بیتی) ترکیب کرد." diff --git a/library/test.po b/library/test.po index 6222e942..909f9795 100644 --- a/library/test.po +++ b/library/test.po @@ -736,7 +736,7 @@ msgid "Returns the set of attributes, functions or methods of *ref_api* not foun msgstr "مجموعه‌ای از ویژگی‌ها، توابع یا متدهای *ref_api* را برمی‌گرداند که در *other_api* یافت نمی‌شوند، به‌جز فهرست تعریف‌شده‌ای از آیتم‌هایی که باید در این بررسی نادیده گرفته شوند و در *ignore* مشخص شده‌اند." msgid "By default this skips private attributes beginning with '_' but includes all magic methods, i.e. those starting and ending in '__'." -msgstr "به‌طور پیش‌فرض، ویژگی‌های خصوصی‌ای که با '_' آغاز می‌شوند نادیده گرفته می‌شوند، اما همه‌ی متدهای ویژه، یعنی آن‌هایی که با '__' آغاز می‌شوند و به آن ختم می‌شوند، شامل می‌شوند." +msgstr "به‌طور پیش‌فرض، ویژگی‌های خصوصی‌ای که با '_' آغاز می‌شوند نادیده گرفته می‌شوند، اما همه‌ی متدهای جادویی، یعنی آن‌هایی که با '__' آغاز می‌شوند و به آن ختم می‌شوند، شامل می‌شوند." msgid "Override *object_to_patch.attr_name* with *new_value*. Also add cleanup procedure to *test_instance* to restore *object_to_patch* for *attr_name*. The *attr_name* should be a valid attribute for *object_to_patch*." msgstr "*object_to_patch.attr_name* را با *new_value* بازنویسی می‌کند. همچنین یک رویه‌ی پاک‌سازی به *test_instance* اضافه می‌کند تا *object_to_patch* را برای *attr_name* به حالت پیشین بازگرداند. *attr_name* باید یک ویژگی معتبر برای *object_to_patch* باشد." diff --git a/library/unittest.mock-examples.po b/library/unittest.mock-examples.po index 1c8f24f7..8bfde431 100644 --- a/library/unittest.mock-examples.po +++ b/library/unittest.mock-examples.po @@ -826,10 +826,10 @@ msgid "After the ``MagicMock`` has been used we can use attributes like :data:`~ msgstr "پس از استفاده از ``MagicMock``، می‌توانیم از ویژگی‌هایی مانند :data:`~Mock.call_args_list` برای تصدیق چگونگی استفاده از دیکشنری استفاده کنیم:" msgid "An alternative to using ``MagicMock`` is to use ``Mock`` and *only* provide the magic methods you specifically want:" -msgstr "یک جایگزین برای استفاده از ``MagicMock`` این است که از ``Mock`` استفاده کنید و *فقط* متدهای ویژه را که به‌طور مشخص می‌خواهید، فراهم کنید:" +msgstr "یک جایگزین برای استفاده از ``MagicMock`` این است که از ``Mock`` استفاده کنید و *فقط* متدهای جادویی را که به‌طور مشخص می‌خواهید، فراهم کنید:" msgid "A *third* option is to use ``MagicMock`` but passing in ``dict`` as the *spec* (or *spec_set*) argument so that the ``MagicMock`` created only has dictionary magic methods available:" -msgstr "*سومین* گزینه این است که از ``MagicMock`` استفاده کنید، اما ``dict`` را به‌عنوان آرگومان *spec* (یا *spec_set*) ارسال کنید تا ``MagicMock`` ایجادشده فقط متدهای ویژه دیکشنری را در دسترس داشته باشد:" +msgstr "*سومین* گزینه این است که از ``MagicMock`` استفاده کنید، اما ``dict`` را به‌عنوان آرگومان *spec* (یا *spec_set*) ارسال کنید تا ``MagicMock`` ایجادشده فقط متدهای جادویی دیکشنری را در دسترس داشته باشد:" msgid "With these side effect functions in place, the ``mock`` will behave like a normal dictionary but recording the access. It even raises a :exc:`KeyError` if you try to access a key that doesn't exist." msgstr "با وجود این توابع اثر جانبی، ``mock`` مانند یک دیکشنری معمولی رفتار می‌کند، اما دسترسی‌ها را ثبت می‌کند. حتی اگر سعی کنید به کلیدی که وجود ندارد دسترسی پیدا کنید، یک :exc:`KeyError` پرتاب می‌کند." diff --git a/library/unittest.mock.po b/library/unittest.mock.po index c9648cb9..e41c03b9 100644 --- a/library/unittest.mock.po +++ b/library/unittest.mock.po @@ -100,13 +100,13 @@ msgid "There is also :func:`patch.dict` for setting values in a dictionary just msgstr "همچنین :func:`patch.dict` برای تنظیم مقادیر در یک دیکشنری فقط در طول یک محدوده و بازگرداندن دیکشنری به حالت اصلی خود هنگام پایان آزمون وجود دارد:" msgid "Mock supports the mocking of Python :ref:`magic methods `. The easiest way of using magic methods is with the :class:`MagicMock` class. It allows you to do things like:" -msgstr "Mock از ماک کردن :ref:`متدهای ویژه ` پایتون پشتیبانی می‌کند. ساده‌ترین راه برای استفاده از متدهای ویژه، استفاده از کلاس :class:`MagicMock` است. این کلاس به شما امکان می‌دهد کارهایی مانند موارد زیر را انجام دهید:" +msgstr "Mock از ماک کردن :ref:`متدهای جادویی ` پایتون پشتیبانی می‌کند. ساده‌ترین راه برای استفاده از متدهای ویژه، استفاده از کلاس :class:`MagicMock` است. این کلاس به شما امکان می‌دهد کارهایی مانند موارد زیر را انجام دهید:" msgid "Mock allows you to assign functions (or other Mock instances) to magic methods and they will be called appropriately. The :class:`MagicMock` class is just a Mock variant that has all of the magic methods pre-created for you (well, all the useful ones anyway)." -msgstr "ماک به شما اجازه می‌دهد توابع (یا دیگر نمونه‌های ماک) را به متدهای ویژه اختصاص دهید و آن‌ها به‌درستی فراخوانی می‌شوند. کلاس :class:`MagicMock` صرفاً گونه‌ای از ماک است که تمام متدهای ویژه آن از پیش برای شما ایجاد شده‌اند (البته به‌هرحال همه‌ی متدهای مفید)." +msgstr "ماک به شما اجازه می‌دهد توابع (یا دیگر نمونه‌های ماک) را به متدهای جادویی اختصاص دهید و آن‌ها به‌درستی فراخوانی می‌شوند. کلاس :class:`MagicMock` صرفاً گونه‌ای از ماک است که تمام متدهای ویژه آن از پیش برای شما ایجاد شده‌اند (البته به‌هرحال همه‌ی متدهای مفید)." msgid "The following is an example of using magic methods with the ordinary Mock class:" -msgstr "در زیر مثالی از استفاده از متدهای ویژه با کلاس معمولی Mock آمده است:" +msgstr "در زیر مثالی از استفاده از متدهای جادویی با کلاس معمولی Mock آمده است:" msgid "For ensuring that the mock objects in your tests have the same api as the objects they are replacing, you can use :ref:`auto-speccing `. Auto-speccing can be done through the *autospec* argument to patch, or the :func:`create_autospec` function. Auto-speccing creates mock objects that have the same attributes and methods as the objects they are replacing, and any functions and methods (including constructors) have the same call signature as the real object." msgstr "برای اطمینان از اینکه اشیای ماک در آزمون‌های شما همان API اشیایی را دارند که جایگزین آن‌ها می‌شوند، می‌توانید از :ref:`auto-speccing ` استفاده کنید. Auto-speccing را می‌توان از طریق آرگومان *autospec* در patch، یا تابع :func:`create_autospec` انجام داد. Auto-speccing اشیای ماکی ایجاد می‌کند که همان ویژگی‌ها و متدهای اشیایی را دارند که جایگزین آن‌ها می‌شوند، و همه توابع و متدها (از جمله سازنده‌ها) همان امضای فراخوانی شیء واقعی را دارند." @@ -124,7 +124,7 @@ msgid ":class:`Mock` is a flexible mock object intended to replace the use of st msgstr ":class:`Mock` یک شیء ماک انعطاف‌پذیر است که برای جایگزینی استفاده از جایگزین‌های موقت (stubs) و جایگزین‌های آزمون (test doubles) در سراسر کد شما در نظر گرفته شده است. ماک‌ها فراخوانی‌پذیر هستند و هنگامی که به ویژگی‌های آن‌ها دسترسی پیدا می‌کنید، آن ویژگی‌ها را به‌عنوان ماک‌های جدید ایجاد می‌کنند [#]_. دسترسی به همان ویژگی همیشه همان ماک را برمی‌گرداند. ماک‌ها نحوه استفاده شما از آن‌ها را ثبت می‌کنند و به شما امکان می‌دهند درباره آنچه کد شما با آن‌ها انجام داده است، ادعاهایی مطرح کنید." msgid ":class:`MagicMock` is a subclass of :class:`Mock` with all the magic methods pre-created and ready to use. There are also non-callable variants, useful when you are mocking out objects that aren't callable: :class:`NonCallableMock` and :class:`NonCallableMagicMock`" -msgstr ":class:`MagicMock` یک زیرکلاس از :class:`Mock` است که تمام متدهای ویژه آن از پیش ساخته‌شده‌اند و آماده استفاده هستند. همچنین گونه‌های غیرفراخوانی‌پذیر نیز وجود دارند که هنگام ماک‌کردن اشیایی که فراخوانی‌پذیر نیستند، مفید هستند: :class:`NonCallableMock` و :class:`NonCallableMagicMock`" +msgstr ":class:`MagicMock` یک زیرکلاس از :class:`Mock` است که تمام متدهای جادویی آن از پیش ساخته‌شده‌اند و آماده استفاده هستند. همچنین گونه‌های غیرفراخوانی‌پذیر نیز وجود دارند که هنگام ماک‌کردن اشیایی که فراخوانی‌پذیر نیستند، مفید هستند: :class:`NonCallableMock` و :class:`NonCallableMagicMock`" msgid "The :func:`patch` decorators makes it easy to temporarily replace classes in a particular module with a :class:`Mock` object. By default :func:`patch` will create a :class:`MagicMock` for you. You can specify an alternative class of :class:`Mock` using the *new_callable* argument to :func:`patch`." msgstr "دکوراتورهای :func:`patch` جایگزینی موقت کلاس‌ها در یک ماژول خاص با یک شیء :class:`Mock` را آسان می‌کنند. به‌طور پیش‌فرض، :func:`patch` یک :class:`MagicMock` برای شما ایجاد می‌کند. شما می‌توانید با استفاده از آرگومان *new_callable* در :func:`patch`، یک کلاس جایگزین برای :class:`Mock` را مشخص کنید." @@ -367,7 +367,7 @@ msgid "Members of :attr:`method_calls` are :data:`call` objects. These can be un msgstr "اعضای :attr:`method_calls` اشیای :data:`call` هستند. می‌توان آن‌ها را به‌صورت تاپل واگشایی کرد تا به آرگومان‌های جداگانه دسترسی پیدا کرد. :ref:`فراخوانی‌ها به‌صورت تاپل ` را ببینید." msgid ":attr:`mock_calls` records *all* calls to the mock object, its methods, magic methods *and* return value mocks." -msgstr ":attr:`mock_calls` *همه* فراخوانی‌ها به شیء ماک، متدهای آن، متدهای ویژه *و* ماک‌های مقدار بازگشتی را ثبت می‌کند." +msgstr ":attr:`mock_calls` *همه* فراخوانی‌ها به شیء ماک، متدهای آن، متدهای جادویی *و* ماک‌های مقدار بازگشتی را ثبت می‌کند." msgid "Members of :attr:`mock_calls` are :data:`call` objects. These can be unpacked as tuples to get at the individual arguments. See :ref:`calls as tuples `." msgstr "عناصر :attr:`mock_calls` اشیای :data:`call` هستند. می‌توانید این‌ها را به‌صورت تاپل واگشایی کنید تا به تک‌تک آرگومان‌ها دسترسی پیدا کنید. :ref:`فراخوانی‌ها به‌صورت تاپل ` را ببینید." @@ -388,7 +388,7 @@ msgid "Mock objects that use a class or an instance as a :attr:`!spec` or :attr: msgstr "اشیای ماک که از یک کلاس یا نمونه به‌عنوان :attr:`!spec` یا :attr:`!spec_set` استفاده می‌کنند، می‌توانند آزمون‌های :func:`isinstance` را بگذرانند:" msgid "The :class:`Mock` classes have support for mocking magic methods. See :ref:`magic methods ` for the full details." -msgstr "کلاس‌های :class:`Mock` از ماک کردن متدهای ویژه پشتیبانی می‌کنند. برای جزئیات کامل، :ref:`متدهای ویژه ` را ببینید." +msgstr "کلاس‌های :class:`Mock` از ماک کردن متدهای جادویی پشتیبانی می‌کنند. برای جزئیات کامل، :ref:`متدهای جادویی ` را ببینید." msgid "The mock classes and the :func:`patch` decorators all take arbitrary keyword arguments for configuration. For the :func:`patch` decorators the keywords are passed to the constructor of the mock being created. The keyword arguments are for configuring attributes of the mock:" msgstr "کلاس‌های ماک و دکوراتورهای :func:`patch` همگی آرگومان‌های کلیدواژه‌ای دلخواه را برای پیکربندی می‌پذیرند. در دکوراتورهای :func:`patch`، کلیدواژه‌ها به سازنده‌ی ماکِ در حال ایجاد ارسال می‌شوند. آرگومان‌های کلیدواژه‌ای برای پیکربندی ویژگی‌های ماک هستند:" @@ -721,7 +721,7 @@ msgstr "" "[call.child1('one'), call.child2('two')]" msgid "The only exceptions are magic methods and attributes (those that have leading and trailing double underscores). Mock doesn't create these but instead raises an :exc:`AttributeError`. This is because the interpreter will often implicitly request these methods, and gets *very* confused to get a new Mock object when it expects a magic method. If you need magic method support see :ref:`magic methods `." -msgstr "تنها استثناها متدها و ویژگی‌های جادویی هستند (آن‌هایی که در ابتدا و انتها دو زیرخط دارند). Mock این‌ها را ایجاد نمی‌کند، بلکه در عوض یک :exc:`AttributeError` پرتاب می‌کند. این به این دلیل است که مفسر اغلب این متدها را به‌طور ضمنی درخواست می‌کند و هنگامی که انتظار یک متد ویژه را دارد، دریافت یک شیء Mock جدید آن را *بسیار* سردرگم می‌کند. اگر به پشتیبانی از متدهای ویژه نیاز دارید، :ref:`متدهای ویژه ` را ببینید." +msgstr "تنها استثناها متدها و ویژگی‌های جادویی هستند (آن‌هایی که در ابتدا و انتها دو زیرخط دارند). Mock این‌ها را ایجاد نمی‌کند، بلکه در عوض یک :exc:`AttributeError` پرتاب می‌کند. این به این دلیل است که مفسر اغلب این متدها را به‌طور ضمنی درخواست می‌کند و هنگامی که انتظار یک متد جادویی را دارد، دریافت یک شیء Mock جدید آن را *بسیار* سردرگم می‌کند. اگر به پشتیبانی از متدهای جادویی نیاز دارید، :ref:`متدهای جادویی ` را ببینید." msgid "The patchers" msgstr "وصله‌کننده‌ها" @@ -1331,11 +1331,11 @@ msgid "" " -> some_function instantiates SomeClass" msgstr "" "a.py\n" -" -> SomeClass را تعریف می‌کند\n" +" -> Defines SomeClass\n" "\n" "b.py\n" " -> from a import SomeClass\n" -" -> some_function SomeClass را نمونه‌سازی می‌کند" +" -> some_function instantiates SomeClass" msgid "Now we want to test ``some_function`` but we want to mock out ``SomeClass`` using :func:`patch`. The problem is that when we import module b, which we will have to do when it imports ``SomeClass`` from module a. If we use :func:`patch` to mock out ``a.SomeClass`` then it will have no effect on our test; module b already has a reference to the *real* ``SomeClass`` and it looks like our patching had no effect." msgstr "اکنون می‌خواهیم ``some_function`` را آزمون کنیم، اما می‌خواهیم با استفاده از :func:`patch`، ``SomeClass`` را ماک کنیم. مشکل این است که وقتی ماژول b را ایمپورت می‌کنیم (که باید این کار را انجام دهیم)، این ماژول ``SomeClass`` را از ماژول a ایمپورت می‌کند. اگر از :func:`patch` برای ماک کردن ``a.SomeClass`` استفاده کنیم، تأثیری بر آزمون ما نخواهد داشت؛ ماژول b از قبل ارجاعی به ``SomeClass`` *واقعی* دارد و به نظر می‌رسد وصله کردن ما بی‌اثر بوده است." @@ -1359,31 +1359,31 @@ msgid "Both patch_ and patch.object_ correctly patch and restore descriptors: cl msgstr "هر دو patch_ و patch.object_ توصیف‌گرها را به‌درستی وصله و بازیابی می‌کنند: متدهای کلاس، متدهای ایستا و پراپرتی‌ها. شما باید این‌ها را به‌جای یک نمونه، روی *کلاس* وصله کنید. آن‌ها همچنین با *برخی* اشیایی که دسترسی به ویژگی‌ها را پراکسی می‌کنند، مانند `شیء تنظیمات Django `_ نیز کار می‌کنند." msgid "MagicMock and magic method support" -msgstr "پشتیبانی از MagicMock و متدهای ویژه" +msgstr "پشتیبانی از MagicMock و متدهای جادویی" msgid "Mocking Magic Methods" -msgstr "ماک کردن متدهای ویژه" +msgstr "ماک کردن متدهای جادویی" msgid ":class:`Mock` supports mocking the Python protocol methods, also known as :term:`\"magic methods\" `. This allows mock objects to replace containers or other objects that implement Python protocols." msgstr ":class:`Mock` از ماک کردن متدهای پروتکل پایتون، که با نام :term:`\"متدهای جادویی\" ` نیز شناخته می‌شوند، پشتیبانی می‌کند. این کار به اشیاء ماک اجازه می‌دهد جایگزین ظرف‌ها یا اشیاء دیگری شوند که پروتکل‌های پایتون را پیاده‌سازی می‌کنند." msgid "Because magic methods are looked up differently from normal methods [#]_, this support has been specially implemented. This means that only specific magic methods are supported. The supported list includes *almost* all of them. If there are any missing that you need please let us know." -msgstr "از آنجا که متدهای ویژه به‌شکل متفاوتی نسبت به متدهای عادی جستجو می‌شوند [#]_، این پشتیبانی به‌طور ویژه پیاده‌سازی شده است. این بدان معناست که تنها متدهای ویژه خاصی پشتیبانی می‌شوند. فهرست پشتیبانی‌شوده شامل *تقریباً* همه‌ی آن‌ها می‌شود. اگر موردی وجود ندارد که به آن نیاز دارید، لطفاً به ما اطلاع دهید." +msgstr "از آنجا که متدهای جادویی به‌شکل متفاوتی نسبت به متدهای عادی جستجو می‌شوند [#]_، این پشتیبانی به‌طور جادویی پیاده‌سازی شده است. این بدان معناست که تنها متدهای جادویی خاصی پشتیبانی می‌شوند. فهرست پشتیبانی‌شوده شامل *تقریباً* همه‌ی آن‌ها می‌شود. اگر موردی وجود ندارد که به آن نیاز دارید، لطفاً به ما اطلاع دهید." msgid "You mock magic methods by setting the method you are interested in to a function or a mock instance. If you are using a function then it *must* take ``self`` as the first argument [#]_." -msgstr "شما متدهای ویژه را با تنظیم متد مورد نظر خود به یک تابع یا یک نمونه ماک، ماک می‌کنید. اگر از یک تابع استفاده می‌کنید، آن تابع *باید* ``self`` را به‌عنوان اولین آرگومان دریافت کند [#]_." +msgstr "شما متدهای جادویی را با تنظیم متد مورد نظر خود به یک تابع یا یک نمونه ماک، ماک می‌کنید. اگر از یک تابع استفاده می‌کنید، آن تابع *باید* ``self`` را به‌عنوان اولین آرگومان دریافت کند [#]_." msgid "One use case for this is for mocking objects used as context managers in a :keyword:`with` statement:" msgstr "یکی از موارد استفاده‌ی این، ماک کردن اشیایی است که به‌عنوان مدیر زمینه در یک دستور :keyword:`with` استفاده می‌شوند:" msgid "Calls to magic methods do not appear in :attr:`~Mock.method_calls`, but they are recorded in :attr:`~Mock.mock_calls`." -msgstr "فراخوانی‌های متدهای ویژه در :attr:`~Mock.method_calls` ظاهر نمی‌شوند، اما در :attr:`~Mock.mock_calls` ثبت می‌شوند." +msgstr "فراخوانی‌های متدهای جادویی در :attr:`~Mock.method_calls` ظاهر نمی‌شوند، اما در :attr:`~Mock.mock_calls` ثبت می‌شوند." msgid "If you use the *spec* keyword argument to create a mock then attempting to set a magic method that isn't in the spec will raise an :exc:`AttributeError`." -msgstr "اگر برای ایجاد یک ماک از آرگومان کلیدواژه‌ای *spec* استفاده کنید، تلاش برای تنظیم یک متد ویژه که در spec وجود ندارد، باعث پرتاب استثنای :exc:`AttributeError` می‌شود." +msgstr "اگر برای ایجاد یک ماک از آرگومان کلیدواژه‌ای *spec* استفاده کنید، تلاش برای تنظیم یک متد جادویی که در spec وجود ندارد، باعث پرتاب استثنای :exc:`AttributeError` می‌شود." msgid "The full list of supported magic methods is:" -msgstr "فهرست کامل متدهای ویژه پشتیبانی‌شده عبارت است از:" +msgstr "فهرست کامل متدهای جادویی پشتیبانی‌شده عبارت است از:" msgid "``__hash__``, ``__sizeof__``, ``__repr__`` and ``__str__``" msgstr "``__hash__``، ``__sizeof__``، ``__repr__`` و ``__str__``" @@ -1446,13 +1446,13 @@ msgid "There are two ``MagicMock`` variants: :class:`MagicMock` and :class:`NonC msgstr "۲ گونه از ``MagicMock`` وجود دارد: :class:`MagicMock` و :class:`NonCallableMagicMock`." msgid "``MagicMock`` is a subclass of :class:`Mock` with default implementations of most of the :term:`magic methods `. You can use ``MagicMock`` without having to configure the magic methods yourself." -msgstr "``MagicMock`` زیرکلاسی از :class:`Mock` است که پیاده‌سازی‌های پیش‌فرضی برای بیشتر :term:`متدهای ویژه ` دارد. می‌توانید بدون اینکه خودتان متدهای ویژه را پیکربندی کنید، از ``MagicMock`` استفاده کنید." +msgstr "``MagicMock`` زیرکلاسی از :class:`Mock` است که پیاده‌سازی‌های پیش‌فرضی برای بیشتر :term:`متدهای جادویی ` دارد. می‌توانید بدون اینکه خودتان متدهای جادویی را پیکربندی کنید، از ``MagicMock`` استفاده کنید." msgid "The constructor parameters have the same meaning as for :class:`Mock`." msgstr "پارامترهای سازنده همان معنای پارامترهای :class:`Mock` را دارند." msgid "If you use the *spec* or *spec_set* arguments then *only* magic methods that exist in the spec will be created." -msgstr "اگر از آرگومان‌های *spec* یا *spec_set* استفاده کنید، *فقط* متدهای ویژه که در spec وجود دارند ایجاد می‌شوند." +msgstr "اگر از آرگومان‌های *spec* یا *spec_set* استفاده کنید، *فقط* متدهای جادویی که در spec وجود دارند ایجاد می‌شوند." msgid "A non-callable version of :class:`MagicMock`." msgstr "نسخه‌ای غیرفراخوانی‌پذیر از :class:`MagicMock`." @@ -1461,7 +1461,7 @@ msgid "The constructor parameters have the same meaning as for :class:`MagicMock msgstr "پارامترهای سازنده همان معنایی را دارند که برای :class:`MagicMock` دارند، به استثنای *return_value* و *side_effect* که برای یک ماک غیرفراخوانی‌پذیر معنایی ندارند." msgid "The magic methods are setup with :class:`MagicMock` objects, so you can configure them and use them in the usual way:" -msgstr "متدهای ویژه با اشیای :class:`MagicMock` راه‌اندازی شده‌اند، بنابراین می‌توانید آن‌ها را پیکربندی کنید و به روش معمول از آن‌ها استفاده کنید:" +msgstr "متدهای جادویی با اشیای :class:`MagicMock` راه‌اندازی شده‌اند، بنابراین می‌توانید آن‌ها را پیکربندی کنید و به روش معمول از آن‌ها استفاده کنید:" msgid "By default many of the protocol methods are required to return objects of a specific type. These methods are preconfigured with a default return value, so that they can be used without you having to do anything if you aren't interested in the return value. You can still *set* the return value manually if you want to change the default." msgstr "به‌طور پیش‌فرض، بسیاری از متدهای پروتکل باید اشیایی از یک نوع مشخص را برگردانند. این متدها از پیش با یک مقدار بازگشتی پیش‌فرض پیکربندی شده‌اند، به‌طوری که اگر به مقدار بازگشتی علاقه‌ای ندارید، می‌توانید بدون نیاز به انجام هیچ کاری از آن‌ها استفاده کنید. اگر بخواهید مقدار پیش‌فرض را تغییر دهید، همچنان می‌توانید مقدار بازگشتی را به‌صورت دستی *تنظیم* کنید." @@ -1552,10 +1552,10 @@ msgid "If the return value *is* an iterator, then iterating over it once will co msgstr "اگر مقدار بازگشتی یک پیمایش‌گر *باشد*، آنگاه پیمایش روی آن برای یک بار، آن را مصرف می‌کند و پیمایش‌های بعدی به یک فهرست خالی منجر می‌شوند:" msgid "``MagicMock`` has all of the supported magic methods configured except for some of the obscure and obsolete ones. You can still set these up if you want." -msgstr "``MagicMock`` تمام متدهای ویژه پشتیبانی‌شده را به‌صورت پیکربندی‌شده دارد، به‌جز برخی از موارد مبهم و منسوخ. همچنان در صورت تمایل می‌توانید آن‌ها را پیکربندی کنید." +msgstr "``MagicMock`` تمام متدهای جادویی پشتیبانی‌شده را به‌صورت پیکربندی‌شده دارد، به‌جز برخی از موارد مبهم و منسوخ. همچنان در صورت تمایل می‌توانید آن‌ها را پیکربندی کنید." msgid "Magic methods that are supported but not setup by default in ``MagicMock`` are:" -msgstr "متدهای ویژه که پشتیبانی می‌شوند اما به‌طور پیش‌فرض در ``MagicMock`` تنظیم نشده‌اند:" +msgstr "متدهای جادویی که پشتیبانی می‌شوند اما به‌طور پیش‌فرض در ``MagicMock`` تنظیم نشده‌اند:" msgid "``__subclasses__``" msgstr "``__subclasses__``" diff --git a/library/unittest.po b/library/unittest.po index d47b6bd7..24d113a8 100644 --- a/library/unittest.po +++ b/library/unittest.po @@ -1988,7 +1988,7 @@ msgid "``_makeResult()`` instantiates the class or callable passed in the ``Text msgstr "``_makeResult()`` کلاس یا فراخوانی‌پذیر گذرانده‌شده در سازنده‌ی ``TextTestRunner`` به‌عنوان آرگومان ``resultclass`` را نمونه‌سازی می‌کند. اگر ``resultclass`` ارائه‌نشده باشد، به‌طور پیش‌فرض :class:`TextTestResult` استفاده می‌شود. کلاس نتیجه با آرگومان‌های زیر نمونه‌سازی می‌شود::" msgid "stream, descriptions, verbosity" -msgstr "جریان، توضیحات، سطح جزئیات" +msgstr "stream, descriptions, verbosity" msgid "This method is the main public interface to the ``TextTestRunner``. This method takes a :class:`TestSuite` or :class:`TestCase` instance. A :class:`TestResult` is created by calling :func:`_makeResult` and the test(s) are run and the results printed to stdout." msgstr "این متد رابط عمومی اصلی برای ``TextTestRunner`` است. این متد یک نمونه از :class:`TestSuite` یا :class:`TestCase` دریافت می‌کند. یک :class:`TestResult` با فراخوانی :func:`_makeResult` ایجاد می‌شود و آزمون(ها) اجرا می‌شوند و نتایج در stdout چاپ می‌شوند." diff --git a/whatsnew/2.0.po b/whatsnew/2.0.po index d9777eb5..369e7351 100644 --- a/whatsnew/2.0.po +++ b/whatsnew/2.0.po @@ -414,7 +414,7 @@ msgid "A new format style is available when using the ``%`` operator; '%r' will msgstr "یک سبک قالب‌بندی جدید هنگام استفاده از عملگر ``%`` در دسترس است؛ '%r' خروجی :func:`repr` آرگومان خود را درج می‌کند. این مورد نیز با توجه به ملاحظات تقارن افزوده شد، این بار برای تقارن با سبک قالب‌بندی موجود '%s' که خروجی :func:`str` آرگومان خود را درج می‌کند. برای مثال، ``'%r %s' % ('abc', 'abc')`` رشته‌ای شامل ``'abc' abc`` را برمی‌گرداند." msgid "Previously there was no way to implement a class that overrode Python's built-in :keyword:`in` operator and implemented a custom version. ``obj in seq`` returns true if *obj* is present in the sequence *seq*; Python computes this by simply trying every index of the sequence until either *obj* is found or an :exc:`IndexError` is encountered. Moshe Zadka contributed a patch which adds a :meth:`!__contains__` magic method for providing a custom implementation for :keyword:`!in`. Additionally, new built-in objects written in C can define what :keyword:`!in` means for them via a new slot in the sequence protocol." -msgstr "پیش از این هیچ راهی برای پیاده‌سازی کلاسی وجود نداشت که عملگر توکار :keyword:`in` پایتون را بازنویسی کند و نسخه‌ی سفارشی آن را پیاده‌سازی کند. ``obj in seq`` در صورتی مقدار true برمی‌گرداند که *obj* در دنباله‌ی *seq* موجود باشد؛ پایتون این را صرفاً با امتحان کردن تک‌تک اندیس‌های دنباله محاسبه می‌کند تا زمانی که یا *obj* پیدا شود یا :exc:`IndexError` رخ دهد. Moshe Zadka وصلی ارائه کرد که متد ویژه‌ی :meth:`!__contains__` را برای فراهم کردن پیاده‌سازی سفارشی برای :keyword:`!in` اضافه می‌کند. علاوه بر این، اشیاء توکار جدیدی که به زبان C نوشته‌شده‌اند می‌توانند از طریق یک جایگاه جدید در پروتکل دنباله تعریف کنند که :keyword:`!in` برای آن‌ها به چه معناست." +msgstr "پیش از این هیچ راهی برای پیاده‌سازی کلاسی وجود نداشت که عملگر توکار :keyword:`in` پایتون را بازنویسی کند و نسخه‌ی سفارشی آن را پیاده‌سازی کند. ``obj in seq`` در صورتی مقدار true برمی‌گرداند که *obj* در دنباله‌ی *seq* موجود باشد؛ پایتون این را صرفاً با امتحان کردن تک‌تک اندیس‌های دنباله محاسبه می‌کند تا زمانی که یا *obj* پیدا شود یا :exc:`IndexError` رخ دهد. Moshe Zadka وصلی ارائه کرد که متد جادویی :meth:`!__contains__` را برای فراهم کردن پیاده‌سازی سفارشی برای :keyword:`!in` اضافه می‌کند. علاوه بر این، اشیاء توکار جدیدی که به زبان C نوشته‌شده‌اند می‌توانند از طریق یک جایگاه جدید در پروتکل دنباله تعریف کنند که :keyword:`!in` برای آن‌ها به چه معناست." msgid "Earlier versions of Python used a recursive algorithm for deleting objects. Deeply nested data structures could cause the interpreter to fill up the C stack and crash; Christian Tismer rewrote the deletion logic to fix this problem. On a related note, comparing recursive objects recursed infinitely and crashed; Jeremy Hylton rewrote the code to no longer crash, producing a useful result instead. For example, after this code::" msgstr "نسخه‌های قدیمی‌تر پایتون از یک الگوریتم بازگشتی برای حذف اشیاء استفاده می‌کردند. ساختارهای داده‌ی عمیقاً تودرتو می‌توانستند باعث شوند مفسر پشته‌ی C را پر کند و فروپاشی کند؛ Christian Tismer منطق حذف را برای رفع این مشکل بازنویسی کرد. در موضوعی مرتبط، مقایسه‌ی اشیاء بازگشتی به‌طور بی‌نهایت بازگشتی ادامه می‌یافت و منجر به فروپاشی می‌شد؛ Jeremy Hylton این کد را بازنویسی کرد تا دیگر فروپاشی نکند و در عوض نتیجه‌ی مفیدی تولید کند. برای مثال، پس از این کد::" diff --git a/whatsnew/2.1.po b/whatsnew/2.1.po index 96b2ee92..afd04ed4 100644 --- a/whatsnew/2.1.po +++ b/whatsnew/2.1.po @@ -156,7 +156,7 @@ msgid "In earlier versions, Python's support for implementing comparisons on use msgstr "در نسخه‌های پیشین، پشتیبانی پایتون از پیاده‌سازی مقایسه‌ها روی کلاس‌های تعریف‌شده توسط کاربر و نوع‌های توسعه‌ای بسیار ساده بود. کلاس‌ها می‌توانستند متد :meth:`!__cmp__` را پیاده‌سازی کنند که دو نمونه از یک کلاس به آن داده می‌شد و تنها می‌توانست در صورت برابر بودن آن‌ها مقدار 0 و در صورت برابر نبودن مقدار +1 یا -1 برگرداند؛ این متد نمی‌توانست استثنا مطرح کند یا چیزی غیر از یک مقدار بولی برگرداند. کاربران Numeric Python اغلب این مدل را بیش از حد ضعیف و محدودکننده می‌یافتند، زیرا در برنامه‌های محاسبات عددی سنگینی که Numeric Python برای آن‌ها به کار می‌رود، مفیدتر بود که بتوان مقایسه‌های درایه‌به‌درایه‌ی دو ماتریس را انجام داد و ماتریسی حاوی نتایج یک مقایسه‌ی مشخص برای هر درایه را برگرداند. اگر دو ماتریس اندازه‌های متفاوتی داشته باشند، مقایسه باید بتواند برای علامت‌دادن به خطا، استثنا مطرح کند." msgid "In Python 2.1, rich comparisons were added in order to support this need. Python classes can now individually overload each of the ``<``, ``<=``, ``>``, ``>=``, ``==``, and ``!=`` operations. The new magic method names are:" -msgstr "در پایتون 2.1، مقایسه‌های غنی (rich comparisons) به منظور پشتیبانی از این نیاز اضافه شدند. کلاس‌های پایتون اکنون می‌توانند هر یک از عملیات‌های ``<``، ``<=``، ``>``، ``>=``، ``==`` و ``!=`` را به‌طور جداگانه سربارگذاری کنند. نام‌های متدهای ویژه جدید عبارت‌اند از:" +msgstr "در پایتون 2.1، مقایسه‌های غنی (rich comparisons) به منظور پشتیبانی از این نیاز اضافه شدند. کلاس‌های پایتون اکنون می‌توانند هر یک از عملیات‌های ``<``، ``<=``، ``>``، ``>=``، ``==`` و ``!=`` را به‌طور جداگانه سربارگذاری کنند. نام‌های متدهای جادویی جدید عبارت‌اند از:" msgid "Operation" msgstr "عملیات" @@ -201,13 +201,13 @@ msgid ":meth:`~object.__ne__`" msgstr ":meth:`~object.__ne__`" msgid "(The magic methods are named after the corresponding Fortran operators ``.LT.``. ``.LE.``, &c. Numeric programmers are almost certainly quite familiar with these names and will find them easy to remember.)" -msgstr "(متدهای ویژه بر اساس عملگرهای متناظر فورترن ``.LT.``، ``.LE.`` و غیره نام‌گذاری شده‌اند. برنامه‌نویسان محاسبات عددی تقریباً به‌طور قطع با این نام‌ها کاملاً آشنا هستند و به‌سادگی آن‌ها را به یاد خواهند سپرد.)" +msgstr "(متدهای جادویی بر اساس عملگرهای متناظر فورترن ``.LT.``، ``.LE.`` و غیره نام‌گذاری شده‌اند. برنامه‌نویسان محاسبات عددی تقریباً به‌طور قطع با این نام‌ها کاملاً آشنا هستند و به‌سادگی آن‌ها را به یاد خواهند سپرد.)" msgid "Each of these magic methods is of the form ``method(self, other)``, where ``self`` will be the object on the left-hand side of the operator, while ``other`` will be the object on the right-hand side. For example, the expression ``A < B`` will cause ``A.__lt__(B)`` to be called." -msgstr "هر یک از این متدهای ویژه به شکل ``method(self, other)`` است، که در آن ``self`` شیء سمت چپ عملگر و ``other`` شیء سمت راست عملگر خواهد بود. برای مثال، عبارت ``A < B`` باعث می‌شود ``A.__lt__(B)`` فراخوانی شود." +msgstr "هر یک از این متدهای جادویی به شکل ``method(self, other)`` است، که در آن ``self`` شیء سمت چپ عملگر و ``other`` شیء سمت راست عملگر خواهد بود. برای مثال، عبارت ``A < B`` باعث می‌شود ``A.__lt__(B)`` فراخوانی شود." msgid "Each of these magic methods can return anything at all: a Boolean, a matrix, a list, or any other Python object. Alternatively they can raise an exception if the comparison is impossible, inconsistent, or otherwise meaningless." -msgstr "هر یک از این متدهای ویژه می‌تواند هر چیزی را بازگرداند: یک مقدار بولی، یک ماتریس، یک فهرست، یا هر شیء پایتون دیگری. از سوی دیگر، اگر مقایسه غیرممکن، ناسازگار یا به هر شکل بی‌معنا باشد، می‌توانند استثنا ایجاد کنند." +msgstr "هر یک از این متدهای جادویی می‌تواند هر چیزی را بازگرداند: یک مقدار بولی، یک ماتریس، یک فهرست، یا هر شیء پایتون دیگری. از سوی دیگر، اگر مقایسه غیرممکن، ناسازگار یا به هر شکل بی‌معنا باشد، می‌توانند استثنا ایجاد کنند." msgid "The built-in ``cmp(A,B)`` function can use the rich comparison machinery, and now accepts an optional argument specifying which comparison operation to use; this is given as one of the strings ``\"<\"``, ``\"<=\"``, ``\">\"``, ``\">=\"``, ``\"==\"``, or ``\"!=\"``. If called without the optional third argument, :func:`!cmp` will only return -1, 0, or +1 as in previous versions of Python; otherwise it will call the appropriate method and can return any Python object." msgstr "تابع توکار ``cmp(A,B)`` می‌تواند از سازوکار مقایسه‌ی غنی استفاده کند و اکنون یک آرگومان اختیاری می‌پذیرد که مشخص می‌کند از کدام عملیات مقایسه استفاده شود؛ این آرگومان به‌صورت یکی از رشته‌های ``\"<\"``، ``\"<=\"``، ``\">\"``، ``\">=\"``، ``\"==\"`` یا ``\"!=\"`` داده می‌شود. اگر بدون سومین آرگومان اختیاری فراخوانی شود، :func:`!cmp` مانند نسخه‌های قبلی پایتون فقط -۱، ۰ یا +۱ را برمی‌گرداند؛ در غیر این صورت، متد مناسب را فراخوانی می‌کند و می‌تواند هر شیء پایتونی را برگرداند." @@ -542,19 +542,19 @@ msgid "" " This package contains the following modules:\n" " ..." msgstr "" -"مستندات کتابخانه‌ی پایتون: بسته‌ی xml.dom در xml\n" +"Python Library Documentation: package xml.dom in xml\n" "\n" -"نام\n" -" xml.dom - پیاده‌سازی مدل شیء سند (DOM) W3C برای پایتون.\n" +"NAME\n" +" xml.dom - W3C Document Object Model implementation for Python.\n" "\n" -"پرونده\n" +"FILE\n" " /usr/local/lib/python2.1/xml/dom/__init__.pyc\n" "\n" -"توضیحات\n" -" نگاشت پایتون از مدل شیء سند (DOM) در مرجع کتابخانه‌ی پایتون،\n" -" در بخش مربوط به بسته‌ی xml.dom مستند شده است.\n" +"DESCRIPTION\n" +" The Python mapping of the Document Object Model is documented in the\n" +" Python Library Reference in the section on the xml.dom package.\n" "\n" -" این بسته شامل ماژول‌های زیر است:\n" +" This package contains the following modules:\n" " ..." msgid ":file:`pydoc` also includes a Tk-based interactive help browser. :file:`pydoc` quickly becomes addictive; try it out!" diff --git a/whatsnew/2.2.po b/whatsnew/2.2.po index 985d7337..4e063270 100644 --- a/whatsnew/2.2.po +++ b/whatsnew/2.2.po @@ -338,11 +338,11 @@ msgid "" msgstr "" "class C(object):\n" " def get_size (self):\n" -" result = ... محاسبات ...\n" +" result = ... computation ...\n" " return result\n" " def set_size (self, size):\n" -" ... بر اساس size چیزی محاسبه کنید\n" -" و وضعیت داخلی را به‌درستی تنظیم کنید ...\n" +" ... compute something based on the size\n" +" and set internal state appropriately ...\n" "\n" " # Define a property. The 'delete this attribute'\n" " # method is defined as None, so the attribute\n" diff --git a/whatsnew/2.3.po b/whatsnew/2.3.po index 95122a37..ea7bc525 100644 --- a/whatsnew/2.3.po +++ b/whatsnew/2.3.po @@ -786,13 +786,13 @@ msgid "Comma-separated format is deceptively simple at first glance::" msgstr "قالب جداشده با کاما در نگاه اول به‌طرزی فریبنده ساده به نظر می‌رسد::" msgid "Costs,150,200,3.95" -msgstr "هزینه‌ها,150,200,3.95" +msgstr "هزینه ها,150,200,3.95" msgid "Read a line and call ``line.split(',')``: what could be simpler? But toss in string data that can contain commas, and things get more complicated::" msgstr "یک سطر را بخوانید و ``line.split(',')`` را فراخوانی کنید: چه چیزی می‌تواند ساده‌تر از این باشد؟ اما وقتی داده‌ی رشته‌ای که می‌تواند شامل کاما باشد را به میان بیاورید، اوضاع پیچیده‌تر می‌شود::" msgid "\"Costs\",150,200,3.95,\"Includes taxes, shipping, and sundry items\"" -msgstr "\"هزینه‌ها\",150,200,3.95,\"شامل مالیات، ارسال و اقلام متفرقه\"" +msgstr "\"هزینه ها\",150,200,3.95,\"شامل مالیات، هزینه ارسال و اقلام متفرقه\"" msgid "A big ugly regular expression can parse this, but using the new :mod:`csv` package is much simpler::" msgstr "یک عبارت باقاعده‌ی بزرگ و زشت می‌تواند این را پارس کند، اما استفاده از بسته‌ی جدید :mod:`csv` بسیار ساده‌تر است::" diff --git a/whatsnew/2.4.po b/whatsnew/2.4.po index 79497141..cfe845ea 100644 --- a/whatsnew/2.4.po +++ b/whatsnew/2.4.po @@ -181,7 +181,7 @@ msgid "print sum(obj.count for obj in list_all_objects())" msgstr "print sum(obj.count for obj in list_all_objects())" msgid "Generator expressions differ from list comprehensions in various small ways. Most notably, the loop variable (*obj* in the above example) is not accessible outside of the generator expression. List comprehensions leave the variable assigned to its last value; future versions of Python will change this, making list comprehensions match generator expressions in this respect." -msgstr "عبارت‌های تولیدگر از درک‌های فهرستی در جنبه‌های کوچک گوناگونی تفاوت دارند. چشمگیرترین تفاوت این است که متغیر حلقه (*obj* در مثال بالا) خارج از عبارت تولیدگر قابل دسترسی نیست. درک‌های فهرستی متغیر را به آخرین مقدارش منتسب باقی می‌گذارند؛ نسخه‌های آینده پایتون این رفتار را تغییر خواهند داد تا درک‌های فهرستی از این نظر با عبارت‌های تولیدگر مطابقت داشته باشند." +msgstr "عبارت‌های تولیدگر از درک‌های فهرستی در جنبه‌های کوچک گوناگونی تفاوت دارند. چشمگیرترین تفاوت این است که متغیر حلقه (\*obj\* در مثال بالا) خارج از عبارت تولیدگر قابل دسترسی نیست. درک‌های فهرستی متغیر را به آخرین مقدارش منتسب باقی می‌گذارند؛ نسخه‌های آینده پایتون این رفتار را تغییر خواهند داد تا درک‌های فهرستی از این نظر با عبارت‌های تولیدگر مطابقت داشته باشند." msgid ":pep:`289` - Generator Expressions" msgstr ":pep:`289` - عبارت‌های تولیدگر" @@ -263,10 +263,10 @@ msgid "If the method was very long, it would be easy to miss or forget the :func msgstr "اگر متد بسیار طولانی بود، به‌راحتی ممکن بود فراخوانی :func:`classmethod` را پس از بدنه تابع نادیده بگیرید یا فراموش کنید." msgid "The intention was always to add some syntax to make such definitions more readable, but at the time of 2.2's release a good syntax was not obvious. Today a good syntax *still* isn't obvious but users are asking for easier access to the feature; a new syntactic feature has been added to meet this need." -msgstr "قصد همیشه این بود که نحوی برای خواناتر کردن چنین تعریف‌هایی افزوده شود، اما در زمان انتشار نسخه‌ی 2.2، سینتکس خوبی بدیهی نبود. امروز نیز *هنوز* سینتکس خوبی بدیهی نیست، اما کاربران خواستار دسترسی آسان‌تر به این قابلیت هستند؛ برای برآورده کردن این نیاز، قابلیت نحوی جدیدی افزوده شده است." +msgstr "قصد همیشه این بود که نحوی برای خواناتر کردن چنین تعریف‌هایی افزوده شود، اما در زمان انتشار نسخه‌ی 2.2، سینتکس خوبی بدیهی نبود. امروز نیز \*هنوز\* سینتکس خوبی بدیهی نیست، اما کاربران خواستار دسترسی آسان‌تر به این قابلیت هستند؛ برای برآورده کردن این نیاز، قابلیت نحوی جدیدی افزوده شده است." msgid "The new feature is called \"function decorators\". The name comes from the idea that :func:`classmethod`, :func:`staticmethod`, and friends are storing additional information on a function object; they're *decorating* functions with more details." -msgstr "این ویژگی جدید «آراینده‌های تابع» نامیده می‌شود. این نام از ایده‌ای سرچشمه می‌گیرد که :func:`classmethod`، :func:`staticmethod` و مشابه‌های آن‌ها اطلاعات اضافی را روی یک شیء تابع ذخیره می‌کنند؛ آن‌ها توابع را با جزئیات بیشتر *می‌آرایند*." +msgstr "این ویژگی جدید «آراینده‌های تابع» نامیده می‌شود. این نام از ایده‌ای سرچشمه می‌گیرد که :func:`classmethod`، :func:`staticmethod` و مشابه‌های آن‌ها اطلاعات اضافی را روی یک شیء تابع ذخیره می‌کنند؛ آن‌ها توابع را با جزئیات بیشتر \*می‌آرایند\*." msgid "The notation borrows from Java and uses the ``'@'`` character as an indicator. Using the new syntax, the example above would be written::" msgstr "نمادگذاری از جاوا وام گرفته شده و از نویسه ``'@'`` به‌عنوان نشانگر استفاده می‌کند. با استفاده از سینتکس جدید، مثال بالا به صورت زیر نوشته می‌شود::" @@ -481,31 +481,31 @@ msgstr "" " startupinfo=None, creationflags=0):" msgid "*args* is commonly a sequence of strings that will be the arguments to the program executed as the subprocess. (If the *shell* argument is true, *args* can be a string which will then be passed on to the shell for interpretation, just as :func:`os.system` does.)" -msgstr "*args* معمولاً دنباله‌ای از رشته‌ها است که آرگومان‌های برنامه‌ی اجرا‌شده به‌عنوان زیرفرایند خواهند بود. (اگر آرگومان *shell* درست باشد، *args* می‌تواند یک رشته باشد که آن‌گاه برای تفسیر به پوسته سپرده می‌شود، دقیقاً همان‌طور که :func:`os.system` انجام می‌دهد.)" +msgstr "\*args\* معمولاً دنباله‌ای از رشته‌ها است که آرگومان‌های برنامه‌ی اجرا‌شده به‌عنوان زیرفرایند خواهند بود. (اگر آرگومان \*shell\* درست باشد، \*args\* می‌تواند یک رشته باشد که آن‌گاه برای تفسیر به پوسته سپرده می‌شود، دقیقاً همان‌طور که :func:`os.system` انجام می‌دهد.)" msgid "*stdin*, *stdout*, and *stderr* specify what the subprocess's input, output, and error streams will be. You can provide a file object or a file descriptor, or you can use the constant ``subprocess.PIPE`` to create a pipe between the subprocess and the parent." -msgstr "*stdin*، *stdout* و *stderr* تعیین می‌کنند که جریان‌های ورودی، خروجی و خطای زیرفرایند چه خواهند بود. شما می‌توانید یک شیء پرونده یا یک توصیف‌گر پرونده فراهم کنید، یا می‌توانید از ثابت ``subprocess.PIPE`` برای ایجاد یک پایپ بین زیرفرایند و والد استفاده کنید." +msgstr "\*stdin\*، \*stdout\* و \*stderr\* تعیین می‌کنند که جریان‌های ورودی، خروجی و خطای زیرفرایند چه خواهند بود. شما می‌توانید یک شیء پرونده یا یک توصیف‌گر پرونده فراهم کنید، یا می‌توانید از ثابت ``subprocess.PIPE`` برای ایجاد یک پایپ بین زیرفرایند و والد استفاده کنید." msgid "The constructor has a number of handy options:" msgstr "سازنده تعدادی گزینه‌ی کاربردی دارد:" msgid "*close_fds* requests that all file descriptors be closed before running the subprocess." -msgstr "*close_fds* درخواست می‌کند که تمام توصیف‌گرهای پرونده پیش از اجرای زیرفرایند بسته شوند." +msgstr "\*close_fds\* درخواست می‌کند که تمام توصیف‌گرهای پرونده پیش از اجرای زیرفرایند بسته شوند." msgid "*cwd* specifies the working directory in which the subprocess will be executed (defaulting to whatever the parent's working directory is)." -msgstr "*cwd* پوشه کاری‌ای را مشخص می‌کند که زیرفرایند در آن اجرا خواهد شد (به‌طور پیش‌فرض، همان پوشه کاری فرایند والد)." +msgstr "\*cwd\* پوشه کاری‌ای را مشخص می‌کند که زیرفرایند در آن اجرا خواهد شد (به‌طور پیش‌فرض، همان پوشه کاری فرایند والد)." msgid "*env* is a dictionary specifying environment variables." -msgstr "*env* یک دیکشنری است که متغیرهای محیطی را مشخص می‌کند." +msgstr "\*env\* یک دیکشنری است که متغیرهای محیطی را مشخص می‌کند." msgid "*preexec_fn* is a function that gets called before the child is started." -msgstr "*preexec_fn* تابعی است که پیش از راه‌اندازی فرزند فراخوانی می‌شود." +msgstr "\*preexec_fn\* تابعی است که پیش از راه‌اندازی فرزند فراخوانی می‌شود." msgid "*universal_newlines* opens the child's input and output using Python's :term:`universal newlines` feature." -msgstr "*universal_newlines* ورودی و خروجی فرزند را با استفاده از قابلیت :term:`سطرهای جدید همگانی ` پایتون باز می‌کند." +msgstr "\*universal_newlines\* ورودی و خروجی فرزند را با استفاده از قابلیت :term:`سطرهای جدید همگانی ` پایتون باز می‌کند." msgid "Once you've created the :class:`~subprocess.Popen` instance, you can call its :meth:`~subprocess.Popen.wait` method to pause until the subprocess has exited, :meth:`~subprocess.Popen.poll` to check if it's exited without pausing, or ``communicate(data)`` to send the string *data* to the subprocess's standard input. ``communicate(data)`` then reads any data that the subprocess has sent to its standard output or standard error, returning a tuple ``(stdout_data, stderr_data)``." -msgstr "پس از ایجاد نمونه‌ی :class:`~subprocess.Popen`، می‌توانید متد :meth:`~subprocess.Popen.wait` آن را برای توقف تا زمانی که زیرفرایند خارج شود، :meth:`~subprocess.Popen.poll` را برای بررسی بدون توقف اینکه آیا زیرفرایند خارج شده است یا نه، یا ``communicate(data)`` را برای ارسال رشته‌ی *data* به ورودی استاندارد زیرفرایند فراخوانی کنید. سپس ``communicate(data)`` هر داده‌ای را که زیرفرایند به خروجی استاندارد یا خطای استاندارد خود فرستاده است می‌خواند و تاپل ``(stdout_data, stderr_data)`` را برمی‌گرداند." +msgstr "پس از ایجاد نمونه‌ی :class:`~subprocess.Popen`، می‌توانید متد :meth:`~subprocess.Popen.wait` آن را برای توقف تا زمانی که زیرفرایند خارج شود، :meth:`~subprocess.Popen.poll` را برای بررسی بدون توقف اینکه آیا زیرفرایند خارج شده است یا نه، یا ``communicate(data)`` را برای ارسال رشته‌ی \*data\* به ورودی استاندارد زیرفرایند فراخوانی کنید. سپس ``communicate(data)`` هر داده‌ای را که زیرفرایند به خروجی استاندارد یا خطای استاندارد خود فرستاده است می‌خواند و تاپل ``(stdout_data, stderr_data)`` را برمی‌گرداند." msgid ":func:`~subprocess.call` is a shortcut that passes its arguments along to the :class:`~subprocess.Popen` constructor, waits for the command to complete, and returns the status code of the subprocess. It can serve as a safer analog to :func:`os.system`::" msgstr ":func:`~subprocess.call` یک میان‌بر است که آرگومان‌های خود را به سازنده‌ی :class:`~subprocess.Popen` پاس می‌دهد، منتظر تکمیل فرمان می‌ماند و کد وضعیت زیرفرایند را برمی‌گرداند. می‌تواند به‌عنوان معادل امن‌تری برای :func:`os.system` عمل کند::" @@ -810,7 +810,7 @@ msgid "PEP 328: Multi-line Imports" msgstr "PEP 328: ایمپورت‌های چندسطری" msgid "One language change is a small syntactic tweak aimed at making it easier to import many names from a module. In a ``from module import names`` statement, *names* is a sequence of names separated by commas. If the sequence is very long, you can either write multiple imports from the same module, or you can use backslashes to escape the line endings like this::" -msgstr "یکی از تغییرات زبان، اصلاح کوچکی در سینتکس است که هدف آن آسان‌تر کردن ایمپورت نام‌های متعدد از یک ماژول است. در دستور ``from module import names``، *names* دنباله‌ای از نام‌ها است که با کاما از هم جدا شده‌اند. اگر این دنباله بسیار طولانی باشد، می‌توانید یا چند ایمپورت از همان ماژول بنویسید، یا برای خنثی کردن انتهای سطرها از بک‌اسلش‌ها استفاده کنید، به این شکل::" +msgstr "یکی از تغییرات زبان، اصلاح کوچکی در سینتکس است که هدف آن آسان‌تر کردن ایمپورت نام‌های متعدد از یک ماژول است. در دستور ``from module import names``، \*names\* دنباله‌ای از نام‌ها است که با کاما از هم جدا شده‌اند. اگر این دنباله بسیار طولانی باشد، می‌توانید یا چند ایمپورت از همان ماژول بنویسید، یا برای خنثی کردن انتهای سطرها از بک‌اسلش‌ها استفاده کنید، به این شکل::" msgid "" "from SimpleXMLRPCServer import SimpleXMLRPCServer,\\\n" @@ -915,13 +915,13 @@ msgstr "" "['www.python', 'org']" msgid "Three keyword parameters, *cmp*, *key*, and *reverse*, were added to the :meth:`~list.sort` method of lists. These parameters make some common usages of :meth:`~list.sort` simpler. All of these parameters are optional." -msgstr "سه پارامتر کلیدواژه‌ای، *cmp*، *key* و *reverse*، به متد :meth:`~list.sort` فهرست‌ها افزوده شدند. این پارامترها برخی از کاربردهای رایج :meth:`~list.sort` را ساده‌تر می‌کنند. همه‌ی این پارامترها اختیاری هستند." +msgstr "سه پارامتر کلیدواژه‌ای، \*cmp\*، \*key\* و \*reverse\*، به متد :meth:`~list.sort` فهرست‌ها افزوده شدند. این پارامترها برخی از کاربردهای رایج :meth:`~list.sort` را ساده‌تر می‌کنند. همه‌ی این پارامترها اختیاری هستند." msgid "For the *cmp* parameter, the value should be a comparison function that takes two parameters and returns -1, 0, or +1 depending on how the parameters compare. This function will then be used to sort the list. Previously this was the only parameter that could be provided to :meth:`~list.sort`." -msgstr "برای پارامتر *cmp*، مقدار باید یک تابع مقایسه باشد که دو پارامتر می‌گیرد و بسته به نحوه مقایسه پارامترها، -1، 0 یا +1 را برمی‌گرداند. سپس از این تابع برای مرتب‌سازی فهرست استفاده خواهد شد. پیش‌تر این تنها پارامتری بود که می‌توان به :meth:`~list.sort` ارائه داد." +msgstr "برای پارامتر \*cmp\*، مقدار باید یک تابع مقایسه باشد که دو پارامتر می‌گیرد و بسته به نحوه مقایسه پارامترها، -1، 0 یا +1 را برمی‌گرداند. سپس از این تابع برای مرتب‌سازی فهرست استفاده خواهد شد. پیش‌تر این تنها پارامتری بود که می‌توان به :meth:`~list.sort` ارائه داد." msgid "*key* should be a single-parameter function that takes a list element and returns a comparison key for the element. The list is then sorted using the comparison keys. The following example sorts a list case-insensitively::" -msgstr "*key* باید تابعی تک‌پارامتری باشد که یک عنصر فهرست را دریافت می‌کند و کلید مقایسه‌ای برای آن عنصر برمی‌گرداند. سپس فهرست با استفاده از کلیدهای مقایسه مرتب می‌شود. مثال زیر یک فهرست را بدون حساسیت به بزرگی و کوچکی حروف مرتب می‌کند::" +msgstr "\*key\* باید تابعی تک‌پارامتری باشد که یک عنصر فهرست را دریافت می‌کند و کلید مقایسه‌ای برای آن عنصر برمی‌گرداند. سپس فهرست با استفاده از کلیدهای مقایسه مرتب می‌شود. مثال زیر یک فهرست را بدون حساسیت به بزرگی و کوچکی حروف مرتب می‌کند::" msgid "" ">>> L = ['A', 'b', 'c', 'D']\n" @@ -951,7 +951,7 @@ msgstr "" "['A', 'b', 'c', 'D']" msgid "The last example, which uses the *cmp* parameter, is the old way to perform a case-insensitive sort. It works but is slower than using a *key* parameter. Using *key* calls :meth:`~str.lower` method once for each element in the list while using *cmp* will call it twice for each comparison, so using *key* saves on invocations of the :meth:`~str.lower` method." -msgstr "آخرین مثال، که از پارامتر *cmp* استفاده می‌کند، روش قدیمی برای انجام مرتب‌سازی بدون توجه به بزرگی و کوچکی حروف است. این روش کار می‌کند اما کندتر از استفاده از پارامتر *key* است. استفاده از *key* متد :meth:`~str.lower` را برای هر عنصر در فهرست یک بار فراخوانی می‌کند، در حالی که استفاده از *cmp* آن را برای هر مقایسه دو بار فراخوانی می‌کند؛ بنابراین استفاده از *key* در فراخوانی‌های متد :meth:`~str.lower` صرفه‌جویی می‌کند." +msgstr "آخرین مثال، که از پارامتر \*cmp\* استفاده می‌کند، روش قدیمی برای انجام مرتب‌سازی بدون توجه به بزرگی و کوچکی حروف است. این روش کار می‌کند اما کندتر از استفاده از پارامتر \*key\* است. استفاده از \*key\* متد :meth:`~str.lower` را برای هر عنصر در فهرست یک بار فراخوانی می‌کند، در حالی که استفاده از \*cmp\* آن را برای هر مقایسه دو بار فراخوانی می‌کند؛ بنابراین استفاده از \*key\* در فراخوانی‌های متد :meth:`~str.lower` صرفه‌جویی می‌کند." msgid "For simple key functions and comparison functions, it is often possible to avoid a :keyword:`lambda` expression by using an unbound method instead. For example, the above case-insensitive sort is best written as::" msgstr "برای توابع کلید ساده و توابع مقایسه، اغلب می‌توان از عبارت :keyword:`lambda` اجتناب کرد و به جای آن از یک متد غیرمقید (unbound method) استفاده نمود. برای مثال، مرتب‌سازی بدون حساسیت به بزرگی و کوچکی حروف بالا را بهتر است به این صورت بنویسید::" @@ -966,7 +966,7 @@ msgstr "" "['A', 'b', 'c', 'D']" msgid "Finally, the *reverse* parameter takes a Boolean value. If the value is true, the list will be sorted into reverse order. Instead of ``L.sort(); L.reverse()``, you can now write ``L.sort(reverse=True)``." -msgstr "در نهایت، پارامتر *reverse* یک مقدار بولی می‌گیرد. اگر مقدار درست باشد، فهرست به ترتیب معکوس مرتب می‌شود. به جای ``L.sort(); L.reverse()`` می‌توانید اکنون ``L.sort(reverse=True)`` بنویسید." +msgstr "در نهایت، پارامتر \*reverse\* یک مقدار بولی می‌گیرد. اگر مقدار درست باشد، فهرست به ترتیب معکوس مرتب می‌شود. به جای ``L.sort(); L.reverse()`` می‌توانید اکنون ``L.sort(reverse=True)`` بنویسید." msgid "The results of sorting are now guaranteed to be stable. This means that two entries with equal keys will be returned in the same order as they were input. For example, you can sort a list of people by name, and then sort the list by age, resulting in a list sorted by age where people with the same age are in name-sorted order." msgstr "اکنون تضمین می‌شود که نتایج مرتب‌سازی پایدار باشند. این بدان معناست که دو ورودی با کلیدهای برابر، به همان ترتیبی که وارد شده بودند بازگردانده می‌شوند. برای مثال، می‌توانید فهرستی از افراد را بر اساس نام مرتب کنید و سپس فهرست را بر اساس سن مرتب کنید؛ در نتیجه، فهرستی مرتب‌شده بر اساس سن به دست می‌آید که در آن افراد هم‌سن به ترتیب نام مرتب شده‌اند." @@ -1035,7 +1035,7 @@ msgid "The interpreter gained a new switch, :option:`-m`, that takes a name, sea msgstr "مفسر سوییچ جدیدی به نام :option:`-m` گرفت که نامی را دریافت می‌کند، ماژول متناظر را در ``sys.path`` جست‌وجو می‌کند و ماژول را به‌عنوان اسکریپت اجرا می‌کند. برای مثال، اکنون می‌توانید پروفایل‌گیر پایتون را با ``python -m profile`` اجرا کنید. (مشارکت‌شده توسط Nick Coghlan.)" msgid "The ``eval(expr, globals, locals)`` and ``execfile(filename, globals, locals)`` functions and the ``exec`` statement now accept any mapping type for the *locals* parameter. Previously this had to be a regular Python dictionary. (Contributed by Raymond Hettinger.)" -msgstr "توابع ``eval(expr, globals, locals)`` و ``execfile(filename, globals, locals)`` و دستور ``exec`` اکنون هر نوع نگاشتی را برای پارامتر *locals* می‌پذیرند. پیش‌تر این باید یک دیکشنری معمولی پایتون می‌بود. (ارائه‌شده توسط ریموند هتینگر.)" +msgstr "توابع ``eval(expr, globals, locals)`` و ``execfile(filename, globals, locals)`` و دستور ``exec`` اکنون هر نوع نگاشتی را برای پارامتر \*locals\* می‌پذیرند. پیش‌تر این باید یک دیکشنری معمولی پایتون می‌بود. (ارائه‌شده توسط ریموند هتینگر.)" msgid "The :func:`zip` built-in function and :func:`!itertools.izip` now return an empty list if called with no arguments. Previously they raised a :exc:`TypeError` exception. This makes them more suitable for use with variable length argument lists::" msgstr "تابع توکار :func:`zip` و :func:`!itertools.izip` اکنون در صورت فراخوانی بدون آرگومان، فهرست خالی برمی‌گردانند. پیش‌تر این توابع استثنای :exc:`TypeError` ایجاد می‌کردند. این امر آن‌ها را برای استفاده در فهرست‌های آرگومان با طول متغیر مناسب‌تر می‌کند::" @@ -1097,7 +1097,7 @@ msgid "As usual, Python's standard library received a number of enhancements and msgstr "طبق معمول، کتابخانه استاندارد پایتون تعدادی بهبود و رفع اشکال دریافت کرد. در ادامه، فهرست ناقصی از مهم‌ترین تغییرات، مرتب‌شده به ترتیب الفبایی بر اساس نام ماژول، ارائه می‌شود. برای فهرست کامل‌تری از تغییرات، به پرونده‌ی :file:`Misc/NEWS` در درخت منبع مراجعه کنید، یا برای همه‌ی جزئیات، گزارش‌های CVS را بررسی کنید." msgid "The :mod:`!asyncore` module's :func:`!loop` function now has a *count* parameter that lets you perform a limited number of passes through the polling loop. The default is still to loop forever." -msgstr "تابع :func:`!loop` ماژول :mod:`!asyncore` اکنون یک پارامتر *count* دارد که به شما امکان می‌دهد تعداد محدودی گذر از حلقه پایش را انجام دهید. پیش‌فرض همچنان این است که حلقه برای همیشه اجرا شود." +msgstr "تابع :func:`!loop` ماژول :mod:`!asyncore` اکنون یک پارامتر \*count\* دارد که به شما امکان می‌دهد تعداد محدودی گذر از حلقه پایش را انجام دهید. پیش‌فرض همچنان این است که حلقه برای همیشه اجرا شود." msgid "The :mod:`base64` module now has more complete :rfc:`3548` support for Base64, Base32, and Base16 encoding and decoding, including optional case folding and optional alternative alphabets. (Contributed by Barry Warsaw.)" msgstr "ماژول :mod:`base64` اکنون پشتیبانی کامل‌تری از :rfc:`3548` برای کدگذاری و کدگشایی Base64، Base32 و Base16 دارد، از جمله تا کردن اختیاری بزرگی و کوچکی حروف (case folding) و الفباهای جایگزین اختیاری. (مشارکت از سوی Barry Warsaw.)" @@ -1167,7 +1167,7 @@ msgid "Several modules, such as the :mod:`queue` and :mod:`threading` modules, n msgstr "چندین ماژول، مانند ماژول‌های :mod:`queue` و :mod:`threading`، اکنون برای بهبود کارایی از :class:`collections.deque` بهره می‌برند. (با مشارکت Raymond Hettinger.)" msgid "The :mod:`ConfigParser ` classes have been enhanced slightly. The :meth:`~configparser.ConfigParser.read` method now returns a list of the files that were successfully parsed, and the :meth:`~configparser.ConfigParser.set` method raises :exc:`TypeError` if passed a *value* argument that isn't a string. (Contributed by John Belmonte and David Goodger.)" -msgstr "کلاس‌های :mod:`ConfigParser ` کمی بهبود یافته‌اند. متد :meth:`~configparser.ConfigParser.read` اکنون فهرستی از پرونده‌هایی که با موفقیت تجزیه شده‌اند را برمی‌گرداند، و متد :meth:`~configparser.ConfigParser.set` در صورتی که آرگومان *value*‌ای که رشته نیست به آن ارسال شود، استثنای :exc:`TypeError` ایجاد می‌کند. (مشارکت توسط John Belmonte و David Goodger.)" +msgstr "کلاس‌های :mod:`ConfigParser ` کمی بهبود یافته‌اند. متد :meth:`~configparser.ConfigParser.read` اکنون فهرستی از پرونده‌هایی که با موفقیت تجزیه شده‌اند را برمی‌گرداند، و متد :meth:`~configparser.ConfigParser.set` در صورتی که آرگومان \*value\*‌ای که رشته نیست به آن ارسال شود، استثنای :exc:`TypeError` ایجاد می‌کند. (مشارکت توسط John Belmonte و David Goodger.)" msgid "The :mod:`curses` module now supports the ncurses extension :func:`~curses.use_default_colors`. On platforms where the terminal supports transparency, this makes it possible to use a transparent background. (Contributed by Jörg Lehmann.)" msgstr "ماژول :mod:`curses` اکنون از افزونه‌ی ncurses با نام :func:`~curses.use_default_colors` پشتیبانی می‌کند. در پلتفرم‌هایی که پایانه از شفافیت پشتیبانی می‌کند، این امکان را فراهم می‌کند که از پس‌زمینه‌ی شفاف استفاده کنید. (مشارکت‌شده توسط Jörg Lehmann.)" @@ -1188,10 +1188,10 @@ msgid "The :mod:`imaplib` module now supports IMAP's THREAD command (contributed msgstr "ماژول :mod:`imaplib` اکنون از فرمان THREAD در IMAP (با مشارکت Yves Dionne) و متدهای جدید :meth:`~imaplib.IMAP4.deleteacl` و :meth:`~imaplib.IMAP4.myrights` (با مشارکت Arnaud Mazin) پشتیبانی می‌کند." msgid "The :mod:`itertools` module gained a ``groupby(iterable[, *func*])`` function. *iterable* is something that can be iterated over to return a stream of elements, and the optional *func* parameter is a function that takes an element and returns a key value; if omitted, the key is simply the element itself. :func:`~itertools.groupby` then groups the elements into subsequences which have matching values of the key, and returns a series of 2-tuples containing the key value and an iterator over the subsequence." -msgstr "تابع ``groupby(iterable[, *func*])`` به ماژول :mod:`itertools` اضافه شد. *iterable* چیزی است که می‌توان روی آن پیمایش کرد تا جریانی از عناصر را برگرداند، و پارامتر اختیاری *func* تابعی است که یک عنصر را دریافت می‌کند و یک مقدار کلید برمی‌گرداند؛ اگر ذکر نشود، کلید به سادگی خودِ عنصر است. سپس :func:`~itertools.groupby` عناصر را به زیردنباله‌هایی گروه‌بندی می‌کند که مقدار کلید یکسانی دارند، و دنباله‌ای از تاپل‌های دوتایی شامل مقدار کلید و پیمایش‌گری بر روی زیردنباله برمی‌گرداند." +msgstr "تابع ``groupby(iterable[, *func*])`` به ماژول :mod:`itertools` اضافه شد. *iterable* چیزی است که می‌توان روی آن پیمایش کرد تا جریانی از عناصر را برگرداند، و پارامتر اختیاری *func* تابعی است که یک عنصر را دریافت می‌کند و یک مقدار کلید برمی‌گرداند؛ اگر ذکر نشود، کلید به‌سادگی خودِ عنصر است. سپس :func:`~itertools.groupby` عناصر را به زیردنباله‌هایی گروه‌بندی می‌کند که مقدار کلید یکسانی دارند، و دنباله‌ای از تاپل‌های دوتایی شامل مقدار کلید و پیمایش‌گری بر روی زیردنباله برمی‌گرداند." msgid "Here's an example to make this clearer. The *key* function simply returns whether a number is even or odd, so the result of :func:`~itertools.groupby` is to return consecutive runs of odd or even numbers. ::" -msgstr "در اینجا مثالی برای شفاف‌تر شدن موضوع آورده شده است. تابع *کلید* صرفاً برمی‌گرداند که یک عدد زوج است یا فرد؛ بنابراین نتیجه‌ی :func:`~itertools.groupby` بازگرداندن دنباله‌های متوالی از اعداد فرد یا زوج است. ::" +msgstr "در اینجا مثالی برای شفاف‌تر شدن موضوع آورده شده است. تابع \*کلید\* صرفاً برمی‌گرداند که یک عدد زوج است یا فرد؛ بنابراین نتیجه‌ی :func:`~itertools.groupby` بازگرداندن دنباله‌های متوالی از اعداد فرد یا زوج است. ::" msgid "" ">>> import itertools\n" @@ -1264,7 +1264,7 @@ msgid "(Contributed by Hye-Shik Chang.)" msgstr "(مشارکت‌شده توسط Hye-Shik Chang.)" msgid ":mod:`itertools` also gained a function named ``tee(iterator, N)`` that returns *N* independent iterators that replicate *iterator*. If *N* is omitted, the default is 2. ::" -msgstr ":mod:`itertools` همچنین تابعی به نام ``tee(iterator, N)`` به دست آورد که *N* پیمایش‌گر مستقل را برمی‌گرداند که *iterator* را بازتولید می‌کنند. اگر *N* ذکر نشود، مقدار پیش‌فرض ۲ است. ::" +msgstr ":mod:`itertools` همچنین تابعی به نام ``tee(iterator, N)`` به دست آورد که \*N\* پیمایش‌گر مستقل را برمی‌گرداند که \*iterator\* را بازتولید می‌کنند. اگر \*N\* ذکر نشود، مقدار پیش‌فرض ۲ است. ::" msgid "" ">>> L = [1,2,3]\n" @@ -1344,10 +1344,10 @@ msgid "The long-term plan is to deprecate the :mod:`!rfc822` module in some futu msgstr "برنامه‌ی بلندمدت این است که ماژول :mod:`!rfc822` در نسخه‌ای آینده از پایتون به نفع بسته‌ی :mod:`email` منسوخ شود. به این منظور، تابع :func:`email.Utils.formatdate ` تغییر کرده است تا بتواند به‌عنوان جایگزینی برای :func:`!rfc822.formatdate` استفاده شود. ممکن است بخواهید کدهای جدید پردازش ایمیل را با در نظر داشتن این موضوع بنویسید. (این تغییر توسط آنتونی باکستر پیاده‌سازی شد.)" msgid "A new ``urandom(n)`` function was added to the :mod:`os` module, returning a string containing *n* bytes of random data. This function provides access to platform-specific sources of randomness such as :file:`/dev/urandom` on Linux or the Windows CryptoAPI. (Contributed by Trevor Perrin.)" -msgstr "تابع جدید ``urandom(n)`` به ماژول :mod:`os` اضافه شد که رشته‌ای حاوی *n* بایت داده‌ی تصادفی برمی‌گرداند. این تابع دسترسی به منابع تصادفی مخصوص پلتفرم مانند :file:`/dev/urandom` در لینوکس یا CryptoAPI ویندوز را فراهم می‌کند. (مشارکت توسط Trevor Perrin.)" +msgstr "تابع جدید ``urandom(n)`` به ماژول :mod:`os` اضافه شد که رشته‌ای حاوی \*n\* بایت داده‌ی تصادفی برمی‌گرداند. این تابع دسترسی به منابع تصادفی مخصوص پلتفرم مانند :file:`/dev/urandom` در لینوکس یا CryptoAPI ویندوز را فراهم می‌کند. (مشارکت توسط Trevor Perrin.)" msgid "Another new function: ``os.path.lexists(path)`` returns true if the file specified by *path* exists, whether or not it's a symbolic link. This differs from the existing ``os.path.exists(path)`` function, which returns false if *path* is a symlink that points to a destination that doesn't exist. (Contributed by Beni Cherniavsky.)" -msgstr "تابع جدید دیگر: ``os.path.lexists(path)`` اگر پرونده‌ی مشخص‌شده توسط *path* وجود داشته باشد، مقدار true را برمی‌گرداند؛ صرف‌نظر از اینکه پیوند نمادین باشد یا نباشد. این تابع با تابع موجود ``os.path.exists(path)`` تفاوت دارد که اگر *path* پیوندی نمادین به مقصدی باشد که وجود ندارد، مقدار false را برمی‌گرداند. (مشارکت‌شده توسط Beni Cherniavsky.)" +msgstr "تابع جدید دیگر: ``os.path.lexists(path)`` اگر پرونده‌ی مشخص‌شده توسط \*path\* وجود داشته باشد، مقدار true را برمی‌گرداند؛ صرف‌نظر از اینکه پیوند نمادین باشد یا نباشد. این تابع با تابع موجود ``os.path.exists(path)`` تفاوت دارد که اگر \*path\* پیوندی نمادین به مقصدی باشد که وجود ندارد، مقدار false را برمی‌گرداند. (مشارکت‌شده توسط Beni Cherniavsky.)" msgid "A new :func:`~os.getsid` function was added to the :mod:`posix` module that underlies the :mod:`os` module. (Contributed by J. Raynor.)" msgstr "تابع جدید :func:`~os.getsid` به ماژول :mod:`posix` که زیربنای ماژول :mod:`os` است، افزوده شد. (مشارکت: J. Raynor.)" @@ -1359,10 +1359,10 @@ msgid "The :mod:`profile` module can now profile C extension functions. (Contrib msgstr "ماژول :mod:`profile` اکنون می‌تواند توابع توسعه‌ای C را پروفایل‌گیری کند. (مشارکت‌شده توسط Nick Bastin.)" msgid "The :mod:`random` module has a new method called ``getrandbits(N)`` that returns a long integer *N* bits in length. The existing :meth:`~random.randrange` method now uses :meth:`~random.getrandbits` where appropriate, making generation of arbitrarily large random numbers more efficient. (Contributed by Raymond Hettinger.)" -msgstr "ماژول :mod:`random` متد جدیدی به نام ``getrandbits(N)`` دارد که یک عدد صحیح بلند به طول *N* بیت برمی‌گرداند. متد موجود :meth:`~random.randrange` اکنون در موارد مناسب از :meth:`~random.getrandbits` استفاده می‌کند که این امر تولید اعداد تصادفی با هر اندازه‌ی بزرگ دلخواه را کارآمدتر می‌کند. (مشارکت Raymond Hettinger.)" +msgstr "ماژول :mod:`random` متد جدیدی به نام ``getrandbits(N)`` دارد که یک عدد صحیح بلند به طول \*N\* بیت برمی‌گرداند. متد موجود :meth:`~random.randrange` اکنون در موارد مناسب از :meth:`~random.getrandbits` استفاده می‌کند که این امر تولید اعداد تصادفی با هر اندازه‌ی بزرگ دلخواه را کارآمدتر می‌کند. (مشارکت Raymond Hettinger.)" msgid "The regular expression language accepted by the :mod:`re` module was extended with simple conditional expressions, written as ``(?(group)A|B)``. *group* is either a numeric group ID or a group name defined with ``(?P...)`` earlier in the expression. If the specified group matched, the regular expression pattern *A* will be tested against the string; if the group didn't match, the pattern *B* will be used instead. (Contributed by Gustavo Niemeyer.)" -msgstr "زبان عبارت باقاعده‌ی پذیرفته‌شده توسط ماژول :mod:`re` با عبارت‌های شرطی ساده که به شکل ``(?(group)A|B)`` نوشته می‌شوند گسترش یافت. *group* یا یک شناسه‌ی گروه عددی است یا نام گروهی که پیش‌تر در عبارت با ``(?P...)`` تعریف شده است. اگر گروه مشخص‌شده تطبیق یافته باشد، الگوی عبارت باقاعده *A* در برابر رشته آزموده می‌شود؛ اگر گروه تطبیق نیافته باشد، به جای آن الگوی *B* به کار می‌رود. (با مشارکت گوستاوو نیمایر.)" +msgstr "زبان عبارت باقاعده‌ی پذیرفته‌شده توسط ماژول :mod:`re` با عبارت‌های شرطی ساده که به شکل ``(?(group)A|B)`` نوشته می‌شوند گسترش یافت. \*group\* یا یک شناسه‌ی گروه عددی است یا نام گروهی که پیش‌تر در عبارت با ``(?P...)`` تعریف شده است. اگر گروه مشخص‌شده تطبیق یافته باشد، الگوی عبارت باقاعده \*A\* در برابر رشته آزموده می‌شود؛ اگر گروه تطبیق نیافته باشد، به جای آن الگوی \*B\* به کار می‌رود. (با مشارکت گوستاوو نیمایر.)" msgid "The :mod:`re` module is also no longer recursive, thanks to a massive amount of work by Gustavo Niemeyer. In a recursive regular expression engine, certain patterns result in a large amount of C stack space being consumed, and it was possible to overflow the stack. For example, if you matched a 30000-byte string of ``a`` characters against the expression ``(a|b)+``, one stack frame was consumed per character. Python 2.3 tried to check for stack overflow and raise a :exc:`RuntimeError` exception, but certain patterns could sidestep the checking and if you were unlucky Python could segfault. Python 2.4's regular expression engine can match this pattern without problems." msgstr "ماژول :mod:`re` نیز به لطف حجم عظیمی از کار گوستاوو نیمایر، دیگر بازگشتی نیست. در موتور عبارت باقاعده‌ی بازگشتی، برخی الگوها باعث می‌شوند مقدار زیادی از فضای پشته‌ی C مصرف شود و امکان سرریز پشته وجود داشت. برای مثال، اگر رشته‌ای ۳۰۰۰۰ بایتی از نویسه‌های ``a`` را با عبارت ``(a|b)+`` تطبیق می‌دادید، به ازای هر نویسه یک فریم پشته مصرف می‌شد. پایتون 2.3 تلاش می‌کرد سرریز پشته را بررسی کند و استثنای :exc:`RuntimeError` ایجاد کند، اما برخی الگوها می‌توانستند بررسی را دور بزنند و اگر بدشانس می‌بودید، ممکن بود پایتون دچار خطای قطعه‌بندی (segmentation fault) شود. موتور عبارت باقاعده‌ی پایتون 2.4 می‌تواند این الگو را بدون مشکل تطبیق دهد." @@ -1592,7 +1592,7 @@ msgid "Three new convenience macros were added for common return values from ext msgstr "سه ماکروی جدید برای راحتی بازگرداندن مقادیر رایج از توابع توسعه‌ای اضافه شدند: :c:macro:`Py_RETURN_NONE`، :c:macro:`Py_RETURN_TRUE` و :c:macro:`Py_RETURN_FALSE`. (مشارکت‌شده توسط Brett Cannon.)" msgid "Another new macro, :c:macro:`Py_CLEAR`, decreases the reference count of *obj* and sets *obj* to the null pointer. (Contributed by Jim Fulton.)" -msgstr "یک ماکرو جدید دیگر، :c:macro:`Py_CLEAR`، شمارش ارجاع *obj* را کاهش می‌دهد و *obj* را به اشاره‌گر تهی تنظیم می‌کند. (مشارکت‌شده توسط Jim Fulton.)" +msgstr "یک ماکرو جدید دیگر، :c:macro:`Py_CLEAR`، شمارش ارجاع \*obj\* را کاهش می‌دهد و \*obj\* را به اشاره‌گر تهی تنظیم می‌کند. (مشارکت‌شده توسط Jim Fulton.)" msgid "A new function, ``PyTuple_Pack(N, obj1, obj2, ..., objN)``, constructs tuples from a variable length argument list of Python objects. (Contributed by Raymond Hettinger.)" msgstr "تابع جدید ``PyTuple_Pack(N, obj1, obj2, ..., objN)`` تاپل‌ها را از یک فهرست آرگومان با طول متغیر از اشیاء پایتون می‌سازد. (ارائه‌شده توسط Raymond Hettinger.)" @@ -1601,7 +1601,7 @@ msgid "A new function, ``PyDict_Contains(d, k)``, implements fast dictionary loo msgstr "تابع جدید، ``PyDict_Contains(d, k)``، جستجوهای سریع دیکشنری را پیاده‌سازی می‌کند، بدون آنکه استثناهای ایجادشده در طول فرایند جستجو را پوشاند. (مشارکت از Raymond Hettinger.)" msgid "The :c:macro:`Py_IS_NAN` macro returns 1 if its float or double argument *X* is a NaN. (Contributed by Tim Peters.)" -msgstr "ماکروی :c:macro:`Py_IS_NAN` در صورتی که آرگومان اعشاری یا ممیز شناور با دقت مضاعف آن، *X*، یک NaN باشد، مقدار ۱ را برمی‌گرداند. (مشارکت‌شده توسط تیم پیترز.)" +msgstr "ماکروی :c:macro:`Py_IS_NAN` در صورتی که آرگومان اعشاری یا ممیز شناور با دقت مضاعف آن، \*X\*، یک NaN باشد، مقدار ۱ را برمی‌گرداند. (مشارکت‌شده توسط تیم پیترز.)" msgid "C code can avoid unnecessary locking by using the new :c:func:`!PyEval_ThreadsInitialized` function to tell if any thread operations have been performed. If this function returns false, no lock operations are needed. (Contributed by Nick Coghlan.)" msgstr "کد C می‌تواند با استفاده از تابع جدید :c:func:`!PyEval_ThreadsInitialized` که مشخص می‌کند آیا عملیات‌های نخ انجام شده‌اند یا نه، از قفل‌گذاری غیرضروری اجتناب کند. اگر این تابع مقدار نادرست برگرداند، هیچ عملیات قفلی لازم نیست. (با مشارکت Nick Coghlan.)" @@ -1646,7 +1646,7 @@ msgid ":meth:`LexicalHandler.startDTD ` msgstr ":meth:`LexicalHandler.startDTD ` شناسه‌های عمومی و سیستمی را به ترتیب نادرست دریافت می‌کرد. این مورد اصلاح شده است؛ برنامه‌هایی که به ترتیب نادرست تکیه دارند باید اصلاح شوند." msgid ":func:`fcntl.ioctl` now warns if the *mutate* argument is omitted and relevant." -msgstr ":func:`fcntl.ioctl` اکنون در صورتی که آرگومان *mutate* حذف شده و مرتبط باشد، هشدار می‌دهد." +msgstr ":func:`fcntl.ioctl` اکنون در صورتی که آرگومان \*mutate\* حذف شده و مرتبط باشد، هشدار می‌دهد." msgid "The :mod:`tarfile` module now generates GNU-format tar files by default." msgstr "ماژول :mod:`tarfile` اکنون به‌صورت پیش‌فرض پرونده‌های tar با قالب GNU تولید می‌کند." diff --git a/whatsnew/2.7.po b/whatsnew/2.7.po index f2bdb94e..f0f5bfef 100644 --- a/whatsnew/2.7.po +++ b/whatsnew/2.7.po @@ -381,18 +381,18 @@ msgid "" " -C NUM display NUM lines of added context" msgstr "" "-> ./python.exe argparse-example.py --help\n" -"طریقه‌ی استفاده: argparse-example.py [-h] [-v] [-o FILE] [-C NUM] [inputs [inputs ...]]\n" +"usage: argparse-example.py [-h] [-v] [-o FILE] [-C NUM] [inputs [inputs ...]]\n" "\n" -"مثال خط فرمان.\n" +"Command-line example.\n" "\n" -"آرگومان‌های جایگاهی:\n" -" inputs نام پرونده‌های ورودی (پیش‌فرض stdin است)\n" +"positional arguments:\n" +" inputs input filenames (default is stdin)\n" "\n" -"آرگومان‌های اختیاری:\n" -" -h, --help نمایش این پیام راهنما و خروج\n" -" -v تولید خروجی پرگویی (verbose)\n" -" -o FILE هدایت خروجی به FILE به جای stdout\n" -" -C NUM نمایش NUM سطر از زمینه افزوده‌شده" +"optional arguments:\n" +" -h, --help show this help message and exit\n" +" -v produce verbose output\n" +" -o FILE direct output to FILE instead of stdout\n" +" -C NUM display NUM lines of added context" msgid "As with :mod:`optparse`, the command-line switches and arguments are returned as an object with attributes named by the *dest* parameters::" msgstr "مانند :mod:`optparse`، سوییچ‌ها و آرگومان‌های خط فرمان به‌صورت یک شیء با ویژگی‌هایی که نام آن‌ها توسط پارامترهای *dest* مشخص می‌شود، بازگردانده می‌شوند::" @@ -781,7 +781,7 @@ msgid "" " ... suite of statements ..." msgstr "" "with A() as a, B() as b:\n" -" ... بدنه‌ی دستورات ..." +" ... suite of statements ..." msgid "is equivalent to::" msgstr "معادل است با::" diff --git a/whatsnew/3.7.po b/whatsnew/3.7.po index f2f02d9c..2311cef6 100644 --- a/whatsnew/3.7.po +++ b/whatsnew/3.7.po @@ -465,7 +465,7 @@ msgid "dataclasses" msgstr "dataclasses" msgid "The new :deco:`~dataclasses.dataclass` decorator provides a way to declare *data classes*. A data class describes its attributes using class variable annotations. Its constructor and other magic methods, such as :meth:`~object.__repr__`, :meth:`~object.__eq__`, and :meth:`~object.__hash__` are generated automatically." -msgstr "دکوراتور جدید :deco:`~dataclasses.dataclass` راهی برای اعلان *دیتاکلاس‌ها* فراهم می‌کند. یک دیتاکلاس ویژگی‌های خود را با استفاده از حاشیه‌نویسی‌های متغیر کلاس توصیف می‌کند. سازنده و سایر متدهای ویژه آن، مانند :meth:`~object.__repr__`، :meth:`~object.__eq__` و :meth:`~object.__hash__` به‌طور خودکار تولید می‌شوند." +msgstr "دکوراتور جدید :deco:`~dataclasses.dataclass` راهی برای اعلان *دیتاکلاس‌ها* فراهم می‌کند. یک دیتاکلاس ویژگی‌های خود را با استفاده از حاشیه‌نویسی‌های متغیر کلاس توصیف می‌کند. سازنده و سایر متدهای جادویی آن، مانند :meth:`~object.__repr__`، :meth:`~object.__eq__` و :meth:`~object.__hash__` به‌طور خودکار تولید می‌شوند." msgid "Example::" msgstr "مثال::"