8000 Merge remote-tracking branch 'upstream/main' into stackref_all · python/cpython@1d71dd1 · GitHub
[go: up one dir, main page]
Skip to content

Commit 1d71dd1

Browse files
Fidget-SpinnerFidget-Spinner
committed
Merge remote-tracking branch 'upstream/main' into stackref_all
2 parents bc96ae6
8000
 + cb6f75a commit 1d71dd1

File tree

423 files changed

+2661
-1102
lines changed
  • pty.rst
  • pwd.rst
  • py_compile.rst
  • pyclbr.rst
  • pydoc.rst
  • pyexpat.rst
  • queue.rst
  • quopri.rst
  • random.rst
  • re.rst
  • readline.rst
  • reprlib.rst
  • resource.rst
  • rlcompleter.rst
  • runpy.rst
  • sched.rst
  • secrets.rst
  • select.rst
  • selectors.rst
  • shelve.rst
  • shlex.rst
  • shutil.rst
  • signal.rst
  • site.rst
  • smtplib.rst
  • socket.rst
  • socketserver.rst
  • sqlite3.rst
  • ssl.rst
  • stat.rst
  • statistics.rst
  • string.rst
  • stringprep.rst
  • struct.rst
  • subprocess.rst
  • symtable.rst
  • sys.monitoring.rst
  • sys.rst
  • sysconfig.rst
  • syslog.rst
  • tabnanny.rst
  • tarfile.rst
  • tempfile.rst
  • termios.rst
  • test.rst
  • textwrap.rst
  • threading.rst
  • time.rst
  • timeit.rst
  • tkinter.colorchooser.rst
  • tkinter.dnd.rst
  • tkinter.font.rst
  • tkinter.messagebox.rst
  • tkinter.rst
  • tkinter.scrolledtext.rst
  • tkinter.ttk.rst
  • token.rst
  • tokenize.rst
  • tomllib.rst
  • trace.rst
  • traceback.rst
  • tracemalloc.rst
  • tty.rst
  • types.rst
  • typing.rst
  • unicodedata.rst
  • unittest.mock-examples.rst
  • unittest.mock.rst
  • unittest.rst
  • urllib.error.rst
  • urllib.parse.rst
  • urllib.request.rst
  • urllib.robotparser.rst
  • urllib.rst
  • uuid.rst
  • venv.rst
  • warnings.rst
  • wave.rst
  • webbrowser.rst
  • winreg.rst
  • winsound.rst
  • wsgiref.rst
  • xml.dom.minidom.rst
  • xml.dom.pulldom.rst
  • xml.dom.rst
  • xml.etree.elementtree.rst
  • xml.sax.handler.rst
  • xml.sax.reader.rst
  • xml.sax.rst
  • xml.sax.utils.rst
  • xmlrpc.client.rst
  • xmlrpc.server.rst
  • zipapp.rst
  • zipfile.rst
  • zipimport.rst
  • zlib.rst
  • zoneinfo.rst
  • reference
  • tools/extensions
  • tutorial
  • whatsnew
  • Include
  • Lib
  • Misc/NEWS.d

    • Some content is hidden

    Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

    423 files changed

    +2661
    -1102
    lines changed

    ‎.github/workflows/build.yml

    Lines changed: 2 additions & 10 deletions
    Original file line numberDiff line numberDiff line change
    @@ -8,19 +8,11 @@ on:
    88
    push:
    99
    branches:
    1010
    - 'main'
    11-
    - '3.12'
    12-
    - '3.11'
    13-
    - '3.10'
    14-
    - '3.9'
    15-
    - '3.8'
    11+
    - '3.*'
    1612
    pull_request:
    1713
    branches:
    1814
    - 'main'
    19-
    - '3.12'
    20-
    - '3.11'
    21-
    - '3.10'
    22-
    - '3.9'
    23-
    - '3.8'
    15+
    - '3.*'
    2416

    2517
    permissions:
    2618
    contents: read

    ‎Doc/c-api/object.rst

    Lines changed: 1 addition & 1 deletion
    Original file line numberDiff line numberDiff line change
    @@ -65,7 +65,7 @@ Object Protocol
    6565
    6666
    Properly handle returning :c:data:`Py_NotImplemented` from within a C
    6767
    function (that is, create a new :term:`strong reference`
    68-
    to NotImplemented and return it).
    68+
    to :const:`NotImplemented` and return it).
    6969
    7070
    7171
    .. c:macro:: Py_PRINT_RAW

    ‎Doc/library/__future__.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`__future__` --- Future statement definitions
    2-
    ==================================================
    1+
    :mod:`!__future__` --- Future statement definitions
    2+
    ===================================================
    33

    44
    .. module:: __future__
    55
    :synopsis: Future statement definitions

    ‎Doc/library/__main__.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`__main__` --- Top-level code environment
    2-
    ==============================================
    1+
    :mod:`!__main__` --- Top-level code environment
    2+
    ===============================================
    33

    44
    .. module:: __main__
    55
    :synopsis: The environment where top-level code is run. Covers command-line

    ‎Doc/library/_thread.rst

    Lines changed: 5 additions & 5 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`_thread` --- Low-level threading API
    2-
    ==========================================
    1+
    :mod:`!_thread` --- Low-level threading API
    2+
    ===========================================
    33

    44
    .. module:: _thread
    55
    :synopsis: Low-level threading API.
    @@ -169,14 +169,14 @@ Lock objects have the following methods:
    169169
    time can acquire a lock --- that's their reason for existence).
    170170

    171171
    If the *blocking* argument is present, the action depends on its
    172-
    value: if it is False, the lock is only acquired if it can be acquired
    173-
    immediately without waiting, while if it is True, the lock is acquired
    172+
    value: if it is false, the lock is only acquired if it can be acquired
    173+
    immediately without waiting, while if it is true, the lock is acquired
    174174
    unconditionally as above.
    175175

    176176
    If the floating-point *timeout* argument is present and positive, it
    177177
    specifies the maximum wait time in seconds before returning. A negative
    178178
    *timeout* argument specifies an unbounded wait. You cannot specify
    179-
    a *timeout* if *blocking* is False.
    179+
    a *timeout* if *blocking* is false.
    180180

    181181
    The return value is ``True`` if the lock is acquired successfully,
    182182
    ``False`` if not.

    ‎Doc/library/abc.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`abc` --- Abstract Base Classes
    2-
    ====================================
    1+
    :mod:`!abc` --- Abstract Base Classes
    2+
    =====================================
    33

    44
    .. module:: abc
    55
    :synopsis: Abstract base classes according to :pep:`3119`.

    ‎Doc/library/argparse.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`argparse` --- Parser for command-line options, arguments and sub-commands
    2-
    ===============================================================================
    1+
    :mod:`!argparse` --- Parser for command-line options, arguments and sub-commands
    2+
    ================================================================================
    33

    44
    .. module:: argparse
    55
    :synopsis: Command-line option and argument parsing library.

    ‎Doc/library/array.rst

    Lines changed: 2 additions & 2 deletions
    Original 10000 file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`array` --- Efficient arrays of numeric values
    2-
    ===================================================
    1+
    :mod:`!array` --- Efficient arrays of numeric values
    2+
    ====================================================
    33

    44
    .. module:: array
    55
    :synopsis: Space efficient arrays of uniformly typed numeric values.

    ‎Doc/library/ast.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`ast` --- Abstract Syntax Trees
    2-
    ====================================
    1+
    :mod:`!ast` --- Abstract Syntax Trees
    2+
    =====================================
    33

    44
    .. module:: ast
    55
    :synopsis: Abstract Syntax Tree classes and manipulation.

    ‎Doc/library/asyncio-eventloop.rst

    Lines changed: 1 addition & 1 deletion
    Original file line numberDiff line numberDiff line change
    @@ -796,7 +796,7 @@ Creating network servers
    796796
    :class:`str`, :class:`bytes`, and :class:`~pathlib.Path` paths
    797797
    are supported.
    798798

    799-
    If *cleanup_socket* is True then the Unix socket will automatically
    799+
    If *cleanup_socket* is true then the Unix socket will automatically
    800800
    be removed from the filesystem when the server is closed, unless the
    801801
    socket has been replaced after the server has been created.
    802802

    ‎Doc/library/asyncio-task.rst

    Lines changed: 1 addition & 1 deletion
    Original file line numberDiff line numberDiff line change
    @@ -538,7 +538,7 @@ Running Tasks Concurrently
    538538
    # [2, 6, 24]
    539539

    540540
    .. note::
    541-
    If *return_exceptions* is False, cancelling gather() after it
    541+
    If *return_exceptions* is false, cancelling gather() after it
    542542
    has been marked done won't cancel any submitted awaitables.
    543543
    For instance, gather can be marked done after propagating an
    544544
    exception to the caller, therefore, calling ``gather.cancel()``

    ‎Doc/library/asyncio.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`asyncio` --- Asynchronous I/O
    2-
    ===================================
    1+
    :mod:`!asyncio` --- Asynchronous I/O
    2+
    ====================================
    33

    44
    .. module:: asyncio
    55
    :synopsis: Asynchronous I/O.

    ‎Doc/library/atexit.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`atexit` --- Exit handlers
    2-
    ===============================
    1+
    :mod:`!atexit` --- Exit handlers
    2+
    ================================
    33

    44
    .. module:: atexit
    55
    :synopsis: Register and execute cleanup functions.

    ‎Doc/library/base64.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`base64` --- Base16, Base32, Base64, Base85 Data Encodings
    2-
    ===============================================================
    1+
    :mod:`!base64` --- Base16, Base32, Base64, Base85 Data Encodings
    2+
    ================================================================
    33

    44
    .. module:: base64
    55
    :synopsis: RFC 4648: Base16, Base32, Base64 Data Encodings;

    ‎Doc/library/bdb.rst

    Lines changed: 13 additions & 13 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`bdb` --- Debugger framework
    2-
    =================================
    1+
    :mod:`!bdb` --- Debugger framework
    2+
    ==================================
    33

    44
    .. module:: bdb
    55
    :synopsis: Debugger framework.
    @@ -86,7 +86,7 @@ The :mod:`bdb` module also defines two classes:
    8686

    8787
    .. attribute:: temporary
    8888

    89-
    True if a :class:`Breakpoint` at (file, line) is temporary.
    89+
    ``True`` if a :class:`Breakpoint` at (file, line) is temporary.
    9090

    9191
    .. attribute:: cond
    9292

    @@ -99,7 +99,7 @@ The :mod:`bdb` module also defines two classes:
    9999

    100100
    .. attribute:: enabled
    101101

    102-
    True if :class:`Breakpoint` is enabled.
    102+
    ``True`` if :class:`Breakpoint` is enabled.
    103103

    104104
    .. attribute:: bpbynumber
    105105

    @@ -215,22 +215,22 @@ The :mod:`bdb` module also defines two classes:
    215215

    216216
    .. method:: is_skipped_line(module_name)
    217217

    218-
    Return True if *module_name* matches any skip pattern.
    218+
    Return ``True`` if *module_name* matches any skip pattern.
    219219

    220220
    .. method:: stop_here(frame)
    221221

    222-
    Return True if *frame* is below the starting frame in the stack.
    222+
    Return ``True`` if *frame* is below the starting frame in the stack.
    223223

    224224
    .. method:: break_here(frame)
    225225

    226-
    Return True if there is an effective breakpoint for this line.
    226+
    Return ``True`` if there is an effective breakpoint for this line.
    227227

    228228
    Check whether a line or function breakpoint exists and is in effect. Delete temporary
    229229
    breakpoints based on information from :func:`effective`.
    230230

    231231
    .. method:: break_anywhere(frame)
    232232

    233-
    Return True if any breakpoint exists for *frame*'s filename.
    233+
    Return ``True`` if any breakpoint exists for *frame*'s filename.
    234234

    235235
    Derived classes should override these methods to gain control over debugger
    236236
    operation.
    @@ -348,7 +348,7 @@ The :mod:`bdb` module also defines two classes:
    348348

    349349
    .. method:: get_break(filename, lineno)
    350350

    351-
    Return True if there is a breakpoint for *lineno* in *filename*.
    351+
    Return ``True`` if there is a breakpoint for *lineno* in *filename*.
    352352

    353353
    .. method:: get_breaks(filename, lineno)
    354354

    @@ -412,7 +412,7 @@ Finally, the module defines the following functions:
    412412

    413413
    .. function:: checkfuncname(b, frame)
    414414

    415-
    Return True if we should break here, depending on the way the
    415+
    Return ``True`` if we should break here, depending on the way the
    416416
    :class:`Breakpoint` *b* was set.
    417417

    418418
    If it was set via line number, it checks if
    @@ -431,14 +431,14 @@ Finally, the module defines the following functions:
    431431
    :attr:`bplist <bdb.Breakpoint.bplist>` for the
    432432
    (:attr:`file <bdb.Breakpoint.file>`, :attr:`line <bdb.Breakpoint.line>`)
    433433
    (which must exist) that is :attr:`enabled <bdb.Breakpoint.enabled>`, for
    434-
    which :func:`checkfuncname` is True, and that has neither a False
    434+
    which :func:`checkfuncname` is true, and that has neither a false
    435435
    :attr:`condition <bdb.Breakpoint.cond>` nor positive
    436436
    :attr:`ignore <bdb.Breakpoint.ignore>` count. The *flag*, meaning that a
    437-
    temporary breakpoint should be deleted, is False only when the
    437+
    temporary breakpoint should be deleted, is ``False`` only when the
    438438
    :attr:`cond <bdb.Breakpoint.cond>` cannot be evaluated (in which case,
    439439
    :attr:`ignore <bdb.Breakpoint.ignore>` count is ignored).
    440440

    441-
    If no such entry exists, then (None, None) is returned.
    441+
    If no such entry exists, then ``(None, None)`` is returned.
    442442

    443443

    444444
    .. function:: set_trace()

    ‎Doc/library/binascii.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`binascii` --- Convert between binary and ASCII
    2-
    ====================================================
    1+
    :mod:`!binascii` --- Convert between binary and ASCII
    2+
    =====================================================
    33

    44
    .. module:: binascii
    55
    :synopsis: Tools for converting between binary and various ASCII-encoded binary

    ‎Doc/library/bisect.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`bisect` --- Array bisection algorithm
    2-
    ===========================================
    1+
    :mod:`!bisect` --- Array bisection algorithm
    2+
    ============================================
    33

    44
    .. module:: bisect
    55
    :synopsis: Array bisection algorithms for binary searching.

    ‎Doc/library/builtins.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`builtins` --- Built-in objects
    2-
    ====================================
    1+
    :mod:`!builtins` --- Built-in objects
    2+
    =====================================
    33

    44
    .. module:: builtins
    55
    :synopsis: The module that provides the built-in namespace.

    ‎Doc/library/bz2.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`bz2` --- Support for :program:`bzip2` compression
    2-
    =======================================================
    1+
    :mod:`!bz2` --- Support for :program:`bzip2` compression
    2+
    ========================================================
    33

    44
    .. module:: bz2
    55
    :synopsis: Interfaces for bzip2 compression and decompression.

    ‎Doc/library/calendar.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`calendar` --- General calendar-related functions
    2-
    ======================================================
    1+
    :mod:`!calendar` --- General calendar-related functions
    2+
    =======================================================
    33

    44
    .. module:: calendar
    55
    :synopsis: Functions for working with calendars, including some emulation

    ‎Doc/library/cmath.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`cmath` --- Mathematical functions for complex numbers
    2-
    ===========================================================
    1+
    :mod:`!cmath` --- Mathematical functions for complex numbers
    2+
    ============================================================
    33

    44
    .. module:: cmath
    55
    :synopsis: Mathematical functions for complex numbers.

    ‎Doc/library/cmd.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`cmd` --- Support for line-oriented command interpreters
    2-
    =============================================================
    1+
    :mod:`!cmd` --- Support for line-oriented command interpreters
    2+
    ==============================================================
    33

    44
    .. module:: cmd
    55
    :synopsis: Build line-oriented command interpreters.

    ‎Doc/library/code.rst

    Lines changed: 3 additions & 3 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`code` --- Interpreter base classes
    2-
    ========================================
    1+
    :mod:`!code` --- Interpreter base classes
    2+
    =========================================
    33

    44
    .. module:: code
    55
    :synopsis: Facilities to implement read-eval-print loops.
    @@ -27,7 +27,7 @@ build applications which provide an interactive interpreter prompt.
    2727

    2828
    Closely emulate the behavior of the interactive Python interpreter. This class
    2929
    builds on :class:`InteractiveInterpreter` and adds prompting using the familiar
    30-
    ``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* is True,
    30+
    ``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* is true,
    3131
    ``exit()`` and ``quit()`` in the console will not raise :exc:`SystemExit`, but
    3232
    instead return to the calling code.
    3333

    ‎Doc/library/codecs.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`codecs` --- Codec registry and base classes
    2-
    =================================================
    1+
    :mod:`!codecs` --- Codec registry and base classes
    2+
    ==================================================
    33

    44
    .. module:: codecs
    55
    :synopsis: Encode and decode data and streams.

    ‎Doc/library/codeop.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`codeop` --- Compile Python code
    2-
    =====================================
    1+
    :mod:`!codeop` --- Compile Python code
    2+
    ======================================
    33

    44
    .. module:: codeop
    55
    :synopsis: Compile (possibly incomplete) Python code.

    ‎Doc/library/collections.abc.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`collections.abc` --- Abstract Base Classes for Containers
    2-
    ===============================================================
    1+
    :mod:`!collections.abc` --- Abstract Base Classes for Containers
    2+
    ================================================================
    33

    44
    .. module:: collections.abc
    55
    :synopsis: Abstract base classes for containers

    ‎Doc/library/collections.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`collections` --- Container datatypes
    2-
    ==========================================
    1+
    :mod:`!collections` --- Container datatypes
    2+
    ===========================================
    33

    44
    .. module:: collections
    55
    :synopsis: Container datatypes

    ‎Doc/library/colorsys.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`colorsys` --- Conversions between color systems
    2-
    =====================================================
    1+
    :mod:`!colorsys` --- Conversions between color systems
    2+
    ======================================================
    33

    44
    .. module:: colorsys
    55
    :synopsis: Conversion functions between RGB and other color systems.

    ‎Doc/library/compileall.rst

    Lines changed: 5 additions & 5 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`compileall` --- Byte-compile Python libraries
    2-
    ===================================================
    1+
    :mod:`!compileall` --- Byte-compile Python libraries
    2+
    ====================================================
    33

    44
    .. module:: compileall
    55
    :synopsis: Tools for byte-compiling all Python source files in a directory tree.
    @@ -226,7 +226,7 @@ Public functions
    226226
    The *invalidation_mode* parameter was added.
    227227

    228228
    .. versionchanged:: 3.7.2
    229-
    The *invalidation_mode* parameter's default value is updated to None.
    229+
    The *invalidation_mode* parameter's default value is updated to ``None``.
    230230

    231231
    .. versionchanged:: 3.8
    232232
    Setting *workers* to 0 now chooses the optimal number of cores.
    @@ -289,7 +289,7 @@ Public functions
    289289
    The *invalidation_mode* parameter was added.
    290290

    291291
    .. versionchanged:: 3.7.2
    292-
    The *invalidation_mode* parameter's default value is updated to None.
    292+
    The *invalidation_mode* parameter's default value is updated to ``None``.
    293293

    294294
    .. versionchanged:: 3.9
    295295
    Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* arguments.
    @@ -318,7 +318,7 @@ Public functions
    318318
    The *invalidation_mode* parameter was added.
    319319

    320320
    .. versionchanged:: 3.7.2
    321-
    The *invalidation_mode* parameter's default value is updated to None.
    321+
    The *invalidation_mode* parameter's default value is updated to ``None``.
    322322

    323323
    To force a recompile of all the :file:`.py` files in the :file:`Lib/`
    324324
    subdirectory and all its subdirectories::

    ‎Doc/library/concurrent.futures.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`concurrent.futures` --- Launching parallel tasks
    2-
    ======================================================
    1+
    :mod:`!concurrent.futures` --- Launching parallel tasks
    2+
    =======================================================
    33

    44
    .. module:: concurrent.futures
    55
    :synopsis: Execute computations concurrently using threads or processes.

    ‎Doc/library/configparser.rst

    Lines changed: 2 additions & 2 deletions
    Original file line numberDiff line numberDiff line change
    @@ -1,5 +1,5 @@
    1-
    :mod:`configparser` --- Configuration file parser
    2-
    =================================================
    1+
    :mod:`!configparser` --- Configuration file parser
    2+
    ==================================================
    33

    44
    .. module:: configparser
    55
    :synopsis: Configuration file parser.

    0 commit comments

    Comments
     (0)
    0