Skip to content

Commit b7bf434

Browse files
author
GitHub Action's update-translation job
committed
Update translation from Transifex
Co-Authored-By: python-doc bot
1 parent c1d52a3 commit b7bf434

13 files changed

Lines changed: 269 additions & 130 deletions

File tree

README.en.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
1616
''')
1717
]]] -->
1818
[![build](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml)
19-
[![core 100.00%](https://img.shields.io/badge/core-100.00%25-0.svg)](https://translations.python.org/#pl)
19+
[![core 99.94%](https://img.shields.io/badge/core-99.94%25-0.svg)](https://translations.python.org/#pl)
2020
[![Total Translation of Documentation](https://img.shields.io/badge/total_words-5.69%25-0.svg)](https://translations.python.org/#pl)
21-
[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.46%25-0.svg)](https://translations.python.org/#pl)
21+
[![Total Translation of Documentation](https://img.shields.io/badge/total_strings-12.45%25-0.svg)](https://translations.python.org/#pl)
2222
[![lint errors count](https://shields.io/badge/dynamic/xml?url=https%3A%2F%2Ftranslations.python.org%2Fbuild-details.html&query=%2F%2Ftr%5Btd%5B%40data-label%3D%27language%27%20and%20contains%28.%2C%20%27%28pl%29%27%29%5D%5D%20%20%20%2F%2Ftd%5B%40data-label%3D%27lint%27%5D%2Fa%2Ftext()&label=lint%20errors)](https://github.com/python/python-docs-pl/actions/workflows/lint.yml)
2323

2424
<!-- [[[end]]] -->

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,9 @@ f'''[![build](https://github.com/python/python-docs-pl/actions/workflows/update-
1616
''')
1717
]]] -->
1818
[![build](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml/badge.svg)](https://github.com/python/python-docs-pl/actions/workflows/update-and-build.yml)
19-
[![podstawowe artykuły 100.00%](https://img.shields.io/badge/podstawowe_artykuły-100.00%25-0.svg)](https://translations.python.org/#pl)
19+
[![podstawowe artykuły 99.94%](https://img.shields.io/badge/podstawowe_artykuły-99.94%25-0.svg)](https://translations.python.org/#pl)
2020
[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_słów-5.69%25-0.svg)](https://translations.python.org/#pl)
21-
[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.46%25-0.svg)](https://translations.python.org/#pl)
21+
[![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość_napisów-12.45%25-0.svg)](https://translations.python.org/#pl)
2222
[![liczba błędów lintowania](https://shields.io/badge/dynamic/xml?url=https%3A%2F%2Ftranslations.python.org%2Fbuild-details.html&query=%2F%2Ftr%5Btd%5B%40data-label%3D%27language%27%20and%20contains%28.%2C%20%27%28pl%29%27%29%5D%5D%20%20%20%2F%2Ftd%5B%40data-label%3D%27lint%27%5D%2Fa%2Ftext()&label=b%C5%82%C4%99dy%20lintowania)](https://github.com/python/python-docs-pl/actions/workflows/lint.yml)
2323

2424
<!-- [[[end]]] -->

c-api/init_config.po

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ msgid ""
1212
msgstr ""
1313
"Project-Id-Version: Python 3.15\n"
1414
"Report-Msgid-Bugs-To: \n"
15-
"POT-Creation-Date: 2026-07-07 16:22+0000\n"
15+
"POT-Creation-Date: 2026-07-27 16:10+0000\n"
1616
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
1717
"Last-Translator: Blessing Oluronbi, 2026\n"
1818
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"

deprecations/index.po

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ msgid ""
1212
msgstr ""
1313
"Project-Id-Version: Python 3.15\n"
1414
"Report-Msgid-Bugs-To: \n"
15-
"POT-Creation-Date: 2026-07-17 15:08+0000\n"
15+
"POT-Creation-Date: 2026-07-29 15:50+0000\n"
1616
"PO-Revision-Date: 2025-09-16 00:00+0000\n"
1717
"Last-Translator: Blessing Oluronbi, 2026\n"
1818
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
@@ -487,6 +487,16 @@ msgstr ""
487487
"lub :class:`!ast.expr`) Jest przestarzały i będzie rzucić jakiś błąd w "
488488
"Python 3.20."
489489

490+
msgid ""
491+
"It is deprecated to call :func:`isinstance` and :func:`issubclass` checks on "
492+
"protocol classes that were not explicitly decorated with :func:`!"
493+
"runtime_checkable` but that inherit from a runtime-checkable protocol class. "
494+
"This will raise a :exc:`TypeError` in Python 3.20."
495+
msgstr ""
496+
497+
msgid "(Contributed by Bartosz Sławecki in :gh:`132604`.)"
498+
msgstr ""
499+
490500
msgid "Pending removal in future versions"
491501
msgstr ""
492502

library/difflib.po

Lines changed: 147 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,16 @@
44
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55
#
66
# Translators:
7-
# python-doc bot, 2025
7+
# python-doc bot, 2026
88
#
99
#, fuzzy
1010
msgid ""
1111
msgstr ""
1212
"Project-Id-Version: Python 3.15\n"
1313
"Report-Msgid-Bugs-To: \n"
14-
"POT-Creation-Date: 2026-07-25 14:57+0000\n"
14+
"POT-Creation-Date: 2026-07-29 15:50+0000\n"
1515
"PO-Revision-Date: 2025-09-16 00:01+0000\n"
16-
"Last-Translator: python-doc bot, 2025\n"
16+
"Last-Translator: python-doc bot, 2026\n"
1717
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
1818
"MIME-Version: 1.0\n"
1919
"Content-Type: text/plain; charset=UTF-8\n"
@@ -30,51 +30,100 @@ msgid "**Source code:** :source:`Lib/difflib.py`"
3030
msgstr "**Kod źródłowy:** :source:`Lib/difflib.py`"
3131

3232
msgid ""
33-
"This module provides classes and functions for comparing sequences. It can "
34-
"be used for example, for comparing files, and can produce information about "
35-
"file differences in various formats, including HTML and context and unified "
36-
"diffs. For comparing directories and files, see also, the :mod:`filecmp` "
37-
"module."
33+
"This module provides classes and functions for comparing sequences. Most of "
34+
"them compare sequences of text lines (for example lists of strings, or :term:"
35+
"`file objects <file object>`) and produce :dfn:`diffs` -- reports on the "
36+
"differences. Diffs can be produced in in various formats, including HTML and "
37+
"context and unified diffs -- formats produced by tools like :manpage:`diff "
38+
"<diff(1)>` and :manpage:`git diff <git-diff(1)>`."
3839
msgstr ""
3940

4041
msgid ""
41-
"This is a flexible class for comparing pairs of sequences of any type, so "
42-
"long as the sequence elements are :term:`hashable`. The basic algorithm "
43-
"predates, and is a little fancier than, an algorithm published in the late "
44-
"1980's by Ratcliff and Obershelp under the hyperbolic name \"gestalt pattern "
45-
"matching.\" The idea is to find the longest contiguous matching subsequence "
46-
"that contains no \"junk\" elements; these \"junk\" elements are ones that "
47-
"are uninteresting in some sense, such as blank lines or whitespace. "
48-
"(Handling junk is an extension to the Ratcliff and Obershelp algorithm.) The "
49-
"same idea is then applied recursively to the pieces of the sequences to the "
50-
"left and to the right of the matching subsequence. This does not yield "
51-
"minimal edit sequences, but does tend to yield matches that \"look right\" "
52-
"to people."
42+
"Comparisons are done using a matching algorithm implemented in :class:"
43+
"`SequenceMatcher` -- a flexible class for comparing pairs of sequences of "
44+
"any type, not just text, so long as the sequence elements are :term:"
45+
"`hashable`."
46+
msgstr ""
47+
48+
msgid "Junk heuristic"
5349
msgstr ""
5450

5551
msgid ""
56-
"**Timing:** The basic Ratcliff-Obershelp algorithm is cubic time in the "
57-
"worst case and quadratic time in the expected case. :class:`SequenceMatcher` "
58-
"is quadratic time for the worst case and has expected-case behavior "
59-
"dependent in a complicated way on how many elements the sequences have in "
60-
"common; best case time is linear."
52+
":mod:`!difflib` uses a :dfn:`junk` heuristic: some items are deemed to be :"
53+
"dfn:`junk`, and ignored when searching for similarities. Ideally, these are "
54+
"uninteresting or common items, such as blank lines or whitespace."
6155
msgstr ""
6256

6357
msgid ""
64-
"**Junk**: :class:`SequenceMatcher` accepts an ``isjunk`` predicate and an "
65-
"``autojunk`` flag. Items that are considered as junk will not be considered "
66-
"to find similar content blocks. This can produce better results for humans "
67-
"(typically breaking on whitespace) and faster (because it reduces the number "
68-
"of possible combinations). But it can also cause pathological cases where "
69-
"too many items considered junk cause an unexpectedly large (but correct) "
70-
"diff result. You should consider tuning them or turning them off depending "
71-
"on your data. Moreover, only the second sequence is inspected for junk. This "
72-
"causes the diff output to not be symmetrical. When ``autojunk=True``, it "
73-
"will consider as junk the items that account for more than 1% of the "
74-
"sequence, if it is at least 200 items long."
58+
"This heuristic can speed the algorithm up (because it reduces the number of "
59+
"possible combinations) and it can produce results that are more "
60+
"understandable for humans (typically breaking on whitespace). But it can "
61+
"also cause pathological cases:"
7562
msgstr ""
7663

77-
msgid "Added the *autojunk* parameter."
64+
msgid ""
65+
"Inappropriately chosen junk items can cause an unexpectedly **large** (but "
66+
"still correct) result."
67+
msgstr ""
68+
69+
msgid ""
70+
"The default heuristic is **asymmetric**: only the second sequence is "
71+
"inspected when determining what is considered junk, so comparing A to B can "
72+
"give different results than comparing B to A and reversing the result."
73+
msgstr ""
74+
75+
msgid ""
76+
"By default, if the second input sequence is at least 200 items long, items "
77+
"that account for more than 1% it are considered *junk*."
78+
msgstr ""
79+
80+
msgid ""
81+
"Depending on your data, you should consider turning this heuristic off "
82+
"(setting :class:`~difflib.SequenceMatcher`'s *autojunk* argument to to "
83+
"``False``) or tuning it (using the *isjunk* argument, perhaps to one of the :"
84+
"ref:`predefined functions <difflib-isjunk-functions>`)."
85+
msgstr ""
86+
87+
msgid "The :mod:`!difflib` algorithm"
88+
msgstr ""
89+
90+
msgid ""
91+
"The algorithm used in :class:`SequenceMatcher` predates, and is a little "
92+
"fancier than, an algorithm published in the late 1980s by Ratcliff and "
93+
"Obershelp under the hyperbolic name \"gestalt pattern matching.\" The idea "
94+
"is to find the longest contiguous subsequence common to both inputs, then "
95+
"recursively handle the pieces of the sequences to the left and to the right "
96+
"of the matching subsequence."
97+
msgstr ""
98+
99+
msgid ""
100+
"`Pattern Matching: The Gestalt Approach <https://jacobfilipp.com/DrDobbs/"
101+
"articles/DDJ/1988/8807/8807c/8807c.htm>`_"
102+
msgstr ""
103+
104+
msgid ""
105+
"Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. "
106+
"This was published in Dr. Dobb's Journal in July, 1988."
107+
msgstr ""
108+
109+
msgid ""
110+
"As an extension to the Ratcliff and Obershelp algorithm, :mod:`!difflib` "
111+
"searches for the longest *junk-free* contiguous subsequence. See the :ref:"
112+
"`difflib-junk` section for details."
113+
msgstr ""
114+
115+
msgid "Timing"
116+
msgstr ""
117+
118+
msgid ""
119+
"The basic Ratcliff-Obershelp algorithm is cubic time in the worst case and "
120+
"quadratic time in the expected case. :mod:`difflib`'s algorithm is quadratic "
121+
"time for the worst case and has expected-case behavior dependent in a "
122+
"complicated way on how many elements the sequences have in common; best case "
123+
"time is linear."
124+
msgstr ""
125+
126+
msgid "Diff generation"
78127
msgstr ""
79128

80129
msgid ""
@@ -124,6 +173,58 @@ msgid ""
124173
"tabs or line breaks."
125174
msgstr ""
126175

176+
msgid ""
177+
"Note that :class:`Differ`\\ -generated deltas make no claim to be "
178+
"**minimal** diffs. To the contrary, minimal diffs are often counter-"
179+
"intuitive for humans, because they synch up anywhere possible, sometimes at "
180+
"accidental matches 100 pages apart. Restricting synch points to contiguous "
181+
"matches preserves some notion of locality, at the occasional cost of "
182+
"producing a longer diff."
183+
msgstr ""
184+
185+
msgid "The :class:`Differ` class has this constructor:"
186+
msgstr ""
187+
188+
msgid ""
189+
"Optional keyword parameters *linejunk* and *charjunk* are for filter "
190+
"functions (or ``None``):"
191+
msgstr ""
192+
193+
msgid ""
194+
"*linejunk*: A function that accepts a single string argument, and returns "
195+
"true if the string is junk. The default is ``None``, meaning that no line "
196+
"is considered junk."
197+
msgstr ""
198+
199+
msgid ""
200+
"*charjunk*: A function that accepts a single character argument (a string of "
201+
"length 1), and returns true if the character is junk. The default is "
202+
"``None``, meaning that no character is considered junk."
203+
msgstr ""
204+
205+
msgid ""
206+
"These junk-filtering functions speed up matching to find differences and do "
207+
"not cause any differing lines or characters to be ignored. Read the "
208+
"description of the :meth:`~SequenceMatcher.find_longest_match` method's "
209+
"*isjunk* parameter for an explanation."
210+
msgstr ""
211+
212+
msgid ""
213+
":class:`Differ` objects are used (deltas generated) via a single method:"
214+
msgstr ""
215+
216+
msgid ""
217+
"Compare two sequences of lines, and generate the delta (a sequence of lines)."
218+
msgstr ""
219+
220+
msgid ""
221+
"Each sequence must contain individual single-line strings ending with "
222+
"newlines. Such sequences can be obtained from the :meth:`~io.IOBase."
223+
"readlines` method of file-like objects. The generated delta also consists "
224+
"of newline-terminated strings, ready to be printed as-is via the :meth:`~io."
225+
"IOBase.writelines` method of a file-like object."
226+
msgstr ""
227+
127228
msgid ""
128229
"This class can be used to create an HTML table (or a complete HTML file "
129230
"containing the table) showing a side by side, line by line comparison of "
@@ -354,6 +455,9 @@ msgid ""
354455
"unknown/inconsistent encodings as *a* and *b*."
355456
msgstr ""
356457

458+
msgid "Junk definition functions"
459+
msgstr ""
460+
357461
msgid ""
358462
"Return ``True`` for ignorable lines. The line *line* is ignorable if *line* "
359463
"is blank or contains a single ``'#'``, otherwise it is not ignorable. Used "
@@ -366,22 +470,9 @@ msgid ""
366470
"for parameter *charjunk* in :func:`ndiff`."
367471
msgstr ""
368472

369-
msgid ""
370-
"`Pattern Matching: The Gestalt Approach <https://jacobfilipp.com/DrDobbs/"
371-
"articles/DDJ/1988/8807/8807c/8807c.htm>`_"
372-
msgstr ""
373-
374-
msgid ""
375-
"Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. "
376-
"This was published in Dr. Dobb's Journal in July, 1988."
377-
msgstr ""
378-
379473
msgid "SequenceMatcher objects"
380474
msgstr ""
381475

382-
msgid "The :class:`SequenceMatcher` class has this constructor:"
383-
msgstr ""
384-
385476
msgid ""
386477
"Optional argument *isjunk* must be ``None`` (the default) or a one-argument "
387478
"function that takes a sequence element and returns true if and only if the "
@@ -409,6 +500,9 @@ msgid ""
409500
"heuristic."
410501
msgstr ""
411502

503+
msgid "Added the *autojunk* parameter."
504+
msgstr ""
505+
412506
msgid ""
413507
"SequenceMatcher objects get three data attributes: *bjunk* is the set of "
414508
"elements of *b* for which *isjunk* is ``True``; *bpopular* is the set of non-"
@@ -600,6 +694,9 @@ msgid ""
600694
"ratio`:"
601695
msgstr ""
602696

697+
msgid "Examples"
698+
msgstr "Przykłady"
699+
603700
msgid "SequenceMatcher examples"
604701
msgstr ""
605702

@@ -640,61 +737,6 @@ msgid ""
640737
"`SequenceMatcher`."
641738
msgstr ""
642739

643-
msgid "Differ objects"
644-
msgstr ""
645-
646-
msgid ""
647-
"Note that :class:`Differ`\\ -generated deltas make no claim to be "
648-
"**minimal** diffs. To the contrary, minimal diffs are often counter-"
649-
"intuitive, because they synch up anywhere possible, sometimes accidental "
650-
"matches 100 pages apart. Restricting synch points to contiguous matches "
651-
"preserves some notion of locality, at the occasional cost of producing a "
652-
"longer diff."
653-
msgstr ""
654-
655-
msgid "The :class:`Differ` class has this constructor:"
656-
msgstr ""
657-
658-
msgid ""
659-
"Optional keyword parameters *linejunk* and *charjunk* are for filter "
660-
"functions (or ``None``):"
661-
msgstr ""
662-
663-
msgid ""
664-
"*linejunk*: A function that accepts a single string argument, and returns "
665-
"true if the string is junk. The default is ``None``, meaning that no line "
666-
"is considered junk."
667-
msgstr ""
668-
669-
msgid ""
670-
"*charjunk*: A function that accepts a single character argument (a string of "
671-
"length 1), and returns true if the character is junk. The default is "
672-
"``None``, meaning that no character is considered junk."
673-
msgstr ""
674-
675-
msgid ""
676-
"These junk-filtering functions speed up matching to find differences and do "
677-
"not cause any differing lines or characters to be ignored. Read the "
678-
"description of the :meth:`~SequenceMatcher.find_longest_match` method's "
679-
"*isjunk* parameter for an explanation."
680-
msgstr ""
681-
682-
msgid ""
683-
":class:`Differ` objects are used (deltas generated) via a single method:"
684-
msgstr ""
685-
686-
msgid ""
687-
"Compare two sequences of lines, and generate the delta (a sequence of lines)."
688-
msgstr ""
689-
690-
msgid ""
691-
"Each sequence must contain individual single-line strings ending with "
692-
"newlines. Such sequences can be obtained from the :meth:`~io.IOBase."
693-
"readlines` method of file-like objects. The delta generated also consists "
694-
"of newline-terminated strings, ready to be printed as-is via the :meth:`~io."
695-
"IOBase.writelines` method of a file-like object."
696-
msgstr ""
697-
698740
msgid "Differ example"
699741
msgstr ""
700742

0 commit comments

Comments
 (0)