mirror of
https://github.com/python/cpython.git
synced 2025-11-09 10:01:42 +00:00
bpo-25910: Link redirections in docs (#1933)
Fixes some redirection links in docs.
This commit is contained in:
parent
7464e87a65
commit
338cd83c5d
37 changed files with 61 additions and 63 deletions
|
|
@ -62,7 +62,7 @@ Key terms
|
||||||
locally.
|
locally.
|
||||||
|
|
||||||
.. _setuptools: https://setuptools.readthedocs.io/en/latest/
|
.. _setuptools: https://setuptools.readthedocs.io/en/latest/
|
||||||
.. _wheel: https://wheel.readthedocs.org
|
.. _wheel: https://wheel.readthedocs.io/
|
||||||
|
|
||||||
Open source licensing and collaboration
|
Open source licensing and collaboration
|
||||||
=======================================
|
=======================================
|
||||||
|
|
@ -111,7 +111,7 @@ by invoking the ``pip`` module at the command line::
|
||||||
The Python Packaging User Guide includes more details on the `currently
|
The Python Packaging User Guide includes more details on the `currently
|
||||||
recommended tools`_.
|
recommended tools`_.
|
||||||
|
|
||||||
.. _currently recommended tools: https://packaging.python.org/en/latest/current/#packaging-tool-recommendations
|
.. _currently recommended tools: https://packaging.python.org/guides/tool-recommendations/#packaging-tool-recommendations
|
||||||
|
|
||||||
Reading the guide
|
Reading the guide
|
||||||
=================
|
=================
|
||||||
|
|
@ -124,11 +124,11 @@ involved in creating a project:
|
||||||
* `Uploading the project to the Python Packaging Index`_
|
* `Uploading the project to the Python Packaging Index`_
|
||||||
|
|
||||||
.. _Project structure: \
|
.. _Project structure: \
|
||||||
https://packaging.python.org/en/latest/distributing/
|
https://packaging.python.org/tutorials/distributing-packages/
|
||||||
.. _Building and packaging the project: \
|
.. _Building and packaging the project: \
|
||||||
https://packaging.python.org/en/latest/distributing/#packaging-your-project
|
https://packaging.python.org/tutorials/distributing-packages/#packaging-your-project
|
||||||
.. _Uploading the project to the Python Packaging Index: \
|
.. _Uploading the project to the Python Packaging Index: \
|
||||||
https://packaging.python.org/en/latest/distributing/#uploading-your-project-to-pypi
|
https://packaging.python.org/tutorials/distributing-packages/#uploading-your-project-to-pypi
|
||||||
|
|
||||||
|
|
||||||
How do I...?
|
How do I...?
|
||||||
|
|
@ -160,7 +160,7 @@ Python Packaging User Guide for more information and recommendations.
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Python Packaging User Guide: Binary Extensions
|
`Python Packaging User Guide: Binary Extensions
|
||||||
<https://packaging.python.org/en/latest/extensions>`__
|
<https://packaging.python.org/guides/packaging-binary-extensions/>`__
|
||||||
|
|
||||||
.. other topics:
|
.. other topics:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -22,7 +22,7 @@ very little overhead for build/release/install mechanics.
|
||||||
This guide only covers the basic tools for building and distributing
|
This guide only covers the basic tools for building and distributing
|
||||||
extensions that are provided as part of this version of Python. Third party
|
extensions that are provided as part of this version of Python. Third party
|
||||||
tools offer easier to use and more secure alternatives. Refer to the `quick
|
tools offer easier to use and more secure alternatives. Refer to the `quick
|
||||||
recommendations section <https://packaging.python.org/en/latest/current/>`__
|
recommendations section <https://packaging.python.org/guides/tool-recommendations/>`__
|
||||||
in the Python Packaging User Guide for more information.
|
in the Python Packaging User Guide for more information.
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
|
|
||||||
|
|
@ -625,7 +625,7 @@ Notes:
|
||||||
|
|
||||||
(7)
|
(7)
|
||||||
The valid classifiers are listed on
|
The valid classifiers are listed on
|
||||||
`PyPI <http://pypi.python.org/pypi?:action=list_classifiers>`_.
|
`PyPI <https://pypi.python.org/pypi?:action=list_classifiers>`_.
|
||||||
|
|
||||||
(8)
|
(8)
|
||||||
To preserve backward compatibility, this field also accepts a string. If
|
To preserve backward compatibility, this field also accepts a string. If
|
||||||
|
|
|
||||||
|
|
@ -27,7 +27,8 @@ your system setup; details are given in later chapters.
|
||||||
avoid writing C extensions and preserve portability to other implementations.
|
avoid writing C extensions and preserve portability to other implementations.
|
||||||
For example, if your use case is calling C library functions or system calls,
|
For example, if your use case is calling C library functions or system calls,
|
||||||
you should consider using the :mod:`ctypes` module or the `cffi
|
you should consider using the :mod:`ctypes` module or the `cffi
|
||||||
<https://cffi.readthedocs.org>`_ library rather than writing custom C code.
|
<https://cffi.readthedocs.io/>`_ library rather than writing
|
||||||
|
custom C code.
|
||||||
These modules let you write Python code to interface with C code and are more
|
These modules let you write Python code to interface with C code and are more
|
||||||
portable between implementations of Python than writing and compiling a C
|
portable between implementations of Python than writing and compiling a C
|
||||||
extension module.
|
extension module.
|
||||||
|
|
|
||||||
|
|
@ -32,7 +32,7 @@ approaches to creating C and C++ extensions for Python.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Python Packaging User Guide: Binary Extensions <https://packaging.python.org/en/latest/extensions/>`_
|
`Python Packaging User Guide: Binary Extensions <https://packaging.python.org/guides/packaging-binary-extensions/>`_
|
||||||
The Python Packaging User Guide not only covers several available
|
The Python Packaging User Guide not only covers several available
|
||||||
tools that simplify the creation of binary extensions, but also
|
tools that simplify the creation of binary extensions, but also
|
||||||
discusses the various reasons why creating an extension module may be
|
discusses the various reasons why creating an extension module may be
|
||||||
|
|
|
||||||
|
|
@ -272,7 +272,7 @@ The Python project's infrastructure is located all over the world.
|
||||||
`www.python.org <https://www.python.org>`_ is graciously hosted by `Rackspace
|
`www.python.org <https://www.python.org>`_ is graciously hosted by `Rackspace
|
||||||
<https://www.rackspace.com>`_, with CDN caching provided by `Fastly
|
<https://www.rackspace.com>`_, with CDN caching provided by `Fastly
|
||||||
<https://www.fastly.com>`_. `Upfront Systems
|
<https://www.fastly.com>`_. `Upfront Systems
|
||||||
<http://www.upfrontsystems.co.za/>`_ hosts `bugs.python.org
|
<http://www.upfrontsoftware.co.za>`_ hosts `bugs.python.org
|
||||||
<https://bugs.python.org>`_. Many other Python services like `the Wiki
|
<https://bugs.python.org>`_. Many other Python services like `the Wiki
|
||||||
<https://wiki.python.org>`_ are hosted by `Oregon State
|
<https://wiki.python.org>`_ are hosted by `Oregon State
|
||||||
University Open Source Lab <https://osuosl.org>`_.
|
University Open Source Lab <https://osuosl.org>`_.
|
||||||
|
|
|
||||||
|
|
@ -314,7 +314,7 @@ favourite beverage and carry on.
|
||||||
If your logging needs are simple, then use the above examples to incorporate
|
If your logging needs are simple, then use the above examples to incorporate
|
||||||
logging into your own scripts, and if you run into problems or don't
|
logging into your own scripts, and if you run into problems or don't
|
||||||
understand something, please post a question on the comp.lang.python Usenet
|
understand something, please post a question on the comp.lang.python Usenet
|
||||||
group (available at https://groups.google.com/group/comp.lang.python) and you
|
group (available at https://groups.google.com/forum/#!forum/comp.lang.python) and you
|
||||||
should receive help before too long.
|
should receive help before too long.
|
||||||
|
|
||||||
Still here? You can carry on reading the next few sections, which provide a
|
Still here? You can carry on reading the next few sections, which provide a
|
||||||
|
|
|
||||||
|
|
@ -433,12 +433,12 @@ to make sure everything functions as expected in both versions of Python.
|
||||||
.. _Futurize: http://python-future.org/automatic_conversion.html
|
.. _Futurize: http://python-future.org/automatic_conversion.html
|
||||||
.. _importlib: https://docs.python.org/3/library/importlib.html#module-importlib
|
.. _importlib: https://docs.python.org/3/library/importlib.html#module-importlib
|
||||||
.. _importlib2: https://pypi.python.org/pypi/importlib2
|
.. _importlib2: https://pypi.python.org/pypi/importlib2
|
||||||
.. _Modernize: https://python-modernize.readthedocs.org/en/latest/
|
.. _Modernize: https://python-modernize.readthedocs.io/
|
||||||
.. _mypy: http://mypy-lang.org/
|
.. _mypy: http://mypy-lang.org/
|
||||||
.. _Porting to Python 3: http://python3porting.com/
|
.. _Porting to Python 3: http://python3porting.com/
|
||||||
.. _Pylint: https://pypi.python.org/pypi/pylint
|
.. _Pylint: https://pypi.python.org/pypi/pylint
|
||||||
|
|
||||||
.. _Python 3 Q & A: https://ncoghlan-devs-python-notes.readthedocs.org/en/latest/python3/questions_and_answers.html
|
.. _Python 3 Q & A: https://ncoghlan-devs-python-notes.readthedocs.io/en/latest/python3/questions_and_answers.html
|
||||||
|
|
||||||
.. _pytype: https://github.com/google/pytype
|
.. _pytype: https://github.com/google/pytype
|
||||||
.. _python-future: http://python-future.org/
|
.. _python-future: http://python-future.org/
|
||||||
|
|
|
||||||
|
|
@ -214,7 +214,7 @@ difficult reading. `A chronology <http://www.unicode.org/history/>`_ of the
|
||||||
origin and development of Unicode is also available on the site.
|
origin and development of Unicode is also available on the site.
|
||||||
|
|
||||||
To help understand the standard, Jukka Korpela has written `an introductory
|
To help understand the standard, Jukka Korpela has written `an introductory
|
||||||
guide <https://www.cs.tut.fi/~jkorpela/unicode/guide.html>`_ to reading the
|
guide <http://jkorpela.fi/unicode/guide.html>`_ to reading the
|
||||||
Unicode character tables.
|
Unicode character tables.
|
||||||
|
|
||||||
Another `good introductory article <https://www.joelonsoftware.com/2003/10/08/the-absolute-minimum-every-software-developer-absolutely-positively-must-know-about-unicode-and-character-sets-no-excuses/>`_
|
Another `good introductory article <https://www.joelonsoftware.com/2003/10/08/the-absolute-minimum-every-software-developer-absolutely-positively-must-know-about-unicode-and-character-sets-no-excuses/>`_
|
||||||
|
|
|
||||||
|
|
@ -403,7 +403,7 @@ fetched, particularly the headers sent by the server. It is currently an
|
||||||
:class:`http.client.HTTPMessage` instance.
|
:class:`http.client.HTTPMessage` instance.
|
||||||
|
|
||||||
Typical headers include 'Content-length', 'Content-type', and so on. See the
|
Typical headers include 'Content-length', 'Content-type', and so on. See the
|
||||||
`Quick Reference to HTTP Headers <https://www.cs.tut.fi/~jkorpela/http.html>`_
|
`Quick Reference to HTTP Headers <http://jkorpela.fi/http.html>`_
|
||||||
for a useful listing of HTTP headers with brief explanations of their meaning
|
for a useful listing of HTTP headers with brief explanations of their meaning
|
||||||
and use.
|
and use.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -36,7 +36,7 @@ modules and extensions.
|
||||||
This guide only covers the basic tools for building and distributing
|
This guide only covers the basic tools for building and distributing
|
||||||
extensions that are provided as part of this version of Python. Third party
|
extensions that are provided as part of this version of Python. Third party
|
||||||
tools offer easier to use and more secure alternatives. Refer to the `quick
|
tools offer easier to use and more secure alternatives. Refer to the `quick
|
||||||
recommendations section <https://packaging.python.org/en/latest/current/>`__
|
recommendations section <https://packaging.python.org/guides/tool-recommendations/>`__
|
||||||
in the Python Packaging User Guide for more information.
|
in the Python Packaging User Guide for more information.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -48,7 +48,7 @@ Key terms
|
||||||
repository of open source licensed packages made available for use by
|
repository of open source licensed packages made available for use by
|
||||||
other Python users.
|
other Python users.
|
||||||
* the `Python Packaging Authority
|
* the `Python Packaging Authority
|
||||||
<https://www.pypa.io/en/latest/>`__ are the group of
|
<https://www.pypa.io/>`__ are the group of
|
||||||
developers and documentation authors responsible for the maintenance and
|
developers and documentation authors responsible for the maintenance and
|
||||||
evolution of the standard packaging tools and the associated metadata and
|
evolution of the standard packaging tools and the associated metadata and
|
||||||
file format standards. They maintain a variety of tools, documentation,
|
file format standards. They maintain a variety of tools, documentation,
|
||||||
|
|
|
||||||
|
|
@ -261,5 +261,5 @@ and classes for traversing abstract syntax trees:
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Green Tree Snakes <https://greentreesnakes.readthedocs.org/>`_, an external documentation resource, has good
|
`Green Tree Snakes <https://greentreesnakes.readthedocs.io/>`_, an external documentation resource, has good
|
||||||
details on working with Python ASTs.
|
details on working with Python ASTs.
|
||||||
|
|
|
||||||
|
|
@ -21,7 +21,7 @@ spaces, the coordinates are all between 0 and 1.
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
More information about color spaces can be found at
|
More information about color spaces can be found at
|
||||||
http://www.poynton.com/ColorFAQ.html and
|
http://poynton.ca/ColorFAQ.html and
|
||||||
https://www.cambridgeincolour.com/tutorials/color-spaces.htm.
|
https://www.cambridgeincolour.com/tutorials/color-spaces.htm.
|
||||||
|
|
||||||
The :mod:`colorsys` module defines the following functions:
|
The :mod:`colorsys` module defines the following functions:
|
||||||
|
|
|
||||||
|
|
@ -562,7 +562,7 @@ on the hash function used in digital signatures.
|
||||||
by the signer.
|
by the signer.
|
||||||
|
|
||||||
(`NIST SP-800-106 "Randomized Hashing for Digital Signatures"
|
(`NIST SP-800-106 "Randomized Hashing for Digital Signatures"
|
||||||
<http://csrc.nist.gov/publications/nistpubs/800-106/NIST-SP-800-106.pdf>`_)
|
<https://csrc.nist.gov/publications/detail/sp/800-106/final>`_)
|
||||||
|
|
||||||
In BLAKE2 the salt is processed as a one-time input to the hash function during
|
In BLAKE2 the salt is processed as a one-time input to the hash function during
|
||||||
initialization, rather than as an input to each compression function.
|
initialization, rather than as an input to each compression function.
|
||||||
|
|
@ -728,7 +728,7 @@ Domain Dedication 1.0 Universal:
|
||||||
https://blake2.net
|
https://blake2.net
|
||||||
Official BLAKE2 website.
|
Official BLAKE2 website.
|
||||||
|
|
||||||
http://csrc.nist.gov/publications/fips/fips180-2/fips180-2.pdf
|
https://csrc.nist.gov/csrc/media/publications/fips/180/2/archive/2002-08-01/documents/fips180-2.pdf
|
||||||
The FIPS 180-2 publication on Secure Hash Algorithms.
|
The FIPS 180-2 publication on Secure Hash Algorithms.
|
||||||
|
|
||||||
https://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash_algorithms
|
https://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash_algorithms
|
||||||
|
|
|
||||||
|
|
@ -620,7 +620,7 @@ Supported mailbox formats are Maildir, mbox, MH, Babyl, and MMDF.
|
||||||
`nmh - Message Handling System <http://www.nongnu.org/nmh/>`_
|
`nmh - Message Handling System <http://www.nongnu.org/nmh/>`_
|
||||||
Home page of :program:`nmh`, an updated version of the original :program:`mh`.
|
Home page of :program:`nmh`, an updated version of the original :program:`mh`.
|
||||||
|
|
||||||
`MH & nmh: Email for Users & Programmers <http://rand-mh.sourceforge.net/book/>`_
|
`MH & nmh: Email for Users & Programmers <https://rand-mh.sourceforge.io/book/>`_
|
||||||
A GPL-licensed book on :program:`mh` and :program:`nmh`, with some information
|
A GPL-licensed book on :program:`mh` and :program:`nmh`, with some information
|
||||||
on the mailbox format.
|
on the mailbox format.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -461,7 +461,7 @@ Constants
|
||||||
Tau is a circle constant equal to 2\ *π*, the ratio of a circle's circumference to
|
Tau is a circle constant equal to 2\ *π*, the ratio of a circle's circumference to
|
||||||
its radius. To learn more about Tau, check out Vi Hart's video `Pi is (still)
|
its radius. To learn more about Tau, check out Vi Hart's video `Pi is (still)
|
||||||
Wrong <https://www.youtube.com/watch?v=jG7vhMMXagQ>`_, and start celebrating
|
Wrong <https://www.youtube.com/watch?v=jG7vhMMXagQ>`_, and start celebrating
|
||||||
`Tau day <http://tauday.com/>`_ by eating twice as much pie!
|
`Tau day <https://tauday.com/>`_ by eating twice as much pie!
|
||||||
|
|
||||||
.. versionadded:: 3.6
|
.. versionadded:: 3.6
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -38,7 +38,7 @@ or :class:`datetime.datetime` objects.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`PList manual page <https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man5/plist.5.html>`_
|
`PList manual page <https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/PropertyLists/>`_
|
||||||
Apple's documentation of the file format.
|
Apple's documentation of the file format.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -868,9 +868,9 @@ Constants
|
||||||
.. data:: HAS_NPN
|
.. data:: HAS_NPN
|
||||||
|
|
||||||
Whether the OpenSSL library has built-in support for *Next Protocol
|
Whether the OpenSSL library has built-in support for *Next Protocol
|
||||||
Negotiation* as described in the `NPN draft specification
|
Negotiation* as described in the `Application Layer Protocol
|
||||||
<https://tools.ietf.org/html/draft-agl-tls-nextprotoneg>`_. When true,
|
Negotiation <https://en.wikipedia.org/wiki/Application-Layer_Protocol_Negotiation>`_.
|
||||||
you can use the :meth:`SSLContext.set_npn_protocols` method to advertise
|
When true, you can use the :meth:`SSLContext.set_npn_protocols` method to advertise
|
||||||
which protocols you want to support.
|
which protocols you want to support.
|
||||||
|
|
||||||
.. versionadded:: 3.3
|
.. versionadded:: 3.3
|
||||||
|
|
@ -1374,7 +1374,7 @@ to speed up repeated connections from the same clients.
|
||||||
The *capath* string, if present, is
|
The *capath* string, if present, is
|
||||||
the path to a directory containing several CA certificates in PEM format,
|
the path to a directory containing several CA certificates in PEM format,
|
||||||
following an `OpenSSL specific layout
|
following an `OpenSSL specific layout
|
||||||
<https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_load_verify_locations.html>`_.
|
<https://www.openssl.org/docs/manmaster/man3/SSL_CTX_load_verify_locations.html>`_.
|
||||||
|
|
||||||
The *cadata* object, if present, is either an ASCII string of one or more
|
The *cadata* object, if present, is either an ASCII string of one or more
|
||||||
PEM-encoded certificates or a :term:`bytes-like object` of DER-encoded
|
PEM-encoded certificates or a :term:`bytes-like object` of DER-encoded
|
||||||
|
|
@ -1501,8 +1501,8 @@ to speed up repeated connections from the same clients.
|
||||||
Specify which protocols the socket should advertise during the SSL/TLS
|
Specify which protocols the socket should advertise during the SSL/TLS
|
||||||
handshake. It should be a list of strings, like ``['http/1.1', 'spdy/2']``,
|
handshake. It should be a list of strings, like ``['http/1.1', 'spdy/2']``,
|
||||||
ordered by preference. The selection of a protocol will happen during the
|
ordered by preference. The selection of a protocol will happen during the
|
||||||
handshake, and will play out according to the `NPN draft specification
|
handshake, and will play out according to the `Application Layer Protocol Negotiation
|
||||||
<https://tools.ietf.org/html/draft-agl-tls-nextprotoneg>`_. After a
|
<https://en.wikipedia.org/wiki/Application-Layer_Protocol_Negotiation>`_. After a
|
||||||
successful handshake, the :meth:`SSLSocket.selected_npn_protocol` method will
|
successful handshake, the :meth:`SSLSocket.selected_npn_protocol` method will
|
||||||
return the agreed-upon protocol.
|
return the agreed-upon protocol.
|
||||||
|
|
||||||
|
|
@ -1663,8 +1663,7 @@ to speed up repeated connections from the same clients.
|
||||||
.. method:: SSLContext.session_stats()
|
.. method:: SSLContext.session_stats()
|
||||||
|
|
||||||
Get statistics about the SSL sessions created or managed by this context.
|
Get statistics about the SSL sessions created or managed by this context.
|
||||||
A dictionary is returned which maps the names of each `piece of information
|
A dictionary is returned which maps the names of each `piece of information <https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_sess_number.html>`_ to their
|
||||||
<https://www.openssl.org/docs/man1.1.0/ssl/SSL_CTX_sess_number.html>`_ to their
|
|
||||||
numeric values. For example, here is the total number of hits and misses
|
numeric values. For example, here is the total number of hits and misses
|
||||||
in the session cache since the context was created::
|
in the session cache since the context was created::
|
||||||
|
|
||||||
|
|
@ -2365,7 +2364,7 @@ enabled when negotiating a SSL session is possible through the
|
||||||
:meth:`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the
|
:meth:`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the
|
||||||
ssl module disables certain weak ciphers by default, but you may want
|
ssl module disables certain weak ciphers by default, but you may want
|
||||||
to further restrict the cipher choice. Be sure to read OpenSSL's documentation
|
to further restrict the cipher choice. Be sure to read OpenSSL's documentation
|
||||||
about the `cipher list format <https://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT>`_.
|
about the `cipher list format <https://www.openssl.org/docs/manmaster/man1/ciphers.html#CIPHER-LIST-FORMAT>`_.
|
||||||
If you want to check which ciphers are enabled by a given cipher list, use
|
If you want to check which ciphers are enabled by a given cipher list, use
|
||||||
:meth:`SSLContext.get_ciphers` or the ``openssl ciphers`` command on your
|
:meth:`SSLContext.get_ciphers` or the ``openssl ciphers`` command on your
|
||||||
system.
|
system.
|
||||||
|
|
@ -2393,10 +2392,10 @@ successful call of :func:`~ssl.RAND_add`, :func:`~ssl.RAND_bytes` or
|
||||||
`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: Certificate-Based Key Management <https://www.ietf.org/rfc/rfc1422>`_
|
`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: Certificate-Based Key Management <https://www.ietf.org/rfc/rfc1422>`_
|
||||||
Steve Kent
|
Steve Kent
|
||||||
|
|
||||||
`RFC 4086: Randomness Requirements for Security <http://datatracker.ietf.org/doc/rfc4086/>`_
|
`RFC 4086: Randomness Requirements for Security <https://datatracker.ietf.org/doc/rfc4086/>`_
|
||||||
Donald E., Jeffrey I. Schiller
|
Donald E., Jeffrey I. Schiller
|
||||||
|
|
||||||
`RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile <http://datatracker.ietf.org/doc/rfc5280/>`_
|
`RFC 5280: Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile <https://datatracker.ietf.org/doc/rfc5280/>`_
|
||||||
D. Cooper
|
D. Cooper
|
||||||
|
|
||||||
`RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 <https://tools.ietf.org/html/rfc5246>`_
|
`RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 <https://tools.ietf.org/html/rfc5246>`_
|
||||||
|
|
|
||||||
|
|
@ -257,8 +257,6 @@ However, for reading convenience, most of the examples show sorted sequences.
|
||||||
* "Statistics for the Behavioral Sciences", Frederick J Gravetter and
|
* "Statistics for the Behavioral Sciences", Frederick J Gravetter and
|
||||||
Larry B Wallnau (8th Edition).
|
Larry B Wallnau (8th Edition).
|
||||||
|
|
||||||
* Calculating the `median <https://www.ualberta.ca/~opscan/median.html>`_.
|
|
||||||
|
|
||||||
* The `SSMEDIAN
|
* The `SSMEDIAN
|
||||||
<https://help.gnome.org/users/gnumeric/stable/gnumeric.html#gnumeric-function-SSMEDIAN>`_
|
<https://help.gnome.org/users/gnumeric/stable/gnumeric.html#gnumeric-function-SSMEDIAN>`_
|
||||||
function in the Gnome Gnumeric spreadsheet, including `this discussion
|
function in the Gnome Gnumeric spreadsheet, including `this discussion
|
||||||
|
|
|
||||||
|
|
@ -35,7 +35,7 @@ this should open a window demonstrating a simple Tk interface.
|
||||||
`Tcl/Tk manual <https://www.tcl.tk/man/tcl8.5/>`_
|
`Tcl/Tk manual <https://www.tcl.tk/man/tcl8.5/>`_
|
||||||
Official manual for the latest tcl/tk version.
|
Official manual for the latest tcl/tk version.
|
||||||
|
|
||||||
`Programming Python <http://learning-python.com/books/about-pp4e.html>`_
|
`Programming Python <http://learning-python.com/about-pp4e.html>`_
|
||||||
Book by Mark Lutz, has excellent coverage of Tkinter.
|
Book by Mark Lutz, has excellent coverage of Tkinter.
|
||||||
|
|
||||||
`Modern Tkinter for Busy Python Developers <https://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_
|
`Modern Tkinter for Busy Python Developers <https://www.amazon.com/Modern-Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_
|
||||||
|
|
|
||||||
|
|
@ -26,7 +26,7 @@ appearance.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Tk Widget Styling Support <https://www.tcl.tk/cgi-bin/tct/tip/48>`_
|
`Tk Widget Styling Support <https://core.tcl.tk/tips/doc/trunk/tip/48.md>`_
|
||||||
A document introducing theming support for Tk
|
A document introducing theming support for Tk
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1008,7 +1008,7 @@ subclass.
|
||||||
True
|
True
|
||||||
|
|
||||||
Sometimes this is inconvenient. For example, `one user
|
Sometimes this is inconvenient. For example, `one user
|
||||||
<https://code.google.com/p/mock/issues/detail?id=105>`_ is subclassing mock to
|
<https://code.google.com/archive/p/mock/issues/105>`_ is subclassing mock to
|
||||||
created a `Twisted adaptor
|
created a `Twisted adaptor
|
||||||
<https://twistedmatrix.com/documents/11.0.0/api/twisted.python.components.html>`_.
|
<https://twistedmatrix.com/documents/11.0.0/api/twisted.python.components.html>`_.
|
||||||
Having this applied to attributes too actually causes errors.
|
Having this applied to attributes too actually causes errors.
|
||||||
|
|
@ -1251,7 +1251,7 @@ With a bit of tweaking you could have the comparison function raise the
|
||||||
:exc:`AssertionError` directly and provide a more useful failure message.
|
:exc:`AssertionError` directly and provide a more useful failure message.
|
||||||
|
|
||||||
As of version 1.5, the Python testing library `PyHamcrest
|
As of version 1.5, the Python testing library `PyHamcrest
|
||||||
<https://pyhamcrest.readthedocs.org/>`_ provides similar functionality,
|
<https://pyhamcrest.readthedocs.io/>`_ provides similar functionality,
|
||||||
that may be useful here, in the form of its equality matcher
|
that may be useful here, in the form of its equality matcher
|
||||||
(`hamcrest.library.integration.match_equality
|
(`hamcrest.library.integration.match_equality
|
||||||
<https://pyhamcrest.readthedocs.org/en/release-1.8/integration/#module-hamcrest.library.integration.match_equality>`_).
|
<https://pyhamcrest.readthedocs.io/en/release-1.8/integration/#module-hamcrest.library.integration.match_equality>`_).
|
||||||
|
|
|
||||||
|
|
@ -62,7 +62,7 @@ The :mod:`urllib.request` module defines the following functions:
|
||||||
|
|
||||||
* :meth:`~urllib.response.addinfourl.info` --- return the meta-information of the page, such as headers,
|
* :meth:`~urllib.response.addinfourl.info` --- return the meta-information of the page, such as headers,
|
||||||
in the form of an :func:`email.message_from_string` instance (see
|
in the form of an :func:`email.message_from_string` instance (see
|
||||||
`Quick Reference to HTTP Headers <https://www.cs.tut.fi/~jkorpela/http.html>`_)
|
`Quick Reference to HTTP Headers <http://jkorpela.fi/http.html>`_)
|
||||||
|
|
||||||
* :meth:`~urllib.response.addinfourl.getcode` -- return the HTTP status code of the response.
|
* :meth:`~urllib.response.addinfourl.getcode` -- return the HTTP status code of the response.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -458,4 +458,4 @@ subclass which installs setuptools and pip into a created virtual environment::
|
||||||
|
|
||||||
|
|
||||||
This script is also available for download `online
|
This script is also available for download `online
|
||||||
<https://gist.github.com/4673395>`_.
|
<https://gist.github.com/vsajip/4673395>`_.
|
||||||
|
|
|
||||||
|
|
@ -26,8 +26,8 @@ for implementing WSGI servers, a demo HTTP server that serves WSGI applications,
|
||||||
and a validation tool that checks WSGI servers and applications for conformance
|
and a validation tool that checks WSGI servers and applications for conformance
|
||||||
to the WSGI specification (:pep:`3333`).
|
to the WSGI specification (:pep:`3333`).
|
||||||
|
|
||||||
See https://wsgi.readthedocs.org/ for more information about WSGI, and links to
|
See `wsgi.readthedocs.io <https://wsgi.readthedocs.io/>`_ for more information about WSGI, and links
|
||||||
tutorials and other resources.
|
to tutorials and other resources.
|
||||||
|
|
||||||
.. XXX If you're just trying to write a web application...
|
.. XXX If you're just trying to write a web application...
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -67,13 +67,13 @@ implementations are free to support the strict mapping from IDL). See section
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Document Object Model (DOM) Level 2 Specification <https://www.w3.org/TR/DOM-Level-2-Core/>`_
|
`Document Object Model (DOM) Level 2 Specification <https://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113/>`_
|
||||||
The W3C recommendation upon which the Python DOM API is based.
|
The W3C recommendation upon which the Python DOM API is based.
|
||||||
|
|
||||||
`Document Object Model (DOM) Level 1 Specification <https://www.w3.org/TR/REC-DOM-Level-1/>`_
|
`Document Object Model (DOM) Level 1 Specification <https://www.w3.org/TR/REC-DOM-Level-1/>`_
|
||||||
The W3C recommendation for the DOM supported by :mod:`xml.dom.minidom`.
|
The W3C recommendation for the DOM supported by :mod:`xml.dom.minidom`.
|
||||||
|
|
||||||
`Python Language Mapping Specification <http://www.omg.org/spec/PYTH/1.2/PDF>`_
|
`Python Language Mapping Specification <http://www.omg.org/cgi-bin/doc?formal/02-11-05.pdf>`_
|
||||||
This specifies the mapping from OMG IDL to Python.
|
This specifies the mapping from OMG IDL to Python.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -66,7 +66,7 @@ number of standard Unix command line editors, :program:`vim` and
|
||||||
:program:`BBEdit` or :program:`TextWrangler` from Bare Bones Software (see
|
:program:`BBEdit` or :program:`TextWrangler` from Bare Bones Software (see
|
||||||
http://www.barebones.com/products/bbedit/index.html) are good choices, as is
|
http://www.barebones.com/products/bbedit/index.html) are good choices, as is
|
||||||
:program:`TextMate` (see https://macromates.com/). Other editors include
|
:program:`TextMate` (see https://macromates.com/). Other editors include
|
||||||
:program:`Gvim` (http://macvim.org) and :program:`Aquamacs`
|
:program:`Gvim` (http://macvim-dev.github.io/macvim/) and :program:`Aquamacs`
|
||||||
(http://aquamacs.org/).
|
(http://aquamacs.org/).
|
||||||
|
|
||||||
To run your script from the Terminal window you must make sure that
|
To run your script from the Terminal window you must make sure that
|
||||||
|
|
@ -117,7 +117,7 @@ The IDE
|
||||||
|
|
||||||
MacPython ships with the standard IDLE development environment. A good
|
MacPython ships with the standard IDLE development environment. A good
|
||||||
introduction to using IDLE can be found at
|
introduction to using IDLE can be found at
|
||||||
https://hkn.eecs.berkeley.edu/~dyoo/python/idle_intro/index.html.
|
http://www.hashcollision.org/hkn/python/idle_intro/index.html.
|
||||||
|
|
||||||
|
|
||||||
.. _mac-package-manager:
|
.. _mac-package-manager:
|
||||||
|
|
|
||||||
|
|
@ -30,7 +30,7 @@ following links:
|
||||||
for Debian users
|
for Debian users
|
||||||
https://en.opensuse.org/Portal:Packaging
|
https://en.opensuse.org/Portal:Packaging
|
||||||
for OpenSuse users
|
for OpenSuse users
|
||||||
https://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/ch-creating-rpms.html
|
https://docs-old.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/ch-creating-rpms.html
|
||||||
for Fedora users
|
for Fedora users
|
||||||
http://www.slackbook.org/html/package-management-making-packages.html
|
http://www.slackbook.org/html/package-management-making-packages.html
|
||||||
for Slackware users
|
for Slackware users
|
||||||
|
|
|
||||||
|
|
@ -307,11 +307,11 @@ key features:
|
||||||
`ActivePython <https://www.activestate.com/activepython/>`_
|
`ActivePython <https://www.activestate.com/activepython/>`_
|
||||||
Installer with multi-platform compatibility, documentation, PyWin32
|
Installer with multi-platform compatibility, documentation, PyWin32
|
||||||
|
|
||||||
`Anaconda <https://www.continuum.io/downloads/>`_
|
`Anaconda <https://www.anaconda.com/download/>`_
|
||||||
Popular scientific modules (such as numpy, scipy and pandas) and the
|
Popular scientific modules (such as numpy, scipy and pandas) and the
|
||||||
``conda`` package manager.
|
``conda`` package manager.
|
||||||
|
|
||||||
`Canopy <https://www.enthought.com/products/canopy/>`_
|
`Canopy <https://www.enthought.com/product/canopy/>`_
|
||||||
A "comprehensive Python analysis environment" with editors and other
|
A "comprehensive Python analysis environment" with editors and other
|
||||||
development tools.
|
development tools.
|
||||||
|
|
||||||
|
|
@ -377,7 +377,7 @@ System variables, you need non-restricted access to your machine
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
https://support.microsoft.com/kb/100843
|
https://support.microsoft.com/en-us/help/100843/environment-variables-in-windows-nt
|
||||||
Environment variables in Windows NT
|
Environment variables in Windows NT
|
||||||
|
|
||||||
https://technet.microsoft.com/en-us/library/cc754250.aspx
|
https://technet.microsoft.com/en-us/library/cc754250.aspx
|
||||||
|
|
@ -386,7 +386,7 @@ System variables, you need non-restricted access to your machine
|
||||||
https://technet.microsoft.com/en-us/library/cc755104.aspx
|
https://technet.microsoft.com/en-us/library/cc755104.aspx
|
||||||
The SETX command, for permanently modifying environment variables
|
The SETX command, for permanently modifying environment variables
|
||||||
|
|
||||||
https://support.microsoft.com/kb/310519
|
https://support.microsoft.com/en-us/help/310519/how-to-manage-environment-variables-in-windows-xp
|
||||||
How To Manage Environment Variables in Windows XP
|
How To Manage Environment Variables in Windows XP
|
||||||
|
|
||||||
https://www.chem.gla.ac.uk/~louis/software/faq/q1.html
|
https://www.chem.gla.ac.uk/~louis/software/faq/q1.html
|
||||||
|
|
|
||||||
|
|
@ -957,7 +957,7 @@ New and Improved Modules
|
||||||
# 'title': 'html2fo 0.3 (Default)'}, ... ]
|
# 'title': 'html2fo 0.3 (Default)'}, ... ]
|
||||||
|
|
||||||
The :mod:`SimpleXMLRPCServer` module makes it easy to create straightforward
|
The :mod:`SimpleXMLRPCServer` module makes it easy to create straightforward
|
||||||
XML-RPC servers. See http://www.xmlrpc.com/ for more information about XML-RPC.
|
XML-RPC servers. See http://xmlrpc.scripting.com/ for more information about XML-RPC.
|
||||||
|
|
||||||
* The new :mod:`hmac` module implements the HMAC algorithm described by
|
* The new :mod:`hmac` module implements the HMAC algorithm described by
|
||||||
:rfc:`2104`. (Contributed by Gerhard Häring.)
|
:rfc:`2104`. (Contributed by Gerhard Häring.)
|
||||||
|
|
|
||||||
|
|
@ -1955,7 +1955,7 @@ The RPM spec files, found in the :file:`Misc/RPM/` directory in the Python
|
||||||
source distribution, were updated for 2.3. (Contributed by Sean Reifschneider.)
|
source distribution, were updated for 2.3. (Contributed by Sean Reifschneider.)
|
||||||
|
|
||||||
Other new platforms now supported by Python include AtheOS
|
Other new platforms now supported by Python include AtheOS
|
||||||
(http://atheos.cx/), GNU/Hurd, and OpenVMS.
|
(http://www.atheos.cx/), GNU/Hurd, and OpenVMS.
|
||||||
|
|
||||||
.. ======================================================================
|
.. ======================================================================
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -330,7 +330,7 @@ statement, only the ``from ... import`` form.
|
||||||
:pep:`328` - Imports: Multi-Line and Absolute/Relative
|
:pep:`328` - Imports: Multi-Line and Absolute/Relative
|
||||||
PEP written by Aahz; implemented by Thomas Wouters.
|
PEP written by Aahz; implemented by Thomas Wouters.
|
||||||
|
|
||||||
https://pylib.readthedocs.org/
|
https://pylib.readthedocs.io/
|
||||||
The py library by Holger Krekel, which contains the :mod:`py.std` package.
|
The py library by Holger Krekel, which contains the :mod:`py.std` package.
|
||||||
|
|
||||||
.. ======================================================================
|
.. ======================================================================
|
||||||
|
|
|
||||||
|
|
@ -172,7 +172,7 @@ this edition of "What's New in Python" links to the bug/patch
|
||||||
item for each change.
|
item for each change.
|
||||||
|
|
||||||
Hosting of the Python bug tracker is kindly provided by
|
Hosting of the Python bug tracker is kindly provided by
|
||||||
`Upfront Systems <http://www.upfrontsystems.co.za/>`__
|
`Upfront Systems <http://www.upfrontsoftware.co.za>`__
|
||||||
of Stellenbosch, South Africa. Martin von Löwis put a
|
of Stellenbosch, South Africa. Martin von Löwis put a
|
||||||
lot of effort into importing existing bugs and patches from
|
lot of effort into importing existing bugs and patches from
|
||||||
SourceForge; his scripts for this import operation are at
|
SourceForge; his scripts for this import operation are at
|
||||||
|
|
|
||||||
|
|
@ -1545,7 +1545,7 @@ changes, or look through the Subversion logs for all the details.
|
||||||
*ciphers* argument that's a string listing the encryption algorithms
|
*ciphers* argument that's a string listing the encryption algorithms
|
||||||
to be allowed; the format of the string is described
|
to be allowed; the format of the string is described
|
||||||
`in the OpenSSL documentation
|
`in the OpenSSL documentation
|
||||||
<https://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT>`__.
|
<https://www.openssl.org/docs/manmaster/man1/ciphers.html#CIPHER-LIST-FORMAT>`__.
|
||||||
(Added by Antoine Pitrou; :issue:`8322`.)
|
(Added by Antoine Pitrou; :issue:`8322`.)
|
||||||
|
|
||||||
Another change makes the extension load all of OpenSSL's ciphers and
|
Another change makes the extension load all of OpenSSL's ciphers and
|
||||||
|
|
|
||||||
|
|
@ -1643,7 +1643,7 @@ for secure (encrypted, authenticated) internet connections:
|
||||||
* The :func:`ssl.wrap_socket` constructor function now takes a *ciphers*
|
* The :func:`ssl.wrap_socket` constructor function now takes a *ciphers*
|
||||||
argument. The *ciphers* string lists the allowed encryption algorithms using
|
argument. The *ciphers* string lists the allowed encryption algorithms using
|
||||||
the format described in the `OpenSSL documentation
|
the format described in the `OpenSSL documentation
|
||||||
<https://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT>`__.
|
<https://www.openssl.org/docs/manmaster/man1/ciphers.html#CIPHER-LIST-FORMAT>`__.
|
||||||
|
|
||||||
* When linked against recent versions of OpenSSL, the :mod:`ssl` module now
|
* When linked against recent versions of OpenSSL, the :mod:`ssl` module now
|
||||||
supports the Server Name Indication extension to the TLS protocol, allowing
|
supports the Server Name Indication extension to the TLS protocol, allowing
|
||||||
|
|
|
||||||
|
|
@ -1568,7 +1568,7 @@ mark class variables. As introduced in :pep:`526`, a variable annotation
|
||||||
wrapped in ClassVar indicates that a given attribute is intended to be used as
|
wrapped in ClassVar indicates that a given attribute is intended to be used as
|
||||||
a class variable and should not be set on instances of that class.
|
a class variable and should not be set on instances of that class.
|
||||||
(Contributed by Ivan Levkivskyi in `Github #280
|
(Contributed by Ivan Levkivskyi in `Github #280
|
||||||
<https://github.com/python/typing/issues/280>`_.)
|
<https://github.com/python/typing/pull/280>`_.)
|
||||||
|
|
||||||
A new :const:`~typing.TYPE_CHECKING` constant that is assumed to be
|
A new :const:`~typing.TYPE_CHECKING` constant that is assumed to be
|
||||||
``True`` by the static type chekers, but is ``False`` at runtime.
|
``True`` by the static type chekers, but is ``False`` at runtime.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue