@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.13\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2025-02-28 14:17 +0000\n "
14+ "POT-Creation-Date : 2025-07-25 15:00 +0000\n "
1515"PO-Revision-Date : 2025-07-18 19:21+0000\n "
1616"Last-Translator : Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n "
1717"Language-Team : Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n "
@@ -122,22 +122,43 @@ msgstr ""
122122msgid "Return the number of items in the queue."
123123msgstr ""
124124
125+ msgid "Put a :class:`Queue` instance into a shutdown mode."
126+ msgstr ""
127+
128+ msgid ""
129+ "The queue can no longer grow. Future calls to :meth:`~Queue.put` raise :exc:"
130+ "`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` will be "
131+ "unblocked and will raise :exc:`QueueShutDown` in the formerly blocked thread."
132+ msgstr ""
133+
134+ msgid ""
135+ "If *immediate* is false (the default), the queue can be wound down normally "
136+ "with :meth:`~Queue.get` calls to extract tasks that have already been loaded."
137+ msgstr ""
138+
125139msgid ""
126- "Shut down the queue, making :meth:`~Queue.get` and :meth:`~Queue.put` raise : "
127- "exc:`QueueShutDown` ."
140+ "And if :meth:`~Queue.task_done` is called for each remaining task, a "
141+ "pending :meth:`~Queue.join` will be unblocked normally ."
128142msgstr ""
129143
130144msgid ""
131- "By default, :meth:`~Queue.get` on a shut down queue will only raise once the "
132- "queue is empty. Set *immediate* to true to make :meth:`~Queue.get` raise "
133- "immediately instead."
145+ "Once the queue is empty, future calls to :meth:`~Queue.get` will raise :exc:"
146+ "`QueueShutDown`."
134147msgstr ""
135148
136149msgid ""
137- "All blocked callers of :meth:`~Queue.put` and :meth:`~Queue.get` will be "
138- "unblocked. If *immediate* is true, a task will be marked as done for each "
139- "remaining item in the queue, which may unblock callers of :meth:`~Queue."
140- "join`."
150+ "If *immediate* is true, the queue is terminated immediately. The queue is "
151+ "drained to be completely empty and the count of unfinished tasks is reduced "
152+ "by the number of tasks drained. If unfinished tasks is zero, callers of :"
153+ "meth:`~Queue.join` are unblocked. Also, blocked callers of :meth:`~Queue."
154+ "get` are unblocked and will raise :exc:`QueueShutDown` because the queue is "
155+ "empty."
156+ msgstr ""
157+
158+ msgid ""
159+ "Use caution when using :meth:`~Queue.join` with *immediate* set to true. "
160+ "This unblocks the join even when no work has been done on the tasks, "
161+ "violating the usual invariant for joining a queue."
141162msgstr ""
142163
143164msgid "Indicate that a formerly enqueued work item is complete."
@@ -155,11 +176,6 @@ msgid ""
155176"item that had been :meth:`~Queue.put` into the queue)."
156177msgstr ""
157178
158- msgid ""
159- "``shutdown(immediate=True)`` calls :meth:`task_done` for each remaining item "
160- "in the queue."
161- msgstr ""
162-
163179msgid ""
164180"Raises :exc:`ValueError` if called more times than there were items placed "
165181"in the queue."
0 commit comments