Skip to content

Commit ca9fdd9

Browse files
committed
Deploying to gh-pages from @ 76ab204 🚀
1 parent ef8cf92 commit ca9fdd9

File tree

564 files changed

+1605
-1628
lines changed

Some content is hidden

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

564 files changed

+1605
-1628
lines changed

.buildinfo

+1-1
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: 0c4186e2a1145bd5ce018bf076bcde5c
3+
config: a106bc1aa0adf41da663be30441342a4
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

_sources/c-api/code.rst.txt

+2-2
Original file line numberDiff line numberDiff line change
@@ -90,8 +90,8 @@ bound into a function.
9090
Return the line number of the instruction that occurs on or before ``byte_offset`` and ends after it.
9191
If you just need the line number of a frame, use :c:func:`PyFrame_GetLineNumber` instead.
9292
93-
For efficiently iterating over the line numbers in a code object, use `the API described in PEP 626
94-
<https://peps.python.org/pep-0626/#out-of-process-debuggers-and-profilers>`_.
93+
For efficiently iterating over the line numbers in a code object, use :pep:`the API described in PEP 626
94+
<0626#out-of-process-debuggers-and-profilers>`.
9595
9696
.. c:function:: int PyCode_Addr2Location(PyObject *co, int byte_offset, int *start_line, int *start_column, int *end_line, int *end_column)
9797

_sources/c-api/refcounting.rst.txt

+2-2
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ of Python objects.
5959
``NULL``, use :c:func:`Py_XINCREF`.
6060
6161
Do not expect this function to actually modify *o* in any way.
62-
For at least `some objects <https://peps.python.org/pep-0683/>`_,
62+
For at least :pep:`some objects <0683>`,
6363
this function has no effect.
6464
6565
.. versionchanged:: 3.12
@@ -125,7 +125,7 @@ of Python objects.
125125
use :c:func:`Py_XDECREF`.
126126
127127
Do not expect this function to actually modify *o* in any way.
128-
For at least `some objects <https://peps.python.org/pep-0683/>`_,
128+
For at least :pep:`some objects <683>`,
129129
this function has no effect.
130130
131131
.. warning::

_sources/faq/design.rst.txt

+2-2
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,7 @@ Can Python be compiled to machine code, C or some other language?
328328
-----------------------------------------------------------------
329329

330330
`Cython <https://cython.org/>`_ compiles a modified version of Python with
331-
optional annotations into C extensions. `Nuitka <https://www.nuitka.net/>`_ is
331+
optional annotations into C extensions. `Nuitka <https://nuitka.net/>`_ is
332332
an up-and-coming compiler of Python into C++ code, aiming to support the full
333333
Python language.
334334

@@ -345,7 +345,7 @@ to perform a garbage collection, obtain debugging statistics, and tune the
345345
collector's parameters.
346346

347347
Other implementations (such as `Jython <https://www.jython.org>`_ or
348-
`PyPy <https://www.pypy.org>`_), however, can rely on a different mechanism
348+
`PyPy <https://pypy.org>`_), however, can rely on a different mechanism
349349
such as a full-blown garbage collector. This difference can cause some
350350
subtle porting problems if your Python code depends on the behavior of the
351351
reference counting implementation.

_sources/faq/general.rst.txt

+2-2
Original file line numberDiff line numberDiff line change
@@ -311,8 +311,8 @@ releases.
311311
The latest stable releases can always be found on the `Python download page
312312
<https://www.python.org/downloads/>`_. There are two production-ready versions
313313
of Python: 2.x and 3.x. The recommended version is 3.x, which is supported by
314-
most widely used libraries. Although 2.x is still widely used, `it is not
315-
maintained anymore <https://peps.python.org/pep-0373/>`_.
314+
most widely used libraries. Although 2.x is still widely used, :pep:`it is not
315+
maintained anymore <0373>`.
316316

317317
How many people are using Python?
318318
---------------------------------

_sources/library/ast.rst.txt

+1-2
Original file line numberDiff line numberDiff line change
@@ -2060,8 +2060,7 @@ Function and class definitions
20602060
* ``name`` is a raw string for the class name
20612061
* ``bases`` is a list of nodes for explicitly specified base classes.
20622062
* ``keywords`` is a list of :class:`.keyword` nodes, principally for 'metaclass'.
2063-
Other keywords will be passed to the metaclass, as per `PEP-3115
2064-
<https://peps.python.org/pep-3115/>`_.
2063+
Other keywords will be passed to the metaclass, as per :pep:`3115`.
20652064
* ``body`` is a list of nodes representing the code within the class
20662065
definition.
20672066
* ``decorator_list`` is a list of nodes, as in :class:`FunctionDef`.

_sources/library/ctypes.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ function call fails.
5151

5252

5353
Here are some examples for Windows. Note that ``msvcrt`` is the MS standard C
54-
library containing most standard C functions, and uses the cdecl calling
54+
library containing most standard C functions, and uses the ``cdecl`` calling
5555
convention::
5656

5757
>>> from ctypes import *

_sources/library/functools.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -218,7 +218,7 @@ The :mod:`functools` module defines the following functions:
218218
cache. See :ref:`faq-cache-method-calls`
219219

220220
An `LRU (least recently used) cache
221-
<https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU)>`_
221+
<https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_Recently_Used_(LRU)>`_
222222
works best when the most recent calls are the best predictors of upcoming
223223
calls (for example, the most popular articles on a news server tend to
224224
change each day). The cache's size limit assures that the cache does not

_sources/library/hashlib.rst.txt

+4-4
Original file line numberDiff line numberDiff line change
@@ -653,7 +653,7 @@ on the hash function used in digital signatures.
653653
by the signer.
654654

655655
(`NIST SP-800-106 "Randomized Hashing for Digital Signatures"
656-
<https://csrc.nist.gov/publications/detail/sp/800-106/archive/2009-02-25>`_)
656+
<https://csrc.nist.gov/pubs/sp/800/106/final>`_)
657657

658658
In BLAKE2 the salt is processed as a one-time input to the hash function during
659659
initialization, rather than as an input to each compression function.
@@ -807,8 +807,8 @@ Domain Dedication 1.0 Universal:
807807
.. _NIST-SP-800-132: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-132.pdf
808808
.. _stackexchange pbkdf2 iterations question: https://security.stackexchange.com/questions/3959/recommended-of-iterations-when-using-pbkdf2-sha256/
809809
.. _Attacks on cryptographic hash algorithms: https://en.wikipedia.org/wiki/Cryptographic_hash_function#Attacks_on_cryptographic_hash_algorithms
810-
.. _the FIPS 180-4 standard: https://csrc.nist.gov/publications/detail/fips/180/4/final
811-
.. _the FIPS 202 standard: https://csrc.nist.gov/publications/detail/fips/202/final
810+
.. _the FIPS 180-4 standard: https://csrc.nist.gov/pubs/fips/180-4/upd1/final
811+
.. _the FIPS 202 standard: https://csrc.nist.gov/pubs/fips/202/final
812812
.. _HACL\* project: https://github.com/hacl-star/hacl-star
813813

814814

@@ -825,7 +825,7 @@ Domain Dedication 1.0 Universal:
825825
https://nvlpubs.nist.gov/nistpubs/fips/nist.fips.180-4.pdf
826826
The FIPS 180-4 publication on Secure Hash Algorithms.
827827

828-
https://csrc.nist.gov/publications/detail/fips/202/final
828+
https://csrc.nist.gov/pubs/fips/202/final
829829
The FIPS 202 publication on the SHA-3 Standard.
830830

831831
https://www.blake2.net/

_sources/library/http.cookiejar.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,7 @@ The following classes are provided:
137137
The Netscape protocol with the bugs fixed. Uses :mailheader:`Set-Cookie2` in
138138
place of :mailheader:`Set-Cookie`. Not widely used.
139139

140-
http://kristol.org/cookie/errata.html
140+
https://kristol.org/cookie/errata.html
141141
Unfinished errata to :rfc:`2965`.
142142

143143
:rfc:`2964` - Use of HTTP State Management

_sources/library/json.rst.txt

+2-2
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313

1414
`JSON (JavaScript Object Notation) <https://json.org>`_, specified by
1515
:rfc:`7159` (which obsoletes :rfc:`4627`) and by
16-
`ECMA-404 <https://www.ecma-international.org/publications-and-standards/standards/ecma-404/>`_,
16+
`ECMA-404 <https://ecma-international.org/publications-and-standards/standards/ecma-404/>`_,
1717
is a lightweight data interchange format inspired by
1818
`JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_ object literal syntax
1919
(although it is not a strict subset of JavaScript [#rfc-errata]_ ).
@@ -546,7 +546,7 @@ Standard Compliance and Interoperability
546546
----------------------------------------
547547

548548
The JSON format is specified by :rfc:`7159` and by
549-
`ECMA-404 <https://www.ecma-international.org/publications-and-standards/standards/ecma-404/>`_.
549+
`ECMA-404 <https://ecma-international.org/publications-and-standards/standards/ecma-404/>`_.
550550
This section details this module's level of compliance with the RFC.
551551
For simplicity, :class:`JSONEncoder` and :class:`JSONDecoder` subclasses, and
552552
parameters other than those explicitly mentioned, are not considered.

_sources/library/sqlite3.rst.txt

+14-15
Original file line numberDiff line numberDiff line change
@@ -519,21 +519,20 @@ Module constants
519519
The mappings from SQLite threading modes to DB-API 2.0 threadsafety levels
520520
are as follows:
521521

522-
+------------------+-----------------+----------------------+-------------------------------+
523-
| SQLite threading | `threadsafety`_ | `SQLITE_THREADSAFE`_ | DB-API 2.0 meaning |
524-
| mode | | | |
525-
+==================+=================+======================+===============================+
526-
| single-thread | 0 | 0 | Threads may not share the |
527-
| | | | module |
528-
+------------------+-----------------+----------------------+-------------------------------+
529-
| multi-thread | 1 | 2 | Threads may share the module, |
530-
| | | | but not connections |
531-
+------------------+-----------------+----------------------+-------------------------------+
532-
| serialized | 3 | 1 | Threads may share the module, |
533-
| | | | connections and cursors |
534-
+------------------+-----------------+----------------------+-------------------------------+
535-
536-
.. _threadsafety: https://peps.python.org/pep-0249/#threadsafety
522+
+------------------+----------------------+----------------------+-------------------------------+
523+
| SQLite threading | :pep:`threadsafety | `SQLITE_THREADSAFE`_ | DB-API 2.0 meaning |
524+
| mode | <0249#threadsafety>` | | |
525+
+==================+======================+======================+===============================+
526+
| single-thread | 0 | 0 | Threads may not share the |
527+
| | | | module |
528+
+------------------+----------------------+----------------------+-------------------------------+
529+
| multi-thread | 1 | 2 | Threads may share the module, |
530+
| | | | but not connections |
531+
+------------------+----------------------+----------------------+-------------------------------+
532+
| serialized | 3 | 1 | Threads may share the module, |
533+
| | | | connections and cursors |
534+
+------------------+----------------------+----------------------+-------------------------------+
535+
537536
.. _SQLITE_THREADSAFE: https://sqlite.org/compile.html#threadsafe
538537

539538
.. versionchanged:: 3.11

_sources/library/ssl.rst.txt

+5-5
Original file line numberDiff line numberDiff line change
@@ -1522,7 +1522,7 @@ to speed up repeated connections from the same clients.
15221522
The *capath* string, if present, is
15231523
the path to a directory containing several CA certificates in PEM format,
15241524
following an `OpenSSL specific layout
1525-
<https://www.openssl.org/docs/manmaster/man3/SSL_CTX_load_verify_locations.html>`_.
1525+
<https://docs.openssl.org/master/man3/SSL_CTX_load_verify_locations/>`_.
15261526

15271527
The *cadata* object, if present, is either an ASCII string of one or more
15281528
PEM-encoded certificates or a :term:`bytes-like object` of DER-encoded
@@ -1597,7 +1597,7 @@ to speed up repeated connections from the same clients.
15971597

15981598
Set the available ciphers for sockets created with this context.
15991599
It should be a string in the `OpenSSL cipher list format
1600-
<https://www.openssl.org/docs/manmaster/man1/ciphers.html>`_.
1600+
<https://docs.openssl.org/master/man1/ciphers/>`_.
16011601
If no cipher can be selected (because compile-time options or other
16021602
configuration forbids use of all the specified ciphers), an
16031603
:class:`SSLError` will be raised.
@@ -1829,7 +1829,7 @@ to speed up repeated connections from the same clients.
18291829
.. method:: SSLContext.session_stats()
18301830

18311831
Get statistics about the SSL sessions created or managed by this context.
1832-
A dictionary is returned which maps the names of each `piece of information <https://www.openssl.org/docs/man1.1.1/man3/SSL_CTX_sess_number.html>`_ to their
1832+
A dictionary is returned which maps the names of each `piece of information <https://docs.openssl.org/1.1.1/man3/SSL_CTX_sess_number/>`_ to their
18331833
numeric values. For example, here is the total number of hits and misses
18341834
in the session cache since the context was created::
18351835

@@ -1972,7 +1972,7 @@ to speed up repeated connections from the same clients.
19721972
.. attribute:: SSLContext.security_level
19731973

19741974
An integer representing the `security level
1975-
<https://www.openssl.org/docs/manmaster/man3/SSL_CTX_get_security_level.html>`_
1975+
<https://docs.openssl.org/master/man3/SSL_CTX_get_security_level/>`_
19761976
for the context. This attribute is read-only.
19771977

19781978
.. versionadded:: 3.10
@@ -2618,7 +2618,7 @@ enabled when negotiating a SSL session is possible through the
26182618
:meth:`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the
26192619
ssl module disables certain weak ciphers by default, but you may want
26202620
to further restrict the cipher choice. Be sure to read OpenSSL's documentation
2621-
about the `cipher list format <https://www.openssl.org/docs/man1.1.1/man1/ciphers.html#CIPHER-LIST-FORMAT>`_.
2621+
about the `cipher list format <https://docs.openssl.org/1.1.1/man1/ciphers/#cipher-list-format>`_.
26222622
If you want to check which ciphers are enabled by a given cipher list, use
26232623
:meth:`SSLContext.get_ciphers` or the ``openssl ciphers`` command on your
26242624
system.

_sources/library/tkinter.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ details that are unchanged.
5858
* `Modern Tkinter for Busy Python Developers <https://tkdocs.com/book.html>`_
5959
By Mark Roseman. (ISBN 978-1999149567)
6060

61-
* `Python GUI programming with Tkinter <https://www.packtpub.com/product/python-gui-programming-with-tkinter/9781788835886>`_
61+
* `Python GUI programming with Tkinter <https://www.packtpub.com/en-us/product/python-gui-programming-with-tkinter-9781788835886>`_
6262
By Alan D. Moore. (ISBN 978-1788835886)
6363

6464
* `Programming Python <https://learning-python.com/about-pp4e.html>`_

_sources/library/typing.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -2581,7 +2581,7 @@ Functions and decorators
25812581

25822582
.. seealso::
25832583
`Unreachable Code and Exhaustiveness Checking
2584-
<https://typing.readthedocs.io/en/latest/source/unreachable.html>`__ has more
2584+
<https://typing.readthedocs.io/en/latest/guides/unreachable.html>`__ has more
25852585
information about exhaustiveness checking with static typing.
25862586

25872587
.. versionadded:: 3.11

_sources/library/wsgiref.rst.txt

+8-8
Original file line numberDiff line numberDiff line change
@@ -783,8 +783,8 @@ in :pep:`3333`.
783783

784784
.. class:: StartResponse()
785785

786-
A :class:`typing.Protocol` describing `start_response()
787-
<https://peps.python.org/pep-3333/#the-start-response-callable>`_
786+
A :class:`typing.Protocol` describing :pep:`start_response()
787+
<3333#the-start-response-callable>`
788788
callables (:pep:`3333`).
789789

790790
.. data:: WSGIEnvironment
@@ -797,18 +797,18 @@ in :pep:`3333`.
797797

798798
.. class:: InputStream()
799799

800-
A :class:`typing.Protocol` describing a `WSGI Input Stream
801-
<https://peps.python.org/pep-3333/#input-and-error-streams>`_.
800+
A :class:`typing.Protocol` describing a :pep:`WSGI Input Stream
801+
<3333#input-and-error-streams>`.
802802

803803
.. class:: ErrorStream()
804804

805-
A :class:`typing.Protocol` describing a `WSGI Error Stream
806-
<https://peps.python.org/pep-3333/#input-and-error-streams>`_.
805+
A :class:`typing.Protocol` describing a :pep:`WSGI Error Stream
806+
<3333#input-and-error-streams>`.
807807

808808
.. class:: FileWrapper()
809809

810-
A :class:`typing.Protocol` describing a `file wrapper
811-
<https://peps.python.org/pep-3333/#optional-platform-specific-file-handling>`_.
810+
A :class:`typing.Protocol` describing a :pep:`file wrapper
811+
<3333#optional-platform-specific-file-handling>`.
812812
See :class:`wsgiref.util.FileWrapper` for a concrete implementation of this
813813
protocol.
814814

_sources/library/xmlrpc.client.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -165,7 +165,7 @@ between conformable Python objects and XML on the wire.
165165
A good description of XML-RPC operation and client software in several languages.
166166
Contains pretty much everything an XML-RPC client developer needs to know.
167167

168-
`XML-RPC Introspection <https://xmlrpc-c.sourceforge.net/introspection.html>`_
168+
`XML-RPC Introspection <https://xmlrpc-c.sourceforge.io/introspection.html>`_
169169
Describes the XML-RPC protocol extension for introspection.
170170

171171
`XML-RPC Specification <http://xmlrpc.scripting.com/spec.html>`_

_sources/reference/introduction.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ PyPy
7474
and a Just in Time compiler. One of the goals of the project is to encourage
7575
experimentation with the language itself by making it easier to modify the
7676
interpreter (since it is written in Python). Additional information is
77-
available on `the PyPy project's home page <https://www.pypy.org/>`_.
77+
available on `the PyPy project's home page <https://pypy.org/>`_.
7878

7979
Each of these implementations varies in some way from the language as documented
8080
in this manual, or introduces specific information beyond what's covered in the

_sources/using/mac.rst.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -155,7 +155,7 @@ https://www.activestate.com; it can also be built from source.
155155
A number of alternative macOS GUI toolkits are available:
156156

157157
* `PySide <https://www.qt.io/qt-for-python>`__: Official Python bindings to the
158-
`Qt GUI toolkit <https://qt.io>`__.
158+
`Qt GUI toolkit <https://www.qt.io>`__.
159159

160160
* `PyQt <https://riverbankcomputing.com/software/pyqt/intro>`__: Alternative
161161
Python bindings to Qt.

_sources/using/windows.rst.txt

+2-2
Original file line numberDiff line numberDiff line change
@@ -548,7 +548,7 @@ key features:
548548
Popular scientific modules (such as numpy, scipy and pandas) and the
549549
``conda`` package manager.
550550

551-
`Enthought Deployment Manager <https://www.enthought.com/edm/>`_
551+
`Enthought Deployment Manager <https://assets.enthought.com/downloads/edm/>`_
552552
"The Next Generation Python Environment and Package Manager".
553553

554554
Previously Enthought provided Canopy, but it `reached end of life in 2016
@@ -1237,7 +1237,7 @@ shipped with PyWin32. It is an embeddable IDE with a built-in debugger.
12371237

12381238
.. seealso::
12391239

1240-
`Win32 How Do I...? <http://timgolden.me.uk/python/win32_how_do_i.html>`_
1240+
`Win32 How Do I...? <https://timgolden.me.uk/python/win32_how_do_i.html>`_
12411241
by Tim Golden
12421242

12431243
`Python and COM <https://www.boddie.org.uk/python/COM.html>`_

_sources/whatsnew/2.4.rst.txt

+3-3
Original file line numberDiff line numberDiff line change
@@ -684,11 +684,11 @@ includes a quick-start tutorial and a reference.
684684
Written by Facundo Batista and implemented by Facundo Batista, Eric Price,
685685
Raymond Hettinger, Aahz, and Tim Peters.
686686

687-
http://www.lahey.com/float.htm
687+
`http://www.lahey.com/float.htm <https://web.archive.org/web/20230604072523/http://www.lahey.com/float.htm>`__
688688
The article uses Fortran code to illustrate many of the problems that
689689
floating-point inaccuracy can cause.
690690

691-
http://speleotrove.com/decimal/
691+
https://speleotrove.com/decimal/
692692
A description of a decimal-based representation. This representation is being
693693
proposed as a standard, and underlies the new Python decimal type. Much of this
694694
material was written by Mike Cowlishaw, designer of the Rexx language.
@@ -757,7 +757,7 @@ API that perform ASCII-only conversions, ignoring the locale setting:
757757
:c:expr:`double` to an ASCII string.
758758

759759
The code for these functions came from the GLib library
760-
(https://developer-old.gnome.org/glib/2.26/), whose developers kindly
760+
(`https://developer-old.gnome.org/glib/2.26/ <http://web.archive.org/web/20210306104320/https://developer.gnome.org/glib/2.26/>`__), whose developers kindly
761761
relicensed the relevant functions and donated them to the Python Software
762762
Foundation. The :mod:`locale` module can now change the numeric locale,
763763
letting extensions such as GTK+ produce the correct results.

0 commit comments

Comments
 (0)