Update translation from Transifex

Author: GitHub Action's update-translation job

README.en.md

@@ -13,7 +13,7 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l
 ![{translators} Translators](https://img.shields.io/badge/Translators-{translators}-0.svg)''')
 ]]] -->
 ![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)
-![Total Translation of Documentation](https://img.shields.io/badge/Total-5.169%25-0.svg)
+![Total Translation of Documentation](https://img.shields.io/badge/Total-4.701%25-0.svg)
 ![24 Translators](https://img.shields.io/badge/Translators-24-0.svg)
 <!-- [[[end]]] -->
 

README.md

@@ -13,7 +13,7 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l
 ![{translators} tłumaczy](https://img.shields.io/badge/tłumaczy-{translators}-0.svg)''')
 ]]] -->
 ![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)
-![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-5.169%25-0.svg)
+![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-4.701%25-0.svg)
 ![24 tłumaczy](https://img.shields.io/badge/tłumaczy-24-0.svg)
 <!-- [[[end]]] -->
 

c-api/unicode.po

@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-08 02:53-0300\n"
+"POT-Creation-Date: 2025-05-16 14:19+0000\n"
 "PO-Revision-Date: 2021-06-28 00:50+0000\n"
 "Last-Translator: Stan Ulbrych, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -729,6 +729,14 @@ msgid ""
 "difference being that it decrements the reference count of *right* by one."
 msgstr ""
 
+msgid ""
+"Return a mapping suitable for decoding a custom single-byte encoding. Given "
+"a Unicode string *string* of up to 256 characters representing an encoding "
+"table, returns either a compact internal mapping object or a dictionary "
+"mapping character ordinals to byte values. Raises a :exc:`TypeError` and "
+"return ``NULL`` on invalid input."
+msgstr ""
+
 msgid ""
 "Return the name of the default string encoding, ``\"utf-8\"``. See :func:"
 "`sys.getdefaultencoding`."

deprecations/index.po

@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-08 02:53-0300\n"
+"POT-Creation-Date: 2025-05-16 14:19+0000\n"
 "PO-Revision-Date: 2024-07-29 04:07+0000\n"
 "Last-Translator: Stan Ulbrych, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -141,6 +141,14 @@ msgid ""
 "or the functional syntax instead."
 msgstr ""
 
+msgid ""
+"When using the functional syntax of :class:`~typing.TypedDict`\\s, failing "
+"to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or "
+"passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated "
+"since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = "
+"TypedDict(\"TD\", {})`` to create a TypedDict with zero field."
+msgstr ""
+
 msgid ""
 "The :func:`typing.no_type_check_decorator` decorator function has been "
 "deprecated since Python 3.13. After eight years in the :mod:`typing` module, "

deprecations/pending-removal-in-3.15.po

@@ -11,7 +11,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-08 02:53-0300\n"
+"POT-Creation-Date: 2025-05-16 14:19+0000\n"
 "PO-Revision-Date: 2024-07-20 00:54+0000\n"
 "Last-Translator: Stan Ulbrych, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -137,6 +137,14 @@ msgid ""
 "or the functional syntax instead."
 msgstr ""
 
+msgid ""
+"When using the functional syntax of :class:`~typing.TypedDict`\\s, failing "
+"to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or "
+"passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated "
+"since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = "
+"TypedDict(\"TD\", {})`` to create a TypedDict with zero field."
+msgstr ""
+
 msgid ""
 "The :func:`typing.no_type_check_decorator` decorator function has been "
 "deprecated since Python 3.13. After eight years in the :mod:`typing` module, "

library/annotationlib.po

@@ -12,7 +12,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-08 02:53-0300\n"
+"POT-Creation-Date: 2025-05-16 14:19+0000\n"
 "PO-Revision-Date: 2025-05-08 06:04+0000\n"
 "Last-Translator: Tomasz Rodzen <[email protected]>, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -186,6 +186,15 @@ msgstr ""
 msgid "Values are the result of evaluating the annotation expressions."
 msgstr ""
 
+msgid ""
+"Special value used to signal that an annotate function is being evaluated in "
+"a special environment with fake globals. When passed this value, annotate "
+"functions should either return the same value as for the :attr:`Format."
+"VALUE` format, or raise :exc:`NotImplementedError` to signal that they do "
+"not support execution in this environment. This format is only used "
+"internally and should not be passed to the functions in this module."
+msgstr ""
+
 msgid ""
 "Values are real annotation values (as per :attr:`Format.VALUE` format) for "
 "defined values, and :class:`ForwardRef` proxies for undefined values. Real "
@@ -202,15 +211,6 @@ msgid ""
 "The exact values of these strings may change in future versions of Python."
 msgstr ""
 
-msgid ""
-"Special value used to signal that an annotate function is being evaluated in "
-"a special environment with fake globals. When passed this value, annotate "
-"functions should either return the same value as for the :attr:`Format."
-"VALUE` format, or raise :exc:`NotImplementedError` to signal that they do "
-"not support execution in this environment. This format is only used "
-"internally and should not be passed to the functions in this module."
-msgstr ""
-
 msgid "A proxy object for forward references in annotations."
 msgstr ""
 
@@ -604,3 +604,202 @@ msgid ""
 "attribute\n"
 "      return typ"
 msgstr ""
+
+msgid "Limitations of the ``STRING`` format"
+msgstr ""
+
+msgid ""
+"The :attr:`~Format.STRING` format is meant to approximate the source code of "
+"the annotation, but the implementation strategy used means that it is not "
+"always possible to recover the exact source code."
+msgstr ""
+
+msgid ""
+"First, the stringifier of course cannot recover any information that is not "
+"present in the compiled code, including comments, whitespace, "
+"parenthesization, and operations that get simplified by the compiler."
+msgstr ""
+
+msgid ""
+"Second, the stringifier can intercept almost all operations that involve "
+"names looked up in some scope, but it cannot intercept operations that "
+"operate fully on constants. As a corollary, this also means it is not safe "
+"to request the ``STRING`` format on untrusted code: Python is powerful "
+"enough that it is possible to achieve arbitrary code execution even with no "
+"access to any globals or builtins. For example:"
+msgstr ""
+
+msgid ""
+">>> def f(x: (1).__class__.__base__.__subclasses__()[-1].__init__."
+"__builtins__[\"print\"](\"Hello world\")): pass\n"
+"...\n"
+">>> annotationlib.get_annotations(f, format=annotationlib.Format.SOURCE)\n"
+"Hello world\n"
+"{'x': 'None'}"
+msgstr ""
+
+msgid ""
+"This particular example works as of the time of writing, but it relies on "
+"implementation details and is not guaranteed to work in the future."
+msgstr ""
+
+msgid ""
+"Among the different kinds of expressions that exist in Python, as "
+"represented by the :mod:`ast` module, some expressions are supported, "
+"meaning that the ``STRING`` format can generally recover the original source "
+"code; others are unsupported, meaning that they may result in incorrect "
+"output or an error."
+msgstr ""
+
+msgid "The following are supported (sometimes with caveats):"
+msgstr ""
+
+msgid ":class:`ast.BinOp`"
+msgstr ""
+
+msgid ":class:`ast.UnaryOp`"
+msgstr ""
+
+msgid ""
+":class:`ast.Invert` (``~``), :class:`ast.UAdd` (``+``), and :class:`ast."
+"USub` (``-``) are supported"
+msgstr ""
+
+msgid ":class:`ast.Not` (``not``) is not supported"
+msgstr ""
+
+msgid ":class:`ast.Dict` (except when using ``**`` unpacking)"
+msgstr ""
+
+msgid ":class:`ast.Set`"
+msgstr ""
+
+msgid ":class:`ast.Compare`"
+msgstr ""
+
+msgid ":class:`ast.Eq` and :class:`ast.NotEq` are supported"
+msgstr ""
+
+msgid ""
+":class:`ast.Lt`, :class:`ast.LtE`, :class:`ast.Gt`, and :class:`ast.GtE` are "
+"supported, but the operand may be flipped"
+msgstr ""
+
+msgid ""
+":class:`ast.Is`, :class:`ast.IsNot`, :class:`ast.In`, and :class:`ast.NotIn` "
+"are not supported"
+msgstr ""
+
+msgid ":class:`ast.Call` (except when using ``**`` unpacking)"
+msgstr ""
+
+msgid ""
+":class:`ast.Constant` (though not the exact representation of the constant; "
+"for example, escape sequences in strings are lost; hexadecimal numbers are "
+"converted to decimal)"
+msgstr ""
+
+msgid ":class:`ast.Attribute` (assuming the value is not a constant)"
+msgstr ""
+
+msgid ":class:`ast.Subscript` (assuming the value is not a constant)"
+msgstr ""
+
+msgid ":class:`ast.Starred` (``*`` unpacking)"
+msgstr ""
+
+msgid ":class:`ast.Name`"
+msgstr ""
+
+msgid ":class:`ast.List`"
+msgstr ""
+
+msgid ":class:`ast.Tuple`"
+msgstr ""
+
+msgid ":class:`ast.Slice`"
+msgstr ""
+
+msgid ""
+"The following are unsupported, but throw an informative error when "
+"encountered by the stringifier:"
+msgstr ""
+
+msgid ""
+":class:`ast.FormattedValue` (f-strings; error is not detected if conversion "
+"specifiers like ``!r`` are used)"
+msgstr ""
+
+msgid ":class:`ast.JoinedStr` (f-strings)"
+msgstr ""
+
+msgid "The following are unsupported and result in incorrect output:"
+msgstr ""
+
+msgid ":class:`ast.BoolOp` (``and`` and ``or``)"
+msgstr ""
+
+msgid ":class:`ast.IfExp`"
+msgstr ""
+
+msgid ":class:`ast.Lambda`"
+msgstr ""
+
+msgid ":class:`ast.ListComp`"
+msgstr ""
+
+msgid ":class:`ast.SetComp`"
+msgstr ""
+
+msgid ":class:`ast.DictComp`"
+msgstr ""
+
+msgid ":class:`ast.GeneratorExp`"
+msgstr ""
+
+msgid ""
+"The following are disallowed in annotation scopes and therefore not relevant:"
+msgstr ""
+
+msgid ":class:`ast.NamedExpr` (``:=``)"
+msgstr ""
+
+msgid ":class:`ast.Await`"
+msgstr ""
+
+msgid ":class:`ast.Yield`"
+msgstr ""
+
+msgid ":class:`ast.YieldFrom`"
+msgstr ""
+
+msgid "Limitations of the ``FORWARDREF`` format"
+msgstr ""
+
+msgid ""
+"The :attr:`~Format.FORWARDREF` format aims to produce real values as much as "
+"possible, with anything that cannot be resolved replaced with :class:"
+"`ForwardRef` objects. It is affected by broadly the same Limitations as the :"
+"attr:`~Format.STRING` format: annotations that perform operations on "
+"literals or that use unsupported expression types may raise exceptions when "
+"evaluated using the :attr:`~Format.FORWARDREF` format."
+msgstr ""
+
+msgid "Below are a few examples of the behavior with unsupported expressions:"
+msgstr ""
+
+msgid ""
+">>> from annotationlib import get_annotations, Format\n"
+">>> def zerodiv(x: 1 / 0): ...\n"
+">>> get_annotations(zerodiv, format=Format.STRING)\n"
+"Traceback (most recent call last):\n"
+"  ...\n"
+"ZeroDivisionError: division by zero\n"
+">>> get_annotations(zerodiv, format=Format.FORWARDREF)\n"
+"Traceback (most recent call last):\n"
+"  ...\n"
+"ZeroDivisionError: division by zero\n"
+">>> def ifexp(x: 1 if y else 0): ...\n"
+">>> get_annotations(ifexp, format=Format.STRING)\n"
+"{'x': '1'}"
+msgstr ""

library/datetime.po

@@ -14,7 +14,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-08 02:53-0300\n"
+"POT-Creation-Date: 2025-05-16 14:19+0000\n"
 "PO-Revision-Date: 2021-06-28 01:04+0000\n"
 "Last-Translator: Stan Ulbrych, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -346,6 +346,24 @@ msgid ""
 "(-1, 86399, 999999)"
 msgstr ""
 
+msgid ""
+"Since the string representation of :class:`!timedelta` objects can be "
+"confusing, use the following recipe to produce a more readable format:"
+msgstr ""
+
+msgid ""
+">>> def pretty_timedelta(td):\n"
+"...     if td.days >= 0:\n"
+"...         return str(td)\n"
+"...     return f'-({-td!s})'\n"
+"...\n"
+">>> d = timedelta(hours=-1)\n"
+">>> str(d)  # not human-friendly\n"
+"'-1 day, 23:00:00'\n"
+">>> pretty_timedelta(d)\n"
+"'-(1:00:00)'"
+msgstr ""
+
 msgid "Class attributes:"
 msgstr ""
 

library/math.po

@@ -13,7 +13,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-05-08 02:53-0300\n"
+"POT-Creation-Date: 2025-05-16 14:19+0000\n"
 "PO-Revision-Date: 2021-06-28 01:09+0000\n"
 "Last-Translator: Stan Ulbrych, 2025\n"
 "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -484,9 +484,7 @@ msgid ""
 "exc:`ValueError` if either of the arguments are negative."
 msgstr ""
 
-msgid ""
-"Return *n* factorial as an integer.  Raises :exc:`ValueError` if *n* is not "
-"integral or is negative."
+msgid "Return factorial of the nonnegative integer *n*."
 msgstr ""
 
 msgid "Floats with integral values (like ``5.0``) are no longer accepted."