Skip to content

Commit c035635

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ b05a215 🚀
1 parent 63b2673 commit c035635

File tree

536 files changed

+3811
-3048
lines changed

Some content is hidden

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

536 files changed

+3811
-3048
lines changed

‎.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 80a4e93a9aced2568bd60f20dc871af6
3+
config: a68d8f173f8c6fb415ffea49c531dde2
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

‎_sources/library/atexit.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@
44
.. module:: atexit
55
:synopsis: Register and execute cleanup functions.
66

7-
.. moduleauthor:: Skip Montanaro <skip@pobox.com>
8-
.. sectionauthor:: Skip Montanaro <skip@pobox.com>
7+
.. moduleauthor:: Skip Montanaro <skip.montanaro@gmail.com>
8+
.. sectionauthor:: Skip Montanaro <skip.montanaro@gmail.com>
99

1010
--------------
1111

‎_sources/library/csv.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
.. module:: csv
55
:synopsis: Write and read tabular data to and from delimited files.
66

7-
.. sectionauthor:: Skip Montanaro <skip@pobox.com>
7+
.. sectionauthor:: Skip Montanaro <skip.montanaro@gmail.com>
88

99
**Source code:** :source:`Lib/csv.py`
1010

‎_sources/library/readline.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
:platform: Unix
66
:synopsis: GNU readline support for Python.
77

8-
.. sectionauthor:: Skip Montanaro <skip@pobox.com>
8+
.. sectionauthor:: Skip Montanaro <skip.montanaro@gmail.com>
99

1010
--------------
1111

‎_sources/library/urllib.robotparser.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
:synopsis: Load a robots.txt file and answer questions about
66
fetchability of other URLs.
77

8-
.. sectionauthor:: Skip Montanaro <skip@pobox.com>
8+
.. sectionauthor:: Skip Montanaro <skip.montanaro@gmail.com>
99

1010
**Source code:** :source:`Lib/urllib/robotparser.py`
1111

‎_sources/reference/import.rst.txt

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -327,14 +327,15 @@ modules, and one that knows how to import modules from an :term:`import path`
327327
finders replaced :meth:`!find_module`, which
328328
is now deprecated. While it will continue to work without change, the
329329
import machinery will try it only if the finder does not implement
330-
``find_spec()``.
330+
:meth:`~importlib.abc.MetaPathFinder.find_spec`.
331331

332332
.. versionchanged:: 3.10
333333
Use of :meth:`!find_module` by the import system
334334
now raises :exc:`ImportWarning`.
335335

336336
.. versionchanged:: 3.12
337-
``find_module()`` has been removed. Use :meth:`find_spec` instead.
337+
:meth:`!find_module` has been removed.
338+
Use :meth:`~importlib.abc.MetaPathFinder.find_spec` instead.
338339

339340

340341
Loading
@@ -812,7 +813,7 @@ attributes on package objects are also used. These provide additional ways
812813
that the import machinery can be customized.
813814

814815
:data:`sys.path` contains a list of strings providing search locations for
815-
modules and packages. It is initialized from the :data:`PYTHONPATH`
816+
modules and packages. It is initialized from the :envvar:`PYTHONPATH`
816817
environment variable and various other installation- and
817818
implementation-specific defaults. Entries in :data:`sys.path` can name
818819
directories on the file system, zip files, and potentially other "locations"

‎_sources/whatsnew/2.7.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2130,7 +2130,7 @@ Changes to Python's build process and to the C API include:
21302130
only the filename, function name, and first line number are required.
21312131
This is useful for extension modules that are attempting to
21322132
construct a more useful traceback stack. Previously such
2133-
extensions needed to call :c:func:`PyCode_New`, which had many
2133+
extensions needed to call :c:func:`!PyCode_New`, which had many
21342134
more arguments. (Added by Jeffrey Yasskin.)
21352135

21362136
* New function: :c:func:`PyErr_NewExceptionWithDoc` creates a new

‎_sources/whatsnew/3.11.rst.txt

Lines changed: 66 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -672,7 +672,7 @@ enum
672672

673673
* Changed :meth:`Enum.__format__() <enum.Enum.__format__>` (the default for
674674
:func:`format`, :meth:`str.format` and :term:`f-string`\s) to always produce
675-
the same result as :meth:`Enum.__str__()`: for enums inheriting from
675+
the same result as :meth:`Enum.__str__() <enum.Enum.__str__>`: for enums inheriting from
676676
:class:`~enum.ReprEnum` it will be the member's value; for all other enums
677677
it will be the enum and member name (e.g. ``Color.RED``).
678678

@@ -1604,7 +1604,7 @@ raw, adaptive bytecode containing quickened data.
16041604
New opcodes
16051605
-----------
16061606

1607-
* :opcode:`ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`,
1607+
* :opcode:`!ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`,
16081608
used in generators and co-routines.
16091609

16101610
* :opcode:`COPY_FREE_VARS`,
@@ -1615,7 +1615,7 @@ New opcodes
16151615

16161616
* :opcode:`MAKE_CELL`, to create :ref:`cell-objects`.
16171617

1618-
* :opcode:`CHECK_EG_MATCH` and :opcode:`PREP_RERAISE_STAR`,
1618+
* :opcode:`CHECK_EG_MATCH` and :opcode:`!PREP_RERAISE_STAR`,
16191619
to handle the :ref:`new exception groups and except* <whatsnew311-pep654>`
16201620
added in :pep:`654`.
16211621

@@ -1630,38 +1630,38 @@ New opcodes
16301630
Replaced opcodes
16311631
----------------
16321632

1633-
+------------------------------------+-----------------------------------+-----------------------------------------+
1634-
| Replaced Opcode(s) | New Opcode(s) | Notes |
1635-
+====================================+===================================+=========================================+
1636-
| | :opcode:`!BINARY_*` | :opcode:`BINARY_OP` | Replaced all numeric binary/in-place |
1637-
| | :opcode:`!INPLACE_*` | | opcodes with a single opcode |
1638-
+------------------------------------+-----------------------------------+-----------------------------------------+
1639-
| | :opcode:`!CALL_FUNCTION` | | :opcode:`CALL` | Decouples argument shifting for methods |
1640-
| | :opcode:`!CALL_FUNCTION_KW` | | :opcode:`KW_NAMES` | from handling of keyword arguments; |
1641-
| | :opcode:`!CALL_METHOD` | | :opcode:`PRECALL` | allows better specialization of calls |
1642-
| | | :opcode:`PUSH_NULL` | |
1643-
+------------------------------------+-----------------------------------+-----------------------------------------+
1644-
| | :opcode:`!DUP_TOP` | | :opcode:`COPY` | Stack manipulation instructions |
1645-
| | :opcode:`!DUP_TOP_TWO` | | :opcode:`SWAP` | |
1646-
| | :opcode:`!ROT_TWO` | | |
1647-
| | :opcode:`!ROT_THREE` | | |
1648-
| | :opcode:`!ROT_FOUR` | | |
1649-
| | :opcode:`!ROT_N` | | |
1650-
+------------------------------------+-----------------------------------+-----------------------------------------+
1651-
| | :opcode:`!JUMP_IF_NOT_EXC_MATCH` | | :opcode:`CHECK_EXC_MATCH` | Now performs check but doesn't jump |
1652-
+------------------------------------+-----------------------------------+-----------------------------------------+
1653-
| | :opcode:`!JUMP_ABSOLUTE` | | :opcode:`JUMP_BACKWARD` | See [#bytecode-jump]_; |
1654-
| | :opcode:`!POP_JUMP_IF_FALSE` | | :opcode:`POP_JUMP_BACKWARD_IF_* | ``TRUE``, ``FALSE``, |
1655-
| | :opcode:`!POP_JUMP_IF_TRUE` | <POP_JUMP_BACKWARD_IF_TRUE>` | ``NONE`` and ``NOT_NONE`` variants |
1656-
| | | :opcode:`POP_JUMP_FORWARD_IF_* | for each direction |
1657-
| | <POP_JUMP_FORWARD_IF_TRUE>` | |
1658-
+------------------------------------+-----------------------------------+-----------------------------------------+
1659-
| | :opcode:`!SETUP_WITH` | :opcode:`BEFORE_WITH` | :keyword:`with` block setup |
1660-
| | :opcode:`!SETUP_ASYNC_WITH` | | |
1661-
+------------------------------------+-----------------------------------+-----------------------------------------+
1633+
+------------------------------------+------------------------------------+-----------------------------------------+
1634+
| Replaced Opcode(s) | New Opcode(s) | Notes |
1635+
+====================================+====================================+=========================================+
1636+
| | :opcode:`!BINARY_*` | :opcode:`BINARY_OP` | Replaced all numeric binary/in-place |
1637+
| | :opcode:`!INPLACE_*` | | opcodes with a single opcode |
1638+
+------------------------------------+------------------------------------+-----------------------------------------+
1639+
| | :opcode:`!CALL_FUNCTION` | | :opcode:`CALL` | Decouples argument shifting for methods |
1640+
| | :opcode:`!CALL_FUNCTION_KW` | | :opcode:`!KW_NAMES` | from handling of keyword arguments; |
1641+
| | :opcode:`!CALL_METHOD` | | :opcode:`!PRECALL` | allows better specialization of calls |
1642+
| | | :opcode:`PUSH_NULL` | |
1643+
+------------------------------------+------------------------------------+-----------------------------------------+
1644+
| | :opcode:`!DUP_TOP` | | :opcode:`COPY` | Stack manipulation instructions |
1645+
| | :opcode:`!DUP_TOP_TWO` | | :opcode:`SWAP` | |
1646+
| | :opcode:`!ROT_TWO` | | |
1647+
| | :opcode:`!ROT_THREE` | | |
1648+
| | :opcode:`!ROT_FOUR` | | |
1649+
| | :opcode:`!ROT_N` | | |
1650+
+------------------------------------+------------------------------------+-----------------------------------------+
1651+
| | :opcode:`!JUMP_IF_NOT_EXC_MATCH` | | :opcode:`CHECK_EXC_MATCH` | Now performs check but doesn't jump |
1652+
+------------------------------------+------------------------------------+-----------------------------------------+
1653+
| | :opcode:`!JUMP_ABSOLUTE` | | :opcode:`JUMP_BACKWARD` | See [#bytecode-jump]_; |
1654+
| | :opcode:`!POP_JUMP_IF_FALSE` | | :opcode:`!POP_JUMP_BACKWARD_IF_*`| ``TRUE``, ``FALSE``, |
1655+
| | :opcode:`!POP_JUMP_IF_TRUE` | | :opcode:`!POP_JUMP_FORWARD_IF_*` | ``NONE`` and ``NOT_NONE`` variants |
1656+
| | | for each direction |
1657+
| | | |
1658+
+------------------------------------+------------------------------------+-----------------------------------------+
1659+
| | :opcode:`!SETUP_WITH` | :opcode:`BEFORE_WITH` | :keyword:`with` block setup |
1660+
| | :opcode:`!SETUP_ASYNC_WITH` | | |
1661+
+------------------------------------+------------------------------------+-----------------------------------------+
16621662

16631663
.. [#bytecode-jump] All jump opcodes are now relative, including the
1664-
existing :opcode:`JUMP_IF_TRUE_OR_POP` and :opcode:`JUMP_IF_FALSE_OR_POP`.
1664+
existing :opcode:`!JUMP_IF_TRUE_OR_POP` and :opcode:`!JUMP_IF_FALSE_OR_POP`.
16651665
The argument is now an offset from the current instruction
16661666
rather than an absolute location.
16671667
@@ -1967,7 +1967,7 @@ Removed C APIs are :ref:`listed separately <whatsnew311-c-api-removed>`.
19671967

19681968
(Contributed by Victor Stinner in :issue:`45085`.)
19691969

1970-
* Removed the :mod:`distutils` ``bdist_msi`` command deprecated in Python 3.9.
1970+
* Removed the :mod:`!distutils` ``bdist_msi`` command deprecated in Python 3.9.
19711971
Use ``bdist_wheel`` (wheel packages) instead.
19721972
(Contributed by Hugo van Kemenade in :issue:`45124`.)
19731973

@@ -2295,7 +2295,7 @@ Porting to Python 3.11
22952295
as its second parameter, instead of ``PyFrameObject*``.
22962296
See :pep:`523` for more details of how to use this function pointer type.
22972297

2298-
* :c:func:`PyCode_New` and :c:func:`PyCode_NewWithPosOnlyArgs` now take
2298+
* :c:func:`!PyCode_New` and :c:func:`!PyCode_NewWithPosOnlyArgs` now take
22992299
an additional ``exception_table`` argument.
23002300
Using these functions should be avoided, if at all possible.
23012301
To get a custom code object: create a code object using the compiler,
@@ -2402,7 +2402,7 @@ Porting to Python 3.11
24022402
been included directly, consider including ``Python.h`` instead.
24032403
(Contributed by Victor Stinner in :issue:`35134`.)
24042404

2405-
* The :c:func:`PyUnicode_CHECK_INTERNED` macro has been excluded from the
2405+
* The :c:func:`!PyUnicode_CHECK_INTERNED` macro has been excluded from the
24062406
limited C API. It was never usable there, because it used internal structures
24072407
which are not available in the limited C API.
24082408
(Contributed by Victor Stinner in :issue:`46007`.)
@@ -2465,7 +2465,7 @@ Porting to Python 3.11
24652465

24662466
Debuggers that accessed the :attr:`~frame.f_locals` directly *must* call
24672467
:c:func:`PyFrame_GetLocals` instead. They no longer need to call
2468-
:c:func:`PyFrame_FastToLocalsWithError` or :c:func:`PyFrame_LocalsToFast`,
2468+
:c:func:`!PyFrame_FastToLocalsWithError` or :c:func:`!PyFrame_LocalsToFast`,
24692469
in fact they should not call those functions. The necessary updating of the
24702470
frame is now managed by the virtual machine.
24712471

@@ -2604,8 +2604,8 @@ and will be removed in Python 3.12.
26042604
* :c:func:`!PyUnicode_GET_DATA_SIZE`
26052605
* :c:func:`!PyUnicode_GET_SIZE`
26062606
* :c:func:`!PyUnicode_GetSize`
2607-
* :c:func:`PyUnicode_IS_COMPACT`
2608-
* :c:func:`PyUnicode_IS_READY`
2607+
* :c:func:`!PyUnicode_IS_COMPACT`
2608+
* :c:func:`!PyUnicode_IS_READY`
26092609
* :c:func:`PyUnicode_READY`
26102610
* :c:func:`!PyUnicode_WSTR_LENGTH`
26112611
* :c:func:`!_PyUnicode_AsUnicode`
@@ -2660,7 +2660,7 @@ Removed
26602660
(Contributed by Victor Stinner in :issue:`45474`.)
26612661

26622662
* Exclude :c:func:`PyWeakref_GET_OBJECT` from the limited C API. It never
2663-
worked since the :c:type:`PyWeakReference` structure is opaque in the
2663+
worked since the :c:type:`!PyWeakReference` structure is opaque in the
26642664
limited C API.
26652665
(Contributed by Victor Stinner in :issue:`35134`.)
26662666

@@ -2701,4 +2701,30 @@ Removed
27012701
(Contributed by Inada Naoki in :issue:`44029`.)
27022702

27032703

2704+
Notable changes in 3.11.4
2705+
=========================
2706+
2707+
tarfile
2708+
-------
2709+
2710+
* The extraction methods in :mod:`tarfile`, and :func:`shutil.unpack_archive`,
2711+
have a new a *filter* argument that allows limiting tar features than may be
2712+
surprising or dangerous, such as creating files outside the destination
2713+
directory.
2714+
See :ref:`tarfile-extraction-filter` for details.
2715+
In Python 3.12, use without the *filter* argument will show a
2716+
:exc:`DeprecationWarning`.
2717+
In Python 3.14, the default will switch to ``'data'``.
2718+
(Contributed by Petr Viktorin in :pep:`706`.)
2719+
2720+
2721+
Notable changes in 3.11.5
2722+
=========================
2723+
2724+
OpenSSL
2725+
-------
2726+
2727+
* Windows builds and macOS installers from python.org now use OpenSSL 3.0.
2728+
2729+
27042730
.. _libb2: https://www.blake2.net/

‎_sources/whatsnew/3.8.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1623,8 +1623,8 @@ Build and C API Changes
16231623
allocation or deallocation may need to be adjusted.
16241624
(Contributed by Eddie Elizondo in :issue:`35810`.)
16251625

1626-
* The new function :c:func:`PyCode_NewWithPosOnlyArgs` allows to create
1627-
code objects like :c:func:`PyCode_New`, but with an extra *posonlyargcount*
1626+
* The new function :c:func:`!PyCode_NewWithPosOnlyArgs` allows to create
1627+
code objects like :c:func:`!PyCode_New`, but with an extra *posonlyargcount*
16281628
parameter for indicating the number of positional-only arguments.
16291629
(Contributed by Pablo Galindo in :issue:`37221`.)
16301630

‎_static/menu.js

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,4 +54,4 @@ document.addEventListener("DOMContentLoaded", function () {
5454
closeMenu()
5555
}
5656
})
57-
})
57+
})

0 commit comments

Comments
 (0)