sync with cpython d9feec45

Author: github-actions[bot]

library/asyncio-queue.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.13\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-23 00:15+0000\n"
+"POT-Creation-Date: 2025-07-25 00:16+0000\n"
 "PO-Revision-Date: 2022-02-20 18:34+0800\n"
 "Last-Translator: Matt Wang <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -162,31 +162,55 @@ msgid "Return the number of items in the queue."
 msgstr "回傳佇列中的元素數量。"
 
 #: ../../library/asyncio-queue.rst:105
-msgid ""
-"Shut down the queue, making :meth:`~Queue.get` and :meth:`~Queue.put` raise :"
-"exc:`QueueShutDown`."
+msgid "Put a :class:`Queue` instance into a shutdown mode."
 msgstr ""
 
-#: ../../library/asyncio-queue.rst:108
+#: ../../library/asyncio-queue.rst:107
 msgid ""
-"By default, :meth:`~Queue.get` on a shut down queue will only raise once the "
-"queue is empty. Set *immediate* to true to make :meth:`~Queue.get` raise "
-"immediately instead."
+"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 blocked thread."
 msgstr ""
 
 #: ../../library/asyncio-queue.rst:112
 msgid ""
-"All blocked callers of :meth:`~Queue.put` and :meth:`~Queue.get` will be "
-"unblocked. If *immediate* is true, a task will be marked as done for each "
-"remaining item in the queue, which may unblock callers of :meth:`~Queue."
-"join`."
+"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 ""
+
+#: ../../library/asyncio-queue.rst:116
+msgid ""
+"And if :meth:`~Queue.task_done` is called for each remaining task, a "
+"pending :meth:`~Queue.join` will be unblocked normally."
 msgstr ""
 
-#: ../../library/asyncio-queue.rst:121
+#: ../../library/asyncio-queue.rst:119
+msgid ""
+"Once the queue is empty, future calls to :meth:`~Queue.get` will raise :exc:"
+"`QueueShutDown`."
+msgstr ""
+
+#: ../../library/asyncio-queue.rst:122
+msgid ""
+"If *immediate* is true, the queue is terminated immediately. The queue is "
+"drained to be completely empty.  All callers of :meth:`~Queue.join` are "
+"unblocked regardless of the number of unfinished tasks.  Blocked callers of :"
+"meth:`~Queue.get` are unblocked and will raise :exc:`QueueShutDown` because "
+"the queue is empty."
+msgstr ""
+
+#: ../../library/asyncio-queue.rst:129
+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 ""
+
+#: ../../library/asyncio-queue.rst:137
 msgid "Indicate that a formerly enqueued work item is complete."
 msgstr "表示前面一個排隊的工作項目已經完成。"
 
-#: ../../library/asyncio-queue.rst:123
+#: ../../library/asyncio-queue.rst:139
 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 "
@@ -195,7 +219,7 @@ msgstr ""
 "由佇列消耗者使用。對於每個用於取得一個工作項目的 :meth:`~Queue.get`，接續的 :"
 "meth:`task_done` 呼叫會告訴佇列這個工作項目的處理已經完成。"
 
-#: ../../library/asyncio-queue.rst:127
+#: ../../library/asyncio-queue.rst:143
 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 "
@@ -204,76 +228,70 @@ msgstr ""
 "如果 :meth:`join` 目前正在阻塞，在所有項目都被處理後會解除阻塞（意味著每個"
 "以 :meth:`~Queue.put` 放進佇列的條目都會收到一個 :meth:`task_done`）。"
 
-#: ../../library/asyncio-queue.rst:132
-msgid ""
-"``shutdown(immediate=True)`` calls :meth:`task_done` for each remaining item "
-"in the queue."
-msgstr ""
-
-#: ../../library/asyncio-queue.rst:135
+#: ../../library/asyncio-queue.rst:148
 msgid ""
 "Raises :exc:`ValueError` if called more times than there were items placed "
 "in the queue."
 msgstr "如果被呼叫的次數多於放入佇列中的項目數量，將引發 :exc:`ValueError`。"
 
-#: ../../library/asyncio-queue.rst:140
+#: ../../library/asyncio-queue.rst:153
 msgid "Priority Queue"
 msgstr "Priority Queue（優先佇列）"
 
-#: ../../library/asyncio-queue.rst:144
+#: ../../library/asyncio-queue.rst:157
 msgid ""
 "A variant of :class:`Queue`; retrieves entries in priority order (lowest "
 "first)."
 msgstr ":class:`Queue` 的變形；按優先順序取出條目 (最小的先取出)。"
 
-#: ../../library/asyncio-queue.rst:147
+#: ../../library/asyncio-queue.rst:160
 msgid "Entries are typically tuples of the form ``(priority_number, data)``."
 msgstr "條目通常是 ``(priority_number, data)`` 形式的 tuple（元組）。"
 
-#: ../../library/asyncio-queue.rst:152
+#: ../../library/asyncio-queue.rst:165
 msgid "LIFO Queue"
 msgstr "LIFO Queue"
 
-#: ../../library/asyncio-queue.rst:156
+#: ../../library/asyncio-queue.rst:169
 msgid ""
 "A variant of :class:`Queue` that retrieves most recently added entries first "
 "(last in, first out)."
 msgstr ":class:`Queue` 的變形，先取出最近新增的條目（後進先出）。"
 
-#: ../../library/asyncio-queue.rst:161
+#: ../../library/asyncio-queue.rst:174
 msgid "Exceptions"
 msgstr "例外"
 
-#: ../../library/asyncio-queue.rst:165
+#: ../../library/asyncio-queue.rst:178
 msgid ""
 "This exception is raised when the :meth:`~Queue.get_nowait` method is called "
 "on an empty queue."
 msgstr "當佇列為空的時候，呼叫 :meth:`~Queue.get_nowait` 方法會引發這個例外。"
 
-#: ../../library/asyncio-queue.rst:171
+#: ../../library/asyncio-queue.rst:184
 msgid ""
 "Exception raised when the :meth:`~Queue.put_nowait` method is called on a "
 "queue that has reached its *maxsize*."
 msgstr ""
 "當佇列中條目數量已經達到它的 *maxsize* 時，呼叫 :meth:`~Queue.put_nowait` 方"
 "法會引發這個例外。"
 
-#: ../../library/asyncio-queue.rst:177
+#: ../../library/asyncio-queue.rst:190
 msgid ""
 "Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on "
 "a queue which has been shut down."
 msgstr ""
 
-#: ../../library/asyncio-queue.rst:184
+#: ../../library/asyncio-queue.rst:197
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/asyncio-queue.rst:188
+#: ../../library/asyncio-queue.rst:201
 msgid ""
 "Queues can be used to distribute workload between several concurrent tasks::"
 msgstr "佇列能被用於多個並行任務的工作分配："
 
-#: ../../library/asyncio-queue.rst:191
+#: ../../library/asyncio-queue.rst:204
 msgid ""
 "import asyncio\n"
 "import random\n"