1- # Autogenerated by Sphinx on Tue Oct 14 15:52:27 2025
1+ # Autogenerated by Sphinx on Tue Dec 2 13:49:46 2025
22# as part of the release process.
33
44topics = {
@@ -1042,10 +1042,10 @@ class and instance attributes applies as for regular assignments.
10421042 'bltin-ellipsis-object': r'''The Ellipsis Object
10431043*******************
10441044
1045- This object is commonly used used to indicate that something is
1046- omitted. It supports no special operations. There is exactly one
1047- ellipsis object, named "Ellipsis" (a built-in name).
1048- "type(Ellipsis)()" produces the " Ellipsis" singleton.
1045+ This object is commonly used to indicate that something is omitted. It
1046+ supports no special operations. There is exactly one ellipsis object,
1047+ named "Ellipsis" (a built-in name). "type(Ellipsis)()" produces the
1048+ "Ellipsis" singleton.
10491049
10501050It is written as "Ellipsis" or "...".
10511051
@@ -2612,7 +2612,7 @@ class attributes; they are shared by instances. Instance attributes
26122612 If only keyword patterns are present, they are processed as
26132613 follows, one by one:
26142614
2615- I . The keyword is looked up as an attribute on the subject.
2615+ 1 . The keyword is looked up as an attribute on the subject.
26162616
26172617 * If this raises an exception other than "AttributeError", the
26182618 exception bubbles up.
@@ -2624,14 +2624,14 @@ class attributes; they are shared by instances. Instance attributes
26242624 the class pattern fails; if this succeeds, the match proceeds
26252625 to the next keyword.
26262626
2627- II . If all keyword patterns succeed, the class pattern succeeds.
2627+ 2 . If all keyword patterns succeed, the class pattern succeeds.
26282628
26292629 If any positional patterns are present, they are converted to
26302630 keyword patterns using the "__match_args__" attribute on the class
26312631 "name_or_attr" before matching:
26322632
2633- I . The equivalent of "getattr(cls, "__match_args__", ())" is
2634- called.
2633+ 1 . The equivalent of "getattr(cls, "__match_args__", ())" is
2634+ called.
26352635
26362636 * If this raises an exception, the exception bubbles up.
26372637
@@ -2652,9 +2652,9 @@ class attributes; they are shared by instances. Instance attributes
26522652
26532653 Customizing positional arguments in class pattern matching
26542654
2655- II . Once all positional patterns have been converted to keyword
2656- patterns,
2657- the match proceeds as if there were only keyword patterns.
2655+ 2 . Once all positional patterns have been converted to keyword
2656+ patterns, the match proceeds as if there were only keyword
2657+ patterns.
26582658
26592659 For the following built-in types the handling of positional
26602660 subpatterns is different:
@@ -3818,6 +3818,10 @@ def double(x):
38183818available for commands and command arguments, e.g. the current global
38193819and local names are offered as arguments of the "p" command.
38203820
3821+
3822+ Command-line interface
3823+ ======================
3824+
38213825You can also invoke "pdb" from the command line to debug other
38223826scripts. For example:
38233827
@@ -3833,7 +3837,7 @@ def double(x):
38333837-c, --command <command>
38343838
38353839 To execute commands as if given in a ".pdbrc" file; see Debugger
3836- Commands .
3840+ commands .
38373841
38383842 Changed in version 3.2: Added the "-c" option.
38393843
@@ -3976,7 +3980,7 @@ class pdb.Pdb(completekey='tab', stdin=None, stdout=None, skip=None, nosigint=Fa
39763980 See the documentation for the functions explained above.
39773981
39783982
3979- Debugger Commands
3983+ Debugger commands
39803984=================
39813985
39823986The commands recognized by the debugger are listed below. Most
@@ -6781,9 +6785,8 @@ class that has an "__add__()" method, "type(x).__add__(x, y)" is
67816785*************************
67826786
67836787*Objects* are Python’s abstraction for data. All data in a Python
6784- program is represented by objects or by relations between objects. (In
6785- a sense, and in conformance to Von Neumann’s model of a “stored
6786- program computer”, code is also represented by objects.)
6788+ program is represented by objects or by relations between objects.
6789+ Even code is represented by objects.
67876790
67886791Every object has an identity, a type and a value. An object’s
67896792*identity* never changes once it has been created; you may think of it
@@ -7170,21 +7173,24 @@ class C: pass # a class with no methods (yet)
71707173The "collections.abc" module provides a "MutableMapping" *abstract
71717174base class* to help create those methods from a base set of
71727175"__getitem__()", "__setitem__()", "__delitem__()", and "keys()".
7173- Mutable sequences should provide methods "append()", "count()",
7174- "index()", "extend()", "insert()", "pop()", "remove()", "reverse()"
7175- and "sort()", like Python standard "list" objects. Finally, sequence
7176+
7177+ Mutable sequences should provide methods "append()", "clear()",
7178+ "count()", "extend()", "index()", "insert()", "pop()", "remove()", and
7179+ "reverse()", like Python standard "list" objects. Finally, sequence
71767180types should implement addition (meaning concatenation) and
71777181multiplication (meaning repetition) by defining the methods
71787182"__add__()", "__radd__()", "__iadd__()", "__mul__()", "__rmul__()" and
71797183"__imul__()" described below; they should not define other numerical
7180- operators. It is recommended that both mappings and sequences
7181- implement the "__contains__()" method to allow efficient use of the
7182- "in" operator; for mappings, "in" should search the mapping’s keys;
7183- for sequences, it should search through the values. It is further
7184- recommended that both mappings and sequences implement the
7185- "__iter__()" method to allow efficient iteration through the
7186- container; for mappings, "__iter__()" should iterate through the
7187- object’s keys; for sequences, it should iterate through the values.
7184+ operators.
7185+
7186+ It is recommended that both mappings and sequences implement the
7187+ "__contains__()" method to allow efficient use of the "in" operator;
7188+ for mappings, "in" should search the mapping’s keys; for sequences, it
7189+ should search through the values. It is further recommended that both
7190+ mappings and sequences implement the "__iter__()" method to allow
7191+ efficient iteration through the container; for mappings, "__iter__()"
7192+ should iterate through the object’s keys; for sequences, it should
7193+ iterate through the values.
71887194
71897195object.__len__(self)
71907196
@@ -8532,21 +8538,24 @@ class of a class is known as that class’s *metaclass*, and most
85328538The "collections.abc" module provides a "MutableMapping" *abstract
85338539base class* to help create those methods from a base set of
85348540"__getitem__()", "__setitem__()", "__delitem__()", and "keys()".
8535- Mutable sequences should provide methods "append()", "count()",
8536- "index()", "extend()", "insert()", "pop()", "remove()", "reverse()"
8537- and "sort()", like Python standard "list" objects. Finally, sequence
8541+
8542+ Mutable sequences should provide methods "append()", "clear()",
8543+ "count()", "extend()", "index()", "insert()", "pop()", "remove()", and
8544+ "reverse()", like Python standard "list" objects. Finally, sequence
85388545types should implement addition (meaning concatenation) and
85398546multiplication (meaning repetition) by defining the methods
85408547"__add__()", "__radd__()", "__iadd__()", "__mul__()", "__rmul__()" and
85418548"__imul__()" described below; they should not define other numerical
8542- operators. It is recommended that both mappings and sequences
8543- implement the "__contains__()" method to allow efficient use of the
8544- "in" operator; for mappings, "in" should search the mapping’s keys;
8545- for sequences, it should search through the values. It is further
8546- recommended that both mappings and sequences implement the
8547- "__iter__()" method to allow efficient iteration through the
8548- container; for mappings, "__iter__()" should iterate through the
8549- object’s keys; for sequences, it should iterate through the values.
8549+ operators.
8550+
8551+ It is recommended that both mappings and sequences implement the
8552+ "__contains__()" method to allow efficient use of the "in" operator;
8553+ for mappings, "in" should search the mapping’s keys; for sequences, it
8554+ should search through the values. It is further recommended that both
8555+ mappings and sequences implement the "__iter__()" method to allow
8556+ efficient iteration through the container; for mappings, "__iter__()"
8557+ should iterate through the object’s keys; for sequences, it should
8558+ iterate through the values.
85508559
85518560object.__len__(self)
85528561
@@ -9188,10 +9197,14 @@ class is used in a class pattern with positional arguments, each
91889197 the numeric index of a positional argument, or the name of a
91899198 keyword argument. Returns a copy of the string where each
91909199 replacement field is replaced with the string value of the
9191- corresponding argument.
9200+ corresponding argument. For example:
91929201
9193- >>> "The sum of 1 + 2 is {0}".format(1+2)
9194- 'The sum of 1 + 2 is 3'
9202+ >>> "The sum of 1 + 2 is {0}".format(1+2)
9203+ 'The sum of 1 + 2 is 3'
9204+ >>> "The sum of {a} + {b} is {answer}".format(answer=1+2, a=1, b=2)
9205+ 'The sum of 1 + 2 is 3'
9206+ >>> "{1} expects the {0} Inquisition!".format("Spanish", "Nobody")
9207+ 'Nobody expects the Spanish Inquisition!'
91959208
91969209 See Format String Syntax for a description of the various
91979210 formatting options that can be specified in format strings.
@@ -9246,13 +9259,28 @@ class is used in a class pattern with positional arguments, each
92469259 database as “Letter”, i.e., those with general category property
92479260 being one of “Lm”, “Lt”, “Lu”, “Ll”, or “Lo”. Note that this is
92489261 different from the Alphabetic property defined in the section 4.10
9249- ‘Letters, Alphabetic, and Ideographic’ of the Unicode Standard.
9262+ ‘Letters, Alphabetic, and Ideographic’ of the Unicode Standard. For
9263+ example:
9264+
9265+ >>> 'Letters and spaces'.isalpha()
9266+ False
9267+ >>> 'LettersOnly'.isalpha()
9268+ True
9269+ >>> 'µ'.isalpha() # non-ASCII characters can be considered alphabetical too
9270+ True
9271+
9272+ See Unicode Properties.
92509273
92519274str.isascii()
92529275
92539276 Return "True" if the string is empty or all characters in the
92549277 string are ASCII, "False" otherwise. ASCII characters have code
9255- points in the range U+0000-U+007F.
9278+ points in the range U+0000-U+007F. For example:
9279+
9280+ >>> 'ASCII characters'.isascii()
9281+ True
9282+ >>> 'µ'.isascii()
9283+ False
92569284
92579285 Added in version 3.7.
92589286
@@ -9261,8 +9289,16 @@ class is used in a class pattern with positional arguments, each
92619289 Return "True" if all characters in the string are decimal
92629290 characters and there is at least one character, "False" otherwise.
92639291 Decimal characters are those that can be used to form numbers in
9264- base 10, e.g. U+0660, ARABIC-INDIC DIGIT ZERO. Formally a decimal
9265- character is a character in the Unicode General Category “Nd”.
9292+ base 10, such as U+0660, ARABIC-INDIC DIGIT ZERO. Formally a
9293+ decimal character is a character in the Unicode General Category
9294+ “Nd”. For example:
9295+
9296+ >>> '0123456789'.isdecimal()
9297+ True
9298+ >>> '٠١٢٣٤٥٦٧٨٩'.isdecimal() # Arabic-Indic digits zero to nine
9299+ True
9300+ >>> 'alphabetic'.isdecimal()
9301+ False
92669302
92679303str.isdigit()
92689304
@@ -9340,6 +9376,17 @@ class is used in a class pattern with positional arguments, each
93409376 follow uncased characters and lowercase characters only cased ones.
93419377 Return "False" otherwise.
93429378
9379+ For example:
9380+
9381+ >>> 'Spam, Spam, Spam'.istitle()
9382+ True
9383+ >>> 'spam, spam, spam'.istitle()
9384+ False
9385+ >>> 'SPAM, SPAM, SPAM'.istitle()
9386+ False
9387+
9388+ See also "title()".
9389+
93439390str.isupper()
93449391
93459392 Return "True" if all cased characters [4] in the string are
@@ -9360,7 +9407,15 @@ class is used in a class pattern with positional arguments, each
93609407 Return a string which is the concatenation of the strings in
93619408 *iterable*. A "TypeError" will be raised if there are any non-
93629409 string values in *iterable*, including "bytes" objects. The
9363- separator between elements is the string providing this method.
9410+ separator between elements is the string providing this method. For
9411+ example:
9412+
9413+ >>> ', '.join(['spam', 'spam', 'spam'])
9414+ 'spam, spam, spam'
9415+ >>> '-'.join('Python')
9416+ 'P-y-t-h-o-n'
9417+
9418+ See also "split()".
93649419
93659420str.ljust(width, fillchar=' ', /)
93669421
@@ -9570,6 +9625,8 @@ class is used in a class pattern with positional arguments, each
95709625 >>> " foo ".split(maxsplit=0)
95719626 ['foo ']
95729627
9628+ See also "join()".
9629+
95739630str.splitlines(keepends=False)
95749631
95759632 Return a list of the lines in the string, breaking at line
@@ -9702,6 +9759,8 @@ class is used in a class pattern with positional arguments, each
97029759 >>> titlecase("they're bill's friends.")
97039760 "They're Bill's Friends."
97049761
9762+ See also "istitle()".
9763+
97059764str.translate(table, /)
97069765
97079766 Return a copy of the string in which each character has been mapped
@@ -11049,6 +11108,11 @@ class method object, it is transformed into an instance method object
1104911108| | "X.__bases__" will be exactly equal to "(A, B, |
1105011109| | C)". |
1105111110+----------------------------------------------------+----------------------------------------------------+
11111+ | type.__base__ | **CPython implementation detail:** The single base |
11112+ | | class in the inheritance chain that is responsible |
11113+ | | for the memory layout of instances. This attribute |
11114+ | | corresponds to "tp_base" at the C level. |
11115+ +----------------------------------------------------+----------------------------------------------------+
1105211116| type.__doc__ | The class’s documentation string, or "None" if |
1105311117| | undefined. Not inherited by subclasses. |
1105411118+----------------------------------------------------+----------------------------------------------------+
@@ -11691,8 +11755,8 @@ class dict(iterable, /, **kwargs)
1169111755 1
1169211756
1169311757 The example above shows part of the implementation of
11694- "collections.Counter". A different "__missing__" method is used
11695- by "collections.defaultdict".
11758+ "collections.Counter". A different "__missing__() " method is
11759+ used by "collections.defaultdict".
1169611760
1169711761 d[key] = value
1169811762
0 commit comments