msgid"asyncio queues are designed to be similar to classes of the :mod:`queue` module. Although asyncio queues are not thread-safe, they are designed to be used specifically in async/await code."
msgstr"صف‌های asyncio به‌گونه‌ای طراحی شده‌اند که شبیه کلاس‌های ماژول :mod:`queue` باشند. اگرچه صف‌های asyncio در برابر نخ ایمن نیستند، اما برای استفاده به‌طور خاص در کد ناهمگام/await طراحی شده‌اند."
msgid"Note that methods of asyncio queues don't have a *timeout* parameter; use :func:`asyncio.wait_for` function to do queue operations with a timeout."
msgstr"توجه داشته باشید که متدهای صف‌های asyncio پارامتر *timeout* ندارند؛ برای انجام عملیات صف با مهلت زمانی، از تابع :func:`asyncio.wait_for` استفاده کنید."
msgid"See also the `Examples`_ section below."
msgstr"همچنین بخش `Examples`_ در زیر را ببینید."
msgid"Queue"
msgstr"صف"
msgid"A first in, first out (FIFO) queue."
msgstr"یک صف اولین ورودی، اولین خروجی (FIFO)."
msgid"If *maxsize* is less than or equal to zero, the queue size is infinite. If it is an integer greater than ``0``, then ``await put()`` blocks when the queue reaches *maxsize* until an item is removed by :meth:`get`."
msgstr"اگر *maxsize* کوچک‌تر یا مساوی صفر باشد، اندازه صف بی‌نهایت است. اگر این مقدار یک عدد صحیح بزرگ‌تر از ``0`` باشد، ``await put()`` هنگامی که صف به *maxsize* برسد مسدود می‌شود تا زمانی که یک آیتم توسط :meth:`get` حذف شود."
msgid"Unlike the standard library threading :mod:`queue`, the size of the queue is always known and can be returned by calling the :meth:`qsize` method."
msgstr"برخلاف ماژول :mod:`queue` مربوط به threading در کتابخانه استاندارد، اندازه صف همیشه مشخص است و می‌توان آن را با فراخوانی متد :meth:`qsize` برگرداند."
msgid"Removed the *loop* parameter."
msgstr"پارامتر *loop* حذف شد."
msgid"This class is :ref:`not thread safe <asyncio-multithreading>`."
msgid"Return ``True`` if the queue is empty, ``False`` otherwise."
msgstr"اگر صف خالی باشد، ``True`` را برمی‌گرداند، در غیر این صورت ``False``."
msgid"Return ``True`` if there are :attr:`maxsize` items in the queue."
msgstr"اگر :attr:`maxsize` آیتم در صف وجود داشته باشد، ``True`` برمی‌گرداند."
msgid"If the queue was initialized with ``maxsize=0`` (the default), then :meth:`full` never returns ``True``."
msgstr"اگر صف با ``maxsize=0`` (پیش‌فرض) مقداردهی اولیه شده باشد، آنگاه :meth:`full` هرگز ``True`` را برنمی‌گرداند."
msgid"Remove and return an item from the queue. If queue is empty, wait until an item is available."
msgstr"یک آیتم را از صف حذف کرده و برمی‌گرداند. اگر صف خالی باشد، تا زمانی که یک آیتم در دسترس باشد صبر می‌کند."
msgid"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty, or if the queue has been shut down immediately."
msgstr"اگر صف خاموش شده باشد و خالی باشد، یا اگر صف بلافاصله خاموش شده باشد، استثنای :exc:`QueueShutDown` را پرتاب می‌کند."
msgid"Return an item if one is immediately available, else raise :exc:`QueueEmpty`."
msgstr"اگر یک آیتم بلافاصله در دسترس باشد، آن را برمی‌گرداند؛ در غیر این صورت :exc:`QueueEmpty` را پرتاب می‌کند."
msgid"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty."
msgstr"اگر صف خاموش شده باشد و خالی باشد، استثنای :exc:`QueueShutDown` را پرتاب می‌کند."
msgid"Block until all items in the queue have been received and processed."
msgstr"مسدود می‌شود تا تمام آیتم‌های موجود در صف دریافت و پردازش شده باشند."
msgid"The count of unfinished tasks goes up whenever an item is added to the queue. The count goes down whenever a consumer coroutine calls :meth:`task_done` to indicate that the item was retrieved and all work on it is complete. When the count of unfinished tasks drops to zero, :meth:`join` unblocks."
msgstr"تعداد وظایف ناتمام هر بار که یک آیتم به صف اضافه شود، افزایش می‌یابد. این تعداد هر بار که یک هم‌روال مصرف‌کننده :meth:`task_done` را فراخوانی کند تا نشان دهد آن آیتم دریافت شده و تمام کارهای مربوط به آن کامل شده است، کاهش می‌یابد. هنگامی که تعداد وظایف ناتمام به صفر برسد، :meth:`join` از حالت مسدود خارج می‌شود."
msgid"Put an item into the queue. If the queue is full, wait until a free slot is available before adding the item."
msgstr"یک آیتم را در صف قرار دهید. اگر صف پر باشد، پیش از افزودن آیتم، تا زمانی که یک جای خالی در دسترس قرار بگیرد صبر کنید."
msgid"Raises :exc:`QueueShutDown` if the queue has been shut down."
msgstr"اگر صف خاموش شده باشد، :exc:`QueueShutDown` را پرتاب می‌کند."
msgid"Put an item into the queue without blocking."
msgstr"یک آیتم را بدون مسدودسازی در صف قرار دهید."
msgid"If no free slot is immediately available, raise :exc:`QueueFull`."
msgstr"اگر هیچ جای خالی‌ای بلافاصله در دسترس نباشد، :exc:`QueueFull` پرتاب می‌شود."
msgid"Return the number of items in the queue."
msgstr"تعداد آیتم‌های موجود در صف را برمی‌گرداند."
msgid"Put a :class:`Queue` instance into a shutdown mode."
msgstr"نمونه‌ای از :class:`Queue` را در حالت خاموشی قرار دهید."
msgid"The queue can no longer grow. Future calls to :meth:`~Queue.put` raise :exc:`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` will be unblocked and will raise :exc:`QueueShutDown` in the formerly awaiting task."
msgstr"صف دیگر نمی‌تواند بزرگ‌تر شود. فراخوانی‌های بعدی :meth:`~Queue.put` باعث پرتاب :exc:`QueueShutDown` می‌شوند. فراخوانندگانی که در حال حاضر برای :meth:`~Queue.put` مسدود شده‌اند، از حالت مسدود خارج خواهند شد و :exc:`QueueShutDown` در وظیفه‌ای که پیش‌تر در انتظار بود پرتاب خواهد شد."
msgid"If *immediate* is false (the default), the queue can be wound down normally with :meth:`~Queue.get` calls to extract tasks that have already been loaded."
msgstr"اگر *immediate* نادرست باشد (پیش‌فرض)، صف می‌تواند به‌صورت عادی با فراخوانی‌های :meth:`~Queue.get` برای استخراج وظایفی که از قبل بارگذاری‌شده‌اند، تخلیه شود."
msgid"And if :meth:`~Queue.task_done` is called for each remaining task, a pending :meth:`~Queue.join` will be unblocked normally."
msgstr"و اگر :meth:`~Queue.task_done` برای هر وظیفه‌ی باقی‌مانده فراخوانی شود، یک :meth:`~Queue.join` در انتظار به‌طور عادی رفع انسداد خواهد شد."
msgid"Once the queue is empty, future calls to :meth:`~Queue.get` will raise :exc:`QueueShutDown`."
msgstr"پس از خالی شدن صف، فراخوانی‌های بعدی به :meth:`~Queue.get`، :exc:`QueueShutDown` را پرتاب خواهند کرد."
msgid"If *immediate* is true, the queue is terminated immediately. The queue is drained to be completely empty and the count of unfinished tasks is reduced by the number of tasks drained. If unfinished tasks is zero, callers of :meth:`~Queue.join` are unblocked. Also, blocked callers of :meth:`~Queue.get` are unblocked and will raise :exc:`QueueShutDown` because the queue is empty."
msgstr"اگر *immediate* برابر true باشد، صف بلافاصله خاتمه می‌یابد. صف تخلیه می‌شود تا کاملاً خالی شود و تعداد وظایف ناتمام به تعداد وظایف تخلیه‌شده کاهش می‌یابد. اگر تعداد وظایف ناتمام صفر باشد، فراخواننده‌های :meth:`~Queue.join` از حالت مسدود خارج می‌شوند. همچنین، فراخواننده‌های مسدودشده‌ی :meth:`~Queue.get` از حالت مسدود خارج می‌شوند و :exc:`QueueShutDown` را به دلیل خالی بودن صف پرتاب می‌کنند."
msgid"Use caution when using :meth:`~Queue.join` with *immediate* set to true. This unblocks the join even when no work has been done on the tasks, violating the usual invariant for joining a queue."
msgstr"هنگام استفاده از :meth:`~Queue.join` با *immediate* تنظیم‌شده روی true احتیاط کنید. این کار حتی زمانی که هیچ کاری روی وظایف انجام نشده باشد، انتظار join را رفع می‌کند و ناوردای معمولِ پیوستن به یک صف را نقض می‌کند."
msgid"Indicate that a formerly enqueued work item is complete."
msgstr"نشان می‌دهد که یک آیتم کاری که پیش‌تر در صف قرار گرفته است، کامل شده است."
msgid"Used by queue consumers. For each :meth:`~Queue.get` used to fetch a work item, a subsequent call to :meth:`task_done` tells the queue that the processing on the work item is complete."
msgstr"توسط مصرف‌کنندگان صف استفاده می‌شود. به ازای هر :meth:`~Queue.get` که برای واکشی یک آیتم کاری استفاده شود، فراخوانی متعاقب :meth:`task_done` به صف اطلاع می‌دهد که پردازش آن آیتم کاری کامل شده است."
msgid"If a :meth:`join` is currently blocking, it will resume when all items have been processed (meaning that a :meth:`task_done` call was received for every item that had been :meth:`~Queue.put` into the queue)."
msgstr"اگر :meth:`join` در حال حاضر مسدودکننده باشد، هنگامی که همه‌ی آیتم‌ها پردازش شده باشند، از سر گرفته می‌شود (به این معنا که برای هر آیتمی که با :meth:`~Queue.put` در صف قرار داده شده باشد، یک فراخوانی :meth:`task_done` دریافت شده باشد)."
msgid"Raises :exc:`ValueError` if called more times than there were items placed in the queue."
msgstr"اگر بیشتر از تعداد آیتم‌های قرار داده‌شده در صف فراخوانی شود، :exc:`ValueError` پرتاب می‌کند."
msgid"Priority Queue"
msgstr"صف اولویت"
msgid"A variant of :class:`Queue`; retrieves entries in priority order (lowest first)."
msgstr"گونه‌ای از :class:`Queue`؛ آیتم‌ها را به ترتیب اولویت (ابتدا کمترین) بازیابی می‌کند."
msgid"Entries are typically tuples of the form ``(priority_number, data)``."
msgstr"ورودی‌ها معمولاً تاپل‌هایی به شکل ``(priority_number, data)`` هستند."
msgid"LIFO Queue"
msgstr"صف LIFO"
msgid"A variant of :class:`Queue` that retrieves most recently added entries first (last in, first out)."
msgstr"گونه‌ای از :class:`Queue` که ابتدا جدیدترین ورودی‌های افزوده‌شده را بازیابی می‌کند (آخرین ورودی، اولین خروجی)."
msgid"Exceptions"
msgstr"استثناها"
msgid"This exception is raised when the :meth:`~Queue.get_nowait` method is called on an empty queue."
msgstr"این استثنا زمانی پرتاب می‌شود که متد :meth:`~Queue.get_nowait` روی یک صف خالی فراخوانی شود."
msgid"Exception raised when the :meth:`~Queue.put_nowait` method is called on a queue that has reached its *maxsize*."
msgstr"استثنایی که با فراخوانی متد :meth:`~Queue.put_nowait` روی صفی که به *maxsize* خود رسیده باشد، پرتاب می‌شود."
msgid"Exception raised when :meth:`~Queue.put`, :meth:`~Queue.put_nowait`, :meth:`~Queue.get` or :meth:`~Queue.get_nowait` is called on a queue which has been shut down."
msgstr"استثنایی که هنگام فراخوانی :meth:`~Queue.put`، :meth:`~Queue.put_nowait`، :meth:`~Queue.get` یا :meth:`~Queue.get_nowait` روی صفی که خاموش شده است، پرتاب می‌شود."
msgid"Examples"
msgstr"مثال‌ها"
msgid"Queues can be used to distribute workload between several concurrent tasks::"
msgstr"می‌توان از صف‌ها برای توزیع بار کاری بین چندین وظیفه هم‌رو استفاده کرد::"
msgid""
"import asyncio\n"
"import random\n"
"import time\n"
"\n"
"\n"
"async def worker(name, queue):\n"
" while True:\n"
" # Get a \"work item\" out of the queue.\n"
" sleep_for = await queue.get()\n"
"\n"
" # Sleep for the \"sleep_for\" seconds.\n"
" await asyncio.sleep(sleep_for)\n"
"\n"
" # Notify the queue that the \"work item\" has been processed.\n"
" queue.task_done()\n"
"\n"
" print(f'{name} has slept for {sleep_for:.2f} seconds')\n"
"\n"
"\n"
"async def main():\n"
" # Create a queue that we will use to store our \"workload\".\n"
" queue = asyncio.Queue()\n"
"\n"
" # Generate random timings and put them into the queue.\n"
" total_sleep_time = 0\n"
" for _ in range(20):\n"
" sleep_for = random.uniform(0.05, 1.0)\n"
" total_sleep_time += sleep_for\n"
" queue.put_nowait(sleep_for)\n"
"\n"
" # Create three worker tasks to process the queue concurrently.\n"