Skip to content

Navigation Menu

Sign in

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Commit 1c89b38

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

19 files changed

+597
-2016
lines changed

‎README.en.md

Copy file name to clipboardExpand all lines: README.en.md
+1-1Lines 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

Copy file name to clipboardExpand all lines: README.md
+1-1Lines 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

Copy file name to clipboardExpand all lines: c-api/unicode.po
+9-1Lines 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

Copy file name to clipboardExpand all lines: deprecations/index.po
+9-1Lines 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

Copy file name to clipboardExpand all lines: deprecations/pending-removal-in-3.15.po
+9-1Lines 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

Copy file name to clipboardExpand all lines: library/annotationlib.po
+209-10Lines 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

Copy file name to clipboardExpand all lines: library/datetime.po
+19-1Lines 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

Copy file name to clipboardExpand all lines: library/math.po
+2-4Lines 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 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.