Update translation from Transifex

Co-Authored-By: python-doc bot

Author: GitHub Action's update-translation job

README.en.md

@@ -16,7 +16,7 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 [![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml)
 [![core 99.91%](https://img.shields.io/badge/core-99.91%25-0.svg)](https://translations.python.org/#pl)
 [![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.47%25-0.svg)](https://translations.python.org/#pl)
-[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.43%25-0.svg)](https://translations.python.org/#pl)
+[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.42%25-0.svg)](https://translations.python.org/#pl)
 <!-- [[[end]]] -->
 
 *Przeczytaj to w innym języku: [polski](README.md)*

README.md

@@ -16,7 +16,7 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
 [![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml)
 [![podstawowe artykuły 99.91%](https://img.shields.io/badge/podstawowe_artykuły-99.91%25-0.svg)](https://translations.python.org/#pl)
 [![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.47%25-0.svg)](https://translations.python.org/#pl)
-[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.43%25-0.svg)](https://translations.python.org/#pl)
+[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.42%25-0.svg)](https://translations.python.org/#pl)
 <!-- [[[end]]] -->
 
 *Read this in another language: [English](README.en.md)*

c-api/arg.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 18:32+0000\n"
+"POT-Creation-Date: 2025-12-03 14:17+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

c-api/code.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 18:32+0000\n"
+"POT-Creation-Date: 2025-12-03 14:17+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

deprecations/index.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 18:32+0000\n"
+"POT-Creation-Date: 2025-12-03 14:17+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

deprecations/pending-removal-in-3.13.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-15 14:12+0000\n"
+"POT-Creation-Date: 2025-12-05 14:15+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

deprecations/pending-removal-in-future.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 18:32+0000\n"
+"POT-Creation-Date: 2025-12-03 14:17+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

library/ast.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 18:32+0000\n"
+"POT-Creation-Date: 2025-12-03 14:17+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

library/asyncio-stream.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-11-13 18:32+0000\n"
+"POT-Creation-Date: 2025-12-03 14:17+0000\n"
 "PO-Revision-Date: 2025-09-16 00:00+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

library/stdtypes.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-12-01 14:16+0000\n"
+"POT-Creation-Date: 2025-12-05 14:15+0000\n"
 "PO-Revision-Date: 2025-09-16 00:01+0000\n"
 "Last-Translator: python-doc bot, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -3187,7 +3187,7 @@ msgid ""
 "within f-strings."
 msgstr ""
 
-msgid "Added the debugging operator (``=``)"
+msgid "Added the debug specifier (``=``)"
 msgstr ""
 
 msgid ""
@@ -3198,137 +3198,175 @@ msgstr ""
 msgid ""
 "An :dfn:`f-string` (formally a :dfn:`formatted string literal`) is a string "
 "literal that is prefixed with ``f`` or ``F``. This type of string literal "
-"allows embedding arbitrary Python expressions within *replacement fields*, "
-"which are delimited by curly brackets (``{}``). These expressions are "
-"evaluated at runtime, similarly to :meth:`str.format`, and are converted "
-"into regular :class:`str` objects. For example:"
+"allows embedding the results of arbitrary Python expressions within "
+"*replacement fields*, which are delimited by curly brackets (``{}``). Each "
+"replacement field must contain an expression, optionally followed by:"
 msgstr ""
 
-msgid ""
-">>> who = 'nobody'\n"
-">>> nationality = 'Spanish'\n"
-">>> f'{who.title()} expects the {nationality} Inquisition!'\n"
-"'Nobody expects the Spanish Inquisition!'"
+msgid "a *debug specifier* -- an equal sign (``=``);"
 msgstr ""
 
-msgid "It is also possible to use a multi line f-string:"
+msgid "a *conversion specifier* -- ``!s``, ``!r`` or ``!a``; and/or"
 msgstr ""
 
-msgid ""
-">>> f'''This is a string\n"
-"... on two lines'''\n"
-"'This is a string\\non two lines'"
+msgid "a *format specifier* prefixed with a colon (``:``)."
 msgstr ""
 
 msgid ""
-"A single opening curly bracket, ``'{'``, marks a *replacement field* that "
-"can contain any Python expression:"
+"See the :ref:`Lexical Analysis section on f-strings <f-strings>` for details "
+"on the syntax of these fields."
 msgstr ""
 
-msgid ""
-">>> nationality = 'Spanish'\n"
-">>> f'The {nationality} Inquisition!'\n"
-"'The Spanish Inquisition!'"
+msgid "Debug specifier"
 msgstr ""
 
-msgid "To include a literal ``{`` or ``}``, use a double bracket:"
+msgid ""
+"If a debug specifier -- an equal sign (``=``) -- appears after the "
+"replacement field expression, the resulting f-string will contain the "
+"expression's source, the equal sign, and the value of the expression. This "
+"is often useful for debugging::"
 msgstr ""
 
 msgid ""
-">>> x = 42\n"
-">>> f'{{x}} is {x}'\n"
-"'{x} is 42'"
+">>> number = 14.3\n"
+">>> f'{number=}'\n"
+"'number=14.3'"
 msgstr ""
 
 msgid ""
-"Functions can also be used, and :ref:`format specifiers <formatstrings>`:"
+"Whitespace before, inside and after the expression, as well as whitespace "
+"after the equal sign, is significant --- it is retained in the result::"
 msgstr ""
 
 msgid ""
-">>> from math import sqrt\n"
-">>> f'√2 \\N{ALMOST EQUAL TO} {sqrt(2):.5f}'\n"
-"'√2 ≈ 1.41421'"
+">>> f'{ number  -  4  = }'\n"
+"' number  -  4  = 10.3'"
 msgstr ""
 
-msgid "Any non-string expression is converted using :func:`str`, by default:"
+msgid "Conversion specifier"
+msgstr ""
+
+msgid ""
+"By default, the value of a replacement field expression is converted to a "
+"string using :func:`str`::"
 msgstr ""
 
 msgid ""
 ">>> from fractions import Fraction\n"
-">>> f'{Fraction(1, 3)}'\n"
+">>> one_third = Fraction(1, 3)\n"
+">>> f'{one_third}'\n"
 "'1/3'"
 msgstr ""
 
 msgid ""
-"To use an explicit conversion, use the ``!`` (exclamation mark) operator, "
-"followed by any of the valid formats, which are:"
+"When a debug specifier but no format specifier is used, the default "
+"conversion instead uses :func:`repr`::"
 msgstr ""
 
-msgid "Conversion"
+msgid ""
+">>> f'{one_third = }'\n"
+"'one_third = Fraction(1, 3)'"
 msgstr ""
 
-msgid "``!a``"
-msgstr "``!a``"
-
-msgid ":func:`ascii`"
-msgstr ":func:`ascii`"
-
-msgid "``!r``"
-msgstr "``!r``"
+msgid ""
+"The conversion can be specified explicitly using one of these specifiers:"
+msgstr ""
 
-msgid ":func:`repr`"
-msgstr ":func:`repr`"
+msgid "``!s`` for :func:`str`"
+msgstr ""
 
-msgid "``!s``"
-msgstr "``!s``"
+msgid "``!r`` for :func:`repr`"
+msgstr ""
 
-msgid ":func:`str`"
-msgstr ":func:`str`"
+msgid "``!a`` for :func:`ascii`"
+msgstr ""
 
 msgid ""
-">>> from fractions import Fraction\n"
-">>> f'{Fraction(1, 3)!s}'\n"
+">>> str(one_third)\n"
 "'1/3'\n"
-">>> f'{Fraction(1, 3)!r}'\n"
+">>> repr(one_third)\n"
 "'Fraction(1, 3)'\n"
-">>> question = '¿Dónde está el Presidente?'\n"
-">>> print(f'{question!a}')\n"
-"'\\xbfD\\xf3nde est\\xe1 el Presidente?'"
+"\n"
+">>> f'{one_third!s} is {one_third!r}'\n"
+"'1/3 is Fraction(1, 3)'\n"
+"\n"
+">>> string = \"¡kočka 😸!\"\n"
+">>> ascii(string)\n"
+"\"'\\\\xa1ko\\\\u010dka \\\\U0001f638!'\"\n"
+"\n"
+">>> f'{string = !a}'\n"
+"\"string = '\\\\xa1ko\\\\u010dka \\\\U0001f638!'\""
+msgstr ""
+
+msgid "Format specifier"
 msgstr ""
 
 msgid ""
-"While debugging it may be helpful to see both the expression and its value, "
-"by using the equals sign (``=``) after the expression. This preserves spaces "
-"within the brackets, and can be used with a converter. By default, the "
-"debugging operator uses the :func:`repr` (``!r``) conversion. For example:"
+"After the expression has been evaluated, and possibly converted using an "
+"explicit conversion specifier, it is formatted using the :func:`format` "
+"function. If the replacement field includes a *format specifier* introduced "
+"by a colon (``:``), the specifier is passed to :func:`!format` as the second "
+"argument. The result of :func:`!format` is then used as the final value for "
+"the replacement field. For example::"
 msgstr ""
 
 msgid ""
 ">>> from fractions import Fraction\n"
-">>> calculation = Fraction(1, 3)\n"
-">>> f'{calculation=}'\n"
-"'calculation=Fraction(1, 3)'\n"
-">>> f'{calculation = }'\n"
-"'calculation = Fraction(1, 3)'\n"
-">>> f'{calculation = !s}'\n"
-"'calculation = 1/3'"
+">>> one_third = Fraction(1, 3)\n"
+">>> f'{one_third:.6f}'\n"
+"'0.333333'\n"
+">>> f'{one_third:_^+10}'\n"
+"'___+1/3___'\n"
+">>> >>> f'{one_third!r:_^20}'\n"
+"'___Fraction(1, 3)___'\n"
+">>> f'{one_third = :~>10}~'\n"
+"'one_third = ~~~~~~~1/3~'"
+msgstr ""
+
+msgid "Template String Literals (t-strings)"
 msgstr ""
 
 msgid ""
-"Once the output has been evaluated, it can be formatted using a :ref:`format "
-"specifier <formatstrings>` following a colon (``':'``). After the expression "
-"has been evaluated, and possibly converted to a string, the :meth:`!"
-"__format__` method of the result is called with the format specifier, or the "
-"empty string if no format specifier is given. The formatted result is then "
-"used as the final value for the replacement field. For example:"
+"An :dfn:`t-string` (formally a :dfn:`template string literal`) is a string "
+"literal that is prefixed with ``t`` or ``T``."
 msgstr ""
 
 msgid ""
-">>> from fractions import Fraction\n"
-">>> f'{Fraction(1, 7):.6f}'\n"
-"'0.142857'\n"
-">>> f'{Fraction(1, 7):_^+10}'\n"
-"'___+1/7___'"
+"These strings follow the same syntax and evaluation rules as :ref:`formatted "
+"string literals <stdtypes-fstrings>`, with for the following differences:"
+msgstr ""
+
+msgid ""
+"Rather than evaluating to a ``str`` object, template string literals "
+"evaluate to a :class:`string.templatelib.Template` object."
+msgstr ""
+
+msgid ""
+"The :func:`format` protocol is not used. Instead, the format specifier and "
+"conversions (if any) are passed to a new :class:`~string.templatelib."
+"Interpolation` object that is created for each evaluated expression. It is "
+"up to code that processes the resulting :class:`~string.templatelib."
+"Template` object to decide how to handle format specifiers and conversions."
+msgstr ""
+
+msgid ""
+"Format specifiers containing nested replacement fields are evaluated "
+"eagerly, prior to being passed to the :class:`~string.templatelib."
+"Interpolation` object. For instance, an interpolation of the form ``{amount:."
+"{precision}f}`` will evaluate the inner expression ``{precision}`` to "
+"determine the value of the ``format_spec`` attribute. If ``precision`` were "
+"to be ``2``, the resulting format specifier would be ``'.2f'``."
+msgstr ""
+
+msgid ""
+"When the equals sign ``'='`` is provided in an interpolation expression, the "
+"text of the expression is appended to the literal string that precedes the "
+"relevant interpolation. This includes the equals sign and any surrounding "
+"whitespace. The :class:`!Interpolation` instance for the expression will be "
+"created as normal, except that :attr:`~string.templatelib.Interpolation."
+"conversion` will be set to '``r``' (:func:`repr`) by default. If an explicit "
+"conversion or format specifier are provided, this will override the default "
+"behaviour."
 msgstr ""
 
 msgid "``printf``-style String Formatting"
@@ -3468,6 +3506,9 @@ msgstr ""
 msgid "The conversion types are:"
 msgstr ""
 
+msgid "Conversion"
+msgstr ""
+
 msgid "``'d'``"
 msgstr "``'d'``"