Skip to content

Commit 1c89b38

Browse files
author
GitHub Action's update-translation job
committed
Update translation from Transifex
1 parent 98118f6 commit 1c89b38

19 files changed

+597
-2016
lines changed

‎README.en.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l
1313
![{translators} Translators](https://img.shields.io/badge/Translators-{translators}-0.svg)''')
1414
]]] -->
1515
![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)
16-
![Total Translation of Documentation](https://img.shields.io/badge/Total-5.169%25-0.svg)
16+
![Total Translation of Documentation](https://img.shields.io/badge/Total-4.701%25-0.svg)
1717
![24 Translators](https://img.shields.io/badge/Translators-24-0.svg)
1818
<!-- [[[end]]] -->
1919

‎README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l
1313
![{translators} tłumaczy](https://img.shields.io/badge/tłumaczy-{translators}-0.svg)''')
1414
]]] -->
1515
![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg)
16-
![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-5.169%25-0.svg)
16+
![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-4.701%25-0.svg)
1717
![24 tłumaczy](https://img.shields.io/badge/tłumaczy-24-0.svg)
1818
<!-- [[[end]]] -->
1919

‎c-api/unicode.po

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ msgid ""
1212
msgstr ""
1313
"Project-Id-Version: Python 3.14\n"
1414
"Report-Msgid-Bugs-To: \n"
15-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
15+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1616
"PO-Revision-Date: 2021-06-28 00:50+0000\n"
1717
"Last-Translator: Stan Ulbrych, 2025\n"
1818
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -729,6 +729,14 @@ msgid ""
729729
"difference being that it decrements the reference count of *right* by one."
730730
msgstr ""
731731

732+
msgid ""
733+
"Return a mapping suitable for decoding a custom single-byte encoding. Given "
734+
"a Unicode string *string* of up to 256 characters representing an encoding "
735+
"table, returns either a compact internal mapping object or a dictionary "
736+
"mapping character ordinals to byte values. Raises a :exc:`TypeError` and "
737+
"return ``NULL`` on invalid input."
738+
msgstr ""
739+
732740
msgid ""
733741
"Return the name of the default string encoding, ``\"utf-8\"``. See :func:"
734742
"`sys.getdefaultencoding`."

‎deprecations/index.po

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ msgid ""
1212
msgstr ""
1313
"Project-Id-Version: Python 3.14\n"
1414
"Report-Msgid-Bugs-To: \n"
15-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
15+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1616
"PO-Revision-Date: 2024-07-29 04:07+0000\n"
1717
"Last-Translator: Stan Ulbrych, 2025\n"
1818
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -141,6 +141,14 @@ msgid ""
141141
"or the functional syntax instead."
142142
msgstr ""
143143

144+
msgid ""
145+
"When using the functional syntax of :class:`~typing.TypedDict`\\s, failing "
146+
"to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or "
147+
"passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated "
148+
"since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = "
149+
"TypedDict(\"TD\", {})`` to create a TypedDict with zero field."
150+
msgstr ""
151+
144152
msgid ""
145153
"The :func:`typing.no_type_check_decorator` decorator function has been "
146154
"deprecated since Python 3.13. After eight years in the :mod:`typing` module, "

‎deprecations/pending-removal-in-3.15.po

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ msgid ""
1111
msgstr ""
1212
"Project-Id-Version: Python 3.14\n"
1313
"Report-Msgid-Bugs-To: \n"
14-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
14+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1515
"PO-Revision-Date: 2024-07-20 00:54+0000\n"
1616
"Last-Translator: Stan Ulbrych, 2025\n"
1717
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -137,6 +137,14 @@ msgid ""
137137
"or the functional syntax instead."
138138
msgstr ""
139139

140+
msgid ""
141+
"When using the functional syntax of :class:`~typing.TypedDict`\\s, failing "
142+
"to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or "
143+
"passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated "
144+
"since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = "
145+
"TypedDict(\"TD\", {})`` to create a TypedDict with zero field."
146+
msgstr ""
147+
140148
msgid ""
141149
"The :func:`typing.no_type_check_decorator` decorator function has been "
142150
"deprecated since Python 3.13. After eight years in the :mod:`typing` module, "

‎library/annotationlib.po

Lines changed: 209 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ msgid ""
1212
msgstr ""
1313
"Project-Id-Version: Python 3.14\n"
1414
"Report-Msgid-Bugs-To: \n"
15-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
15+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1616
"PO-Revision-Date: 2025-05-08 06:04+0000\n"
1717
"Last-Translator: Tomasz Rodzen <t.rodzen@poczta.fm>, 2025\n"
1818
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -186,6 +186,15 @@ msgstr ""
186186
msgid "Values are the result of evaluating the annotation expressions."
187187
msgstr ""
188188

189+
msgid ""
190+
"Special value used to signal that an annotate function is being evaluated in "
191+
"a special environment with fake globals. When passed this value, annotate "
192+
"functions should either return the same value as for the :attr:`Format."
193+
"VALUE` format, or raise :exc:`NotImplementedError` to signal that they do "
194+
"not support execution in this environment. This format is only used "
195+
"internally and should not be passed to the functions in this module."
196+
msgstr ""
197+
189198
msgid ""
190199
"Values are real annotation values (as per :attr:`Format.VALUE` format) for "
191200
"defined values, and :class:`ForwardRef` proxies for undefined values. Real "
@@ -202,15 +211,6 @@ msgid ""
202211
"The exact values of these strings may change in future versions of Python."
203212
msgstr ""
204213

205-
msgid ""
206-
"Special value used to signal that an annotate function is being evaluated in "
207-
"a special environment with fake globals. When passed this value, annotate "
208-
"functions should either return the same value as for the :attr:`Format."
209-
"VALUE` format, or raise :exc:`NotImplementedError` to signal that they do "
210-
"not support execution in this environment. This format is only used "
211-
"internally and should not be passed to the functions in this module."
212-
msgstr ""
213-
214214
msgid "A proxy object for forward references in annotations."
215215
msgstr ""
216216

@@ -604,3 +604,202 @@ msgid ""
604604
"attribute\n"
605605
" return typ"
606606
msgstr ""
607+
608+
msgid "Limitations of the ``STRING`` format"
609+
msgstr ""
610+
611+
msgid ""
612+
"The :attr:`~Format.STRING` format is meant to approximate the source code of "
613+
"the annotation, but the implementation strategy used means that it is not "
614+
"always possible to recover the exact source code."
615+
msgstr ""
616+
617+
msgid ""
618+
"First, the stringifier of course cannot recover any information that is not "
619+
"present in the compiled code, including comments, whitespace, "
620+
"parenthesization, and operations that get simplified by the compiler."
621+
msgstr ""
622+
623+
msgid ""
624+
"Second, the stringifier can intercept almost all operations that involve "
625+
"names looked up in some scope, but it cannot intercept operations that "
626+
"operate fully on constants. As a corollary, this also means it is not safe "
627+
"to request the ``STRING`` format on untrusted code: Python is powerful "
628+
"enough that it is possible to achieve arbitrary code execution even with no "
629+
"access to any globals or builtins. For example:"
630+
msgstr ""
631+
632+
msgid ""
633+
">>> def f(x: (1).__class__.__base__.__subclasses__()[-1].__init__."
634+
"__builtins__[\"print\"](\"Hello world\")): pass\n"
635+
"...\n"
636+
">>> annotationlib.get_annotations(f, format=annotationlib.Format.SOURCE)\n"
637+
"Hello world\n"
638+
"{'x': 'None'}"
639+
msgstr ""
640+
641+
msgid ""
642+
"This particular example works as of the time of writing, but it relies on "
643+
"implementation details and is not guaranteed to work in the future."
644+
msgstr ""
645+
646+
msgid ""
647+
"Among the different kinds of expressions that exist in Python, as "
648+
"represented by the :mod:`ast` module, some expressions are supported, "
649+
"meaning that the ``STRING`` format can generally recover the original source "
650+
"code; others are unsupported, meaning that they may result in incorrect "
651+
"output or an error."
652+
msgstr ""
653+
654+
msgid "The following are supported (sometimes with caveats):"
655+
msgstr ""
656+
657+
msgid ":class:`ast.BinOp`"
658+
msgstr ""
659+
660+
msgid ":class:`ast.UnaryOp`"
661+
msgstr ""
662+
663+
msgid ""
664+
":class:`ast.Invert` (``~``), :class:`ast.UAdd` (``+``), and :class:`ast."
665+
"USub` (``-``) are supported"
666+
msgstr ""
667+
668+
msgid ":class:`ast.Not` (``not``) is not supported"
669+
msgstr ""
670+
671+
msgid ":class:`ast.Dict` (except when using ``**`` unpacking)"
672+
msgstr ""
673+
674+
msgid ":class:`ast.Set`"
675+
msgstr ""
676+
677+
msgid ":class:`ast.Compare`"
678+
msgstr ""
679+
680+
msgid ":class:`ast.Eq` and :class:`ast.NotEq` are supported"
681+
msgstr ""
682+
683+
msgid ""
684+
":class:`ast.Lt`, :class:`ast.LtE`, :class:`ast.Gt`, and :class:`ast.GtE` are "
685+
"supported, but the operand may be flipped"
686+
msgstr ""
687+
688+
msgid ""
689+
":class:`ast.Is`, :class:`ast.IsNot`, :class:`ast.In`, and :class:`ast.NotIn` "
690+
"are not supported"
691+
msgstr ""
692+
693+
msgid ":class:`ast.Call` (except when using ``**`` unpacking)"
694+
msgstr ""
695+
696+
msgid ""
697+
":class:`ast.Constant` (though not the exact representation of the constant; "
698+
"for example, escape sequences in strings are lost; hexadecimal numbers are "
699+
"converted to decimal)"
700+
msgstr ""
701+
702+
msgid ":class:`ast.Attribute` (assuming the value is not a constant)"
703+
msgstr ""
704+
705+
msgid ":class:`ast.Subscript` (assuming the value is not a constant)"
706+
msgstr ""
707+
708+
msgid ":class:`ast.Starred` (``*`` unpacking)"
709+
msgstr ""
710+
711+
msgid ":class:`ast.Name`"
712+
msgstr ""
713+
714+
msgid ":class:`ast.List`"
715+
msgstr ""
716+
717+
msgid ":class:`ast.Tuple`"
718+
msgstr ""
719+
720+
msgid ":class:`ast.Slice`"
721+
msgstr ""
722+
723+
msgid ""
724+
"The following are unsupported, but throw an informative error when "
725+
"encountered by the stringifier:"
726+
msgstr ""
727+
728+
msgid ""
729+
":class:`ast.FormattedValue` (f-strings; error is not detected if conversion "
730+
"specifiers like ``!r`` are used)"
731+
msgstr ""
732+
733+
msgid ":class:`ast.JoinedStr` (f-strings)"
734+
msgstr ""
735+
736+
msgid "The following are unsupported and result in incorrect output:"
737+
msgstr ""
738+
739+
msgid ":class:`ast.BoolOp` (``and`` and ``or``)"
740+
msgstr ""
741+
742+
msgid ":class:`ast.IfExp`"
743+
msgstr ""
744+
745+
msgid ":class:`ast.Lambda`"
746+
msgstr ""
747+
748+
msgid ":class:`ast.ListComp`"
749+
msgstr ""
750+
751+
msgid ":class:`ast.SetComp`"
752+
msgstr ""
753+
754+
msgid ":class:`ast.DictComp`"
755+
msgstr ""
756+
757+
msgid ":class:`ast.GeneratorExp`"
758+
msgstr ""
759+
760+
msgid ""
761+
"The following are disallowed in annotation scopes and therefore not relevant:"
762+
msgstr ""
763+
764+
msgid ":class:`ast.NamedExpr` (``:=``)"
765+
msgstr ""
766+
767+
msgid ":class:`ast.Await`"
768+
msgstr ""
769+
770+
msgid ":class:`ast.Yield`"
771+
msgstr ""
772+
773+
msgid ":class:`ast.YieldFrom`"
774+
msgstr ""
775+
776+
msgid "Limitations of the ``FORWARDREF`` format"
777+
msgstr ""
778+
779+
msgid ""
780+
"The :attr:`~Format.FORWARDREF` format aims to produce real values as much as "
781+
"possible, with anything that cannot be resolved replaced with :class:"
782+
"`ForwardRef` objects. It is affected by broadly the same Limitations as the :"
783+
"attr:`~Format.STRING` format: annotations that perform operations on "
784+
"literals or that use unsupported expression types may raise exceptions when "
785+
"evaluated using the :attr:`~Format.FORWARDREF` format."
786+
msgstr ""
787+
788+
msgid "Below are a few examples of the behavior with unsupported expressions:"
789+
msgstr ""
790+
791+
msgid ""
792+
">>> from annotationlib import get_annotations, Format\n"
793+
">>> def zerodiv(x: 1 / 0): ...\n"
794+
">>> get_annotations(zerodiv, format=Format.STRING)\n"
795+
"Traceback (most recent call last):\n"
796+
" ...\n"
797+
"ZeroDivisionError: division by zero\n"
798+
">>> get_annotations(zerodiv, format=Format.FORWARDREF)\n"
799+
"Traceback (most recent call last):\n"
800+
" ...\n"
801+
"ZeroDivisionError: division by zero\n"
802+
">>> def ifexp(x: 1 if y else 0): ...\n"
803+
">>> get_annotations(ifexp, format=Format.STRING)\n"
804+
"{'x': '1'}"
805+
msgstr ""

‎library/datetime.po

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ msgid ""
1414
msgstr ""
1515
"Project-Id-Version: Python 3.14\n"
1616
"Report-Msgid-Bugs-To: \n"
17-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
17+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1818
"PO-Revision-Date: 2021-06-28 01:04+0000\n"
1919
"Last-Translator: Stan Ulbrych, 2025\n"
2020
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -346,6 +346,24 @@ msgid ""
346346
"(-1, 86399, 999999)"
347347
msgstr ""
348348

349+
msgid ""
350+
"Since the string representation of :class:`!timedelta` objects can be "
351+
"confusing, use the following recipe to produce a more readable format:"
352+
msgstr ""
353+
354+
msgid ""
355+
">>> def pretty_timedelta(td):\n"
356+
"... if td.days >= 0:\n"
357+
"... return str(td)\n"
358+
"... return f'-({-td!s})'\n"
359+
"...\n"
360+
">>> d = timedelta(hours=-1)\n"
361+
">>> str(d) # not human-friendly\n"
362+
"'-1 day, 23:00:00'\n"
363+
">>> pretty_timedelta(d)\n"
364+
"'-(1:00:00)'"
365+
msgstr ""
366+
349367
msgid "Class attributes:"
350368
msgstr ""
351369

‎library/math.po

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ msgid ""
1313
msgstr ""
1414
"Project-Id-Version: Python 3.14\n"
1515
"Report-Msgid-Bugs-To: \n"
16-
"POT-Creation-Date: 2025-05-08 02:53-0300\n"
16+
"POT-Creation-Date: 2025-05-16 14:19+0000\n"
1717
"PO-Revision-Date: 2021-06-28 01:09+0000\n"
1818
"Last-Translator: Stan Ulbrych, 2025\n"
1919
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -484,9 +484,7 @@ msgid ""
484484
"exc:`ValueError` if either of the arguments are negative."
485485
msgstr ""
486486

487-
msgid ""
488-
"Return *n* factorial as an integer. Raises :exc:`ValueError` if *n* is not "
489-
"integral or is negative."
487+
msgid "Return factorial of the nonnegative integer *n*."
490488
msgstr ""
491489

492490
msgid "Floats with integral values (like ``5.0``) are no longer accepted."

0 commit comments

Comments
 (0)