44# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
55#
66# Translators:
7- # python-doc bot, 2025
7+ # python-doc bot, 2026
88#
99#, fuzzy
1010msgid ""
1111msgstr ""
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`"
3030msgstr "**Kod źródłowy:** :source:`Lib/difflib.py`"
3131
3232msgid ""
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)>`."
3839msgstr ""
3940
4041msgid ""
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"
5349msgstr ""
5450
5551msgid ""
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."
6155msgstr ""
6256
6357msgid ""
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:"
7562msgstr ""
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"
78127msgstr ""
79128
80129msgid ""
@@ -124,6 +173,58 @@ msgid ""
124173"tabs or line breaks."
125174msgstr ""
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+
127228msgid ""
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*."
355456msgstr ""
356457
458+ msgid "Junk definition functions"
459+ msgstr ""
460+
357461msgid ""
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`."
367471msgstr ""
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-
379473msgid "SequenceMatcher objects"
380474msgstr ""
381475
382- msgid "The :class:`SequenceMatcher` class has this constructor:"
383- msgstr ""
384-
385476msgid ""
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."
410501msgstr ""
411502
503+ msgid "Added the *autojunk* parameter."
504+ msgstr ""
505+
412506msgid ""
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`:"
601695msgstr ""
602696
697+ msgid "Examples"
698+ msgstr "Przykłady"
699+
603700msgid "SequenceMatcher examples"
604701msgstr ""
605702
@@ -640,61 +737,6 @@ msgid ""
640737"`SequenceMatcher`."
641738msgstr ""
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-
698740msgid "Differ example"
699741msgstr ""
700742
0 commit comments