mirror of https://github.com/python/cpython
Merge with 3.4
This commit is contained in:
commit
cadc3fdcb5
|
@ -7,7 +7,7 @@ available at <https://docs.python.org/dev/download.html>.
|
||||||
|
|
||||||
Documentation on authoring Python documentation, including information about
|
Documentation on authoring Python documentation, including information about
|
||||||
both style and markup, is available in the "Documenting Python" chapter of the
|
both style and markup, is available in the "Documenting Python" chapter of the
|
||||||
developers guide <http://docs.python.org/devguide/documenting.html>.
|
developers guide <https://docs.python.org/devguide/documenting.html>.
|
||||||
|
|
||||||
|
|
||||||
Building the docs
|
Building the docs
|
||||||
|
@ -15,7 +15,7 @@ Building the docs
|
||||||
|
|
||||||
You need to have Sphinx <http://sphinx-doc.org/> installed; it is the toolset
|
You need to have Sphinx <http://sphinx-doc.org/> installed; it is the toolset
|
||||||
used to build the docs. It is not included in this tree, but maintained
|
used to build the docs. It is not included in this tree, but maintained
|
||||||
separately and available from PyPI <http://pypi.python.org/pypi/Sphinx>.
|
separately and available from PyPI <https://pypi.python.org/pypi/Sphinx>.
|
||||||
|
|
||||||
|
|
||||||
Using make
|
Using make
|
||||||
|
@ -43,53 +43,53 @@ the SPHINXBUILD variable.
|
||||||
|
|
||||||
Available make targets are:
|
Available make targets are:
|
||||||
|
|
||||||
* "clean", which removes all build files.
|
* "clean", which removes all build files.
|
||||||
|
|
||||||
* "html", which builds standalone HTML files for offline viewing.
|
* "html", which builds standalone HTML files for offline viewing.
|
||||||
|
|
||||||
* "htmlview", which re-uses the "html" builder, but then opens the main page
|
* "htmlview", which re-uses the "html" builder, but then opens the main page
|
||||||
in your default web browser.
|
in your default web browser.
|
||||||
|
|
||||||
* "htmlhelp", which builds HTML files and a HTML Help project file usable to
|
* "htmlhelp", which builds HTML files and a HTML Help project file usable to
|
||||||
convert them into a single Compiled HTML (.chm) file -- these are popular
|
convert them into a single Compiled HTML (.chm) file -- these are popular
|
||||||
under Microsoft Windows, but very handy on every platform.
|
under Microsoft Windows, but very handy on every platform.
|
||||||
|
|
||||||
To create the CHM file, you need to run the Microsoft HTML Help Workshop
|
To create the CHM file, you need to run the Microsoft HTML Help Workshop
|
||||||
over the generated project (.hhp) file. The make.bat script does this for
|
over the generated project (.hhp) file. The make.bat script does this for
|
||||||
you on Windows.
|
you on Windows.
|
||||||
|
|
||||||
* "latex", which builds LaTeX source files as input to "pdflatex" to produce
|
* "latex", which builds LaTeX source files as input to "pdflatex" to produce
|
||||||
PDF documents.
|
PDF documents.
|
||||||
|
|
||||||
* "text", which builds a plain text file for each source file.
|
* "text", which builds a plain text file for each source file.
|
||||||
|
|
||||||
* "epub", which builds an EPUB document, suitable to be viewed on e-book
|
* "epub", which builds an EPUB document, suitable to be viewed on e-book
|
||||||
readers.
|
readers.
|
||||||
|
|
||||||
* "linkcheck", which checks all external references to see whether they are
|
* "linkcheck", which checks all external references to see whether they are
|
||||||
broken, redirected or malformed, and outputs this information to stdout as
|
broken, redirected or malformed, and outputs this information to stdout as
|
||||||
well as a plain-text (.txt) file.
|
well as a plain-text (.txt) file.
|
||||||
|
|
||||||
* "changes", which builds an overview over all versionadded/versionchanged/
|
* "changes", which builds an overview over all versionadded/versionchanged/
|
||||||
deprecated items in the current version. This is meant as a help for the
|
deprecated items in the current version. This is meant as a help for the
|
||||||
writer of the "What's New" document.
|
writer of the "What's New" document.
|
||||||
|
|
||||||
* "coverage", which builds a coverage overview for standard library modules and
|
* "coverage", which builds a coverage overview for standard library modules and
|
||||||
C API.
|
C API.
|
||||||
|
|
||||||
* "pydoc-topics", which builds a Python module containing a dictionary with
|
* "pydoc-topics", which builds a Python module containing a dictionary with
|
||||||
plain text documentation for the labels defined in
|
plain text documentation for the labels defined in
|
||||||
`tools/pyspecific.py` -- pydoc needs these to show topic and keyword help.
|
`tools/pyspecific.py` -- pydoc needs these to show topic and keyword help.
|
||||||
|
|
||||||
* "suspicious", which checks the parsed markup for text that looks like
|
* "suspicious", which checks the parsed markup for text that looks like
|
||||||
malformed and thus unconverted reST.
|
malformed and thus unconverted reST.
|
||||||
|
|
||||||
* "check", which checks for frequent markup errors.
|
* "check", which checks for frequent markup errors.
|
||||||
|
|
||||||
* "serve", which serves the build/html directory on port 8000.
|
* "serve", which serves the build/html directory on port 8000.
|
||||||
|
|
||||||
* "dist", (Unix only) which creates distributable archives of HTML, text,
|
* "dist", (Unix only) which creates distributable archives of HTML, text,
|
||||||
PDF, and EPUB builds.
|
PDF, and EPUB builds.
|
||||||
|
|
||||||
|
|
||||||
Without make
|
Without make
|
||||||
|
@ -109,10 +109,10 @@ Contributing
|
||||||
============
|
============
|
||||||
|
|
||||||
Bugs in the content should be reported to the Python bug tracker at
|
Bugs in the content should be reported to the Python bug tracker at
|
||||||
http://bugs.python.org.
|
https://bugs.python.org.
|
||||||
|
|
||||||
Bugs in the toolset should be reported in the Sphinx bug tracker at
|
Bugs in the toolset should be reported in the Sphinx bug tracker at
|
||||||
http://www.bitbucket.org/birkenfeld/sphinx/issues/.
|
https://www.bitbucket.org/birkenfeld/sphinx/issues/.
|
||||||
|
|
||||||
You can also send a mail to the Python Documentation Team at docs@python.org,
|
You can also send a mail to the Python Documentation Team at docs@python.org,
|
||||||
and we will process your request as soon as possible.
|
and we will process your request as soon as possible.
|
||||||
|
|
|
@ -82,6 +82,6 @@ patching Python in the `Python Developer's Guide`_. If you have questions,
|
||||||
the `core-mentorship mailing list`_ is a friendly place to get answers to
|
the `core-mentorship mailing list`_ is a friendly place to get answers to
|
||||||
any and all questions pertaining to the process of fixing issues in Python.
|
any and all questions pertaining to the process of fixing issues in Python.
|
||||||
|
|
||||||
.. _Documentation bugs: http://bugs.python.org/issue?@filter=status&@filter=components&components=4&status=1&@columns=id,activity,title,status&@sort=-activity
|
.. _Documentation bugs: https://bugs.python.org/issue?@filter=status&@filter=components&components=4&status=1&@columns=id,activity,title,status&@sort=-activity
|
||||||
.. _Python Developer's Guide: http://docs.python.org/devguide/
|
.. _Python Developer's Guide: https://docs.python.org/devguide/
|
||||||
.. _core-mentorship mailing list: https://mail.python.org/mailman/listinfo/core-mentorship/
|
.. _core-mentorship mailing list: https://mail.python.org/mailman/listinfo/core-mentorship/
|
||||||
|
|
|
@ -67,7 +67,7 @@ html_additional_pages = {
|
||||||
}
|
}
|
||||||
|
|
||||||
# Output an OpenSearch description file.
|
# Output an OpenSearch description file.
|
||||||
html_use_opensearch = 'http://docs.python.org/' + version
|
html_use_opensearch = 'https://docs.python.org/' + version
|
||||||
|
|
||||||
# Additional static files.
|
# Additional static files.
|
||||||
html_static_path = ['tools/static']
|
html_static_path = ['tools/static']
|
||||||
|
|
|
@ -35,7 +35,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
|
||||||
<http://packaging.python.org/en/latest/future.html>`__ are the group of
|
<https://packaging.python.org/en/latest/future.html>`__ 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
|
||||||
|
@ -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: \
|
||||||
http://packaging.python.org/en/latest/distributing.html#creating-your-own-project
|
https://packaging.python.org/en/latest/distributing.html#creating-your-own-project
|
||||||
.. _Building and packaging the project: \
|
.. _Building and packaging the project: \
|
||||||
https://packaging.python.org/en/latest/distributing.html#packaging-your-project
|
https://packaging.python.org/en/latest/distributing.html#packaging-your-project
|
||||||
.. _Uploading the project to the Python Packaging Index: \
|
.. _Uploading the project to the Python Packaging Index: \
|
||||||
http://packaging.python.org/en/latest/distributing.html#uploading-your-project-to-pypi
|
https://packaging.python.org/en/latest/distributing.html#uploading-your-project-to-pypi
|
||||||
|
|
||||||
|
|
||||||
How do I...?
|
How do I...?
|
||||||
|
@ -160,11 +160,11 @@ Python Packaging User Guide for more information and recommendations.
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Python Packaging User Guide: Binary Extensions
|
`Python Packaging User Guide: Binary Extensions
|
||||||
<http://packaging.python.org/en/latest/extensions.html>`__
|
<https://packaging.python.org/en/latest/extensions.html>`__
|
||||||
|
|
||||||
.. other topics:
|
.. other topics:
|
||||||
|
|
||||||
Once the Development & Deployment part of PPUG is fleshed out, some of
|
Once the Development & Deployment part of PPUG is fleshed out, some of
|
||||||
those sections should be linked from new questions here (most notably,
|
those sections should be linked from new questions here (most notably,
|
||||||
we should have a question about avoiding depending on PyPI that links to
|
we should have a question about avoiding depending on PyPI that links to
|
||||||
http://packaging.python.org/en/latest/deployment.html#pypi-mirrors-and-caches)
|
https://packaging.python.org/en/latest/deployment.html#pypi-mirrors-and-caches)
|
||||||
|
|
|
@ -78,7 +78,7 @@ setup script). Indirectly provides the :class:`distutils.dist.Distribution` and
|
||||||
| | be built | :class:`distutils.core.Extension` |
|
| | be built | :class:`distutils.core.Extension` |
|
||||||
+--------------------+--------------------------------+-------------------------------------------------------------+
|
+--------------------+--------------------------------+-------------------------------------------------------------+
|
||||||
| *classifiers* | A list of categories for the | a list of strings; valid classifiers are listed on `PyPI |
|
| *classifiers* | A list of categories for the | a list of strings; valid classifiers are listed on `PyPI |
|
||||||
| | package | <http://pypi.python.org/pypi?:action=list_classifiers>`_. |
|
| | package | <https://pypi.python.org/pypi?:action=list_classifiers>`_. |
|
||||||
+--------------------+--------------------------------+-------------------------------------------------------------+
|
+--------------------+--------------------------------+-------------------------------------------------------------+
|
||||||
| *distclass* | the :class:`Distribution` | a subclass of |
|
| *distclass* | the :class:`Distribution` | a subclass of |
|
||||||
| | class to use | :class:`distutils.core.Distribution` |
|
| | class to use | :class:`distutils.core.Distribution` |
|
||||||
|
|
|
@ -11,7 +11,7 @@ Distutils Cookbook.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Distutils Cookbook <http://wiki.python.org/moin/Distutils/Cookbook>`_
|
`Distutils Cookbook <https://wiki.python.org/moin/Distutils/Cookbook>`_
|
||||||
Collection of recipes showing how to achieve more control over distutils.
|
Collection of recipes showing how to achieve more control over distutils.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -28,7 +28,7 @@ the package into Python 1.5.2.) ::
|
||||||
description='Python Distribution Utilities',
|
description='Python Distribution Utilities',
|
||||||
author='Greg Ward',
|
author='Greg Ward',
|
||||||
author_email='gward@python.net',
|
author_email='gward@python.net',
|
||||||
url='http://www.python.org/sigs/distutils-sig/',
|
url='https://www.python.org/sigs/distutils-sig/',
|
||||||
packages=['distutils', 'distutils.command'],
|
packages=['distutils', 'distutils.command'],
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -609,7 +609,7 @@ Notes:
|
||||||
(4)
|
(4)
|
||||||
These fields should not be used if your package is to be compatible with Python
|
These fields should not be used if your package is to be compatible with Python
|
||||||
versions prior to 2.2.3 or 2.3. The list is available from the `PyPI website
|
versions prior to 2.2.3 or 2.3. The list is available from the `PyPI website
|
||||||
<http://pypi.python.org/pypi>`_.
|
<https://pypi.python.org/pypi>`_.
|
||||||
|
|
||||||
(5)
|
(5)
|
||||||
The ``long_description`` field is used by PyPI when you are
|
The ``long_description`` field is used by PyPI when you are
|
||||||
|
|
|
@ -81,7 +81,7 @@ example below. ::
|
||||||
description = 'This is a demo package',
|
description = 'This is a demo package',
|
||||||
author = 'Martin v. Loewis',
|
author = 'Martin v. Loewis',
|
||||||
author_email = 'martin@v.loewis.de',
|
author_email = 'martin@v.loewis.de',
|
||||||
url = 'http://docs.python.org/extending/building',
|
url = 'https://docs.python.org/extending/building',
|
||||||
long_description = '''
|
long_description = '''
|
||||||
This is really just a demo package.
|
This is really just a demo package.
|
||||||
''',
|
''',
|
||||||
|
|
|
@ -386,13 +386,13 @@ mostly of calls into the Python run-time system, even for seemingly simple
|
||||||
operations like ``x+1``.
|
operations like ``x+1``.
|
||||||
|
|
||||||
Several projects described in the Python newsgroup or at past `Python
|
Several projects described in the Python newsgroup or at past `Python
|
||||||
conferences <http://python.org/community/workshops/>`_ have shown that this
|
conferences <https://www.python.org/community/workshops/>`_ have shown that this
|
||||||
approach is feasible, although the speedups reached so far are only modest
|
approach is feasible, although the speedups reached so far are only modest
|
||||||
(e.g. 2x). Jython uses the same strategy for compiling to Java bytecode. (Jim
|
(e.g. 2x). Jython uses the same strategy for compiling to Java bytecode. (Jim
|
||||||
Hugunin has demonstrated that in combination with whole-program analysis,
|
Hugunin has demonstrated that in combination with whole-program analysis,
|
||||||
speedups of 1000x are feasible for small demo programs. See the proceedings
|
speedups of 1000x are feasible for small demo programs. See the proceedings
|
||||||
from the `1997 Python conference
|
from the `1997 Python conference
|
||||||
<http://python.org/workshops/1997-10/proceedings/>`_ for more information.)
|
<https://www.python.org/workshops/1997-10/proceedings/>`_ for more information.)
|
||||||
|
|
||||||
|
|
||||||
How does Python manage memory?
|
How does Python manage memory?
|
||||||
|
|
|
@ -25,7 +25,7 @@ Finally, Python is portable: it runs on many Unix variants, on the Mac, and on
|
||||||
Windows 2000 and later.
|
Windows 2000 and later.
|
||||||
|
|
||||||
To find out more, start with :ref:`tutorial-index`. The `Beginner's Guide to
|
To find out more, start with :ref:`tutorial-index`. The `Beginner's Guide to
|
||||||
Python <http://wiki.python.org/moin/BeginnersGuide>`_ links to other
|
Python <https://wiki.python.org/moin/BeginnersGuide>`_ links to other
|
||||||
introductory tutorials and resources for learning Python.
|
introductory tutorials and resources for learning Python.
|
||||||
|
|
||||||
|
|
||||||
|
@ -36,11 +36,11 @@ The Python Software Foundation is an independent non-profit organization that
|
||||||
holds the copyright on Python versions 2.1 and newer. The PSF's mission is to
|
holds the copyright on Python versions 2.1 and newer. The PSF's mission is to
|
||||||
advance open source technology related to the Python programming language and to
|
advance open source technology related to the Python programming language and to
|
||||||
publicize the use of Python. The PSF's home page is at
|
publicize the use of Python. The PSF's home page is at
|
||||||
http://www.python.org/psf/.
|
https://www.python.org/psf/.
|
||||||
|
|
||||||
Donations to the PSF are tax-exempt in the US. If you use Python and find it
|
Donations to the PSF are tax-exempt in the US. If you use Python and find it
|
||||||
helpful, please contribute via `the PSF donation page
|
helpful, please contribute via `the PSF donation page
|
||||||
<http://www.python.org/psf/donations/>`_.
|
<https://www.python.org/psf/donations/>`_.
|
||||||
|
|
||||||
|
|
||||||
Are there copyright restrictions on the use of Python?
|
Are there copyright restrictions on the use of Python?
|
||||||
|
@ -53,12 +53,12 @@ commercial use, to sell copies of Python in source or binary form (modified or
|
||||||
unmodified), or to sell products that incorporate Python in some form. We would
|
unmodified), or to sell products that incorporate Python in some form. We would
|
||||||
still like to know about all commercial use of Python, of course.
|
still like to know about all commercial use of Python, of course.
|
||||||
|
|
||||||
See `the PSF license page <http://python.org/psf/license/>`_ to find further
|
See `the PSF license page <https://www.python.org/psf/license/>`_ to find further
|
||||||
explanations and a link to the full text of the license.
|
explanations and a link to the full text of the license.
|
||||||
|
|
||||||
The Python logo is trademarked, and in certain cases permission is required to
|
The Python logo is trademarked, and in certain cases permission is required to
|
||||||
use it. Consult `the Trademark Usage Policy
|
use it. Consult `the Trademark Usage Policy
|
||||||
<http://www.python.org/psf/trademarks/>`__ for more information.
|
<https://www.python.org/psf/trademarks/>`__ for more information.
|
||||||
|
|
||||||
|
|
||||||
Why was Python created in the first place?
|
Why was Python created in the first place?
|
||||||
|
@ -117,7 +117,7 @@ programming), software engineering (unit testing, logging, profiling, parsing
|
||||||
Python code), and operating system interfaces (system calls, filesystems, TCP/IP
|
Python code), and operating system interfaces (system calls, filesystems, TCP/IP
|
||||||
sockets). Look at the table of contents for :ref:`library-index` to get an idea
|
sockets). Look at the table of contents for :ref:`library-index` to get an idea
|
||||||
of what's available. A wide variety of third-party extensions are also
|
of what's available. A wide variety of third-party extensions are also
|
||||||
available. Consult `the Python Package Index <http://pypi.python.org/pypi>`_ to
|
available. Consult `the Python Package Index <https://pypi.python.org/pypi>`_ to
|
||||||
find packages of interest to you.
|
find packages of interest to you.
|
||||||
|
|
||||||
|
|
||||||
|
@ -159,8 +159,8 @@ How do I obtain a copy of the Python source?
|
||||||
--------------------------------------------
|
--------------------------------------------
|
||||||
|
|
||||||
The latest Python source distribution is always available from python.org, at
|
The latest Python source distribution is always available from python.org, at
|
||||||
http://www.python.org/download/. The latest development sources can be obtained
|
https://www.python.org/download/. The latest development sources can be obtained
|
||||||
via anonymous Mercurial access at http://hg.python.org/cpython.
|
via anonymous Mercurial access at https://hg.python.org/cpython.
|
||||||
|
|
||||||
The source distribution is a gzipped tar file containing the complete C source,
|
The source distribution is a gzipped tar file containing the complete C source,
|
||||||
Sphinx-formatted documentation, Python library modules, example programs, and
|
Sphinx-formatted documentation, Python library modules, example programs, and
|
||||||
|
@ -178,8 +178,8 @@ How do I get documentation on Python?
|
||||||
.. XXX mention py3k
|
.. XXX mention py3k
|
||||||
|
|
||||||
The standard documentation for the current stable version of Python is available
|
The standard documentation for the current stable version of Python is available
|
||||||
at http://docs.python.org/. PDF, plain text, and downloadable HTML versions are
|
at https://docs.python.org/. PDF, plain text, and downloadable HTML versions are
|
||||||
also available at http://docs.python.org/download.html.
|
also available at https://docs.python.org/download.html.
|
||||||
|
|
||||||
The documentation is written in reStructuredText and processed by `the Sphinx
|
The documentation is written in reStructuredText and processed by `the Sphinx
|
||||||
documentation tool <http://sphinx-doc.org/>`__. The reStructuredText source for
|
documentation tool <http://sphinx-doc.org/>`__. The reStructuredText source for
|
||||||
|
@ -192,7 +192,7 @@ I've never programmed before. Is there a Python tutorial?
|
||||||
There are numerous tutorials and books available. The standard documentation
|
There are numerous tutorials and books available. The standard documentation
|
||||||
includes :ref:`tutorial-index`.
|
includes :ref:`tutorial-index`.
|
||||||
|
|
||||||
Consult `the Beginner's Guide <http://wiki.python.org/moin/BeginnersGuide>`_ to
|
Consult `the Beginner's Guide <https://wiki.python.org/moin/BeginnersGuide>`_ to
|
||||||
find information for beginning Python programmers, including lists of tutorials.
|
find information for beginning Python programmers, including lists of tutorials.
|
||||||
|
|
||||||
|
|
||||||
|
@ -212,35 +212,35 @@ postings per day. It's available as `the python-announce mailing list
|
||||||
<http://mail.python.org/mailman/listinfo/python-announce-list>`_.
|
<http://mail.python.org/mailman/listinfo/python-announce-list>`_.
|
||||||
|
|
||||||
More info about other mailing lists and newsgroups
|
More info about other mailing lists and newsgroups
|
||||||
can be found at http://www.python.org/community/lists/.
|
can be found at https://www.python.org/community/lists/.
|
||||||
|
|
||||||
|
|
||||||
How do I get a beta test version of Python?
|
How do I get a beta test version of Python?
|
||||||
-------------------------------------------
|
-------------------------------------------
|
||||||
|
|
||||||
Alpha and beta releases are available from http://www.python.org/download/. All
|
Alpha and beta releases are available from https://www.python.org/download/. All
|
||||||
releases are announced on the comp.lang.python and comp.lang.python.announce
|
releases are announced on the comp.lang.python and comp.lang.python.announce
|
||||||
newsgroups and on the Python home page at http://www.python.org/; an RSS feed of
|
newsgroups and on the Python home page at https://www.python.org/; an RSS feed of
|
||||||
news is available.
|
news is available.
|
||||||
|
|
||||||
You can also access the development version of Python through Subversion. See
|
You can also access the development version of Python through Subversion. See
|
||||||
http://docs.python.org/devguide/faq for details.
|
https://docs.python.org/devguide/faq for details.
|
||||||
|
|
||||||
|
|
||||||
How do I submit bug reports and patches for Python?
|
How do I submit bug reports and patches for Python?
|
||||||
---------------------------------------------------
|
---------------------------------------------------
|
||||||
|
|
||||||
To report a bug or submit a patch, please use the Roundup installation at
|
To report a bug or submit a patch, please use the Roundup installation at
|
||||||
http://bugs.python.org/.
|
https://bugs.python.org/.
|
||||||
|
|
||||||
You must have a Roundup account to report bugs; this makes it possible for us to
|
You must have a Roundup account to report bugs; this makes it possible for us to
|
||||||
contact you if we have follow-up questions. It will also enable Roundup to send
|
contact you if we have follow-up questions. It will also enable Roundup to send
|
||||||
you updates as we act on your bug. If you had previously used SourceForge to
|
you updates as we act on your bug. If you had previously used SourceForge to
|
||||||
report bugs to Python, you can obtain your Roundup password through Roundup's
|
report bugs to Python, you can obtain your Roundup password through Roundup's
|
||||||
`password reset procedure <http://bugs.python.org/user?@template=forgotten>`_.
|
`password reset procedure <https://bugs.python.org/user?@template=forgotten>`_.
|
||||||
|
|
||||||
For more information on how Python is developed, consult `the Python Developer's
|
For more information on how Python is developed, consult `the Python Developer's
|
||||||
Guide <http://docs.python.org/devguide/>`_.
|
Guide <https://docs.python.org/devguide/>`_.
|
||||||
|
|
||||||
|
|
||||||
Are there any published articles about Python that I can reference?
|
Are there any published articles about Python that I can reference?
|
||||||
|
@ -260,7 +260,7 @@ Are there any books on Python?
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
||||||
Yes, there are many, and more are being published. See the python.org wiki at
|
Yes, there are many, and more are being published. See the python.org wiki at
|
||||||
http://wiki.python.org/moin/PythonBooks for a list.
|
https://wiki.python.org/moin/PythonBooks for a list.
|
||||||
|
|
||||||
You can also search online bookstores for "Python" and filter out the Monty
|
You can also search online bookstores for "Python" and filter out the Monty
|
||||||
Python references; or perhaps search for "Python" and "language".
|
Python references; or perhaps search for "Python" and "language".
|
||||||
|
@ -270,10 +270,10 @@ Where in the world is www.python.org located?
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
The Python project's infrastructure is located all over the world.
|
The Python project's infrastructure is located all over the world.
|
||||||
`www.python.org <http://www.python.org>`_ is currently in Amsterdam, graciously
|
`www.python.org <https://www.python.org>`_ is currently in Amsterdam, graciously
|
||||||
hosted by `XS4ALL <http://www.xs4all.nl>`_. `Upfront Systems
|
hosted by `XS4ALL <http://www.xs4all.nl>`_. `Upfront Systems
|
||||||
<http://www.upfrontsystems.co.za>`_ hosts `bugs.python.org
|
<http://www.upfrontsystems.co.za>`_ hosts `bugs.python.org
|
||||||
<http://bugs.python.org>`_. Most other Python services like `PyPI
|
<https://bugs.python.org>`_. Most other Python services like `PyPI
|
||||||
<https://pypi.python.org>`_ and hg.python.org are hosted by `Oregon State
|
<https://pypi.python.org>`_ and hg.python.org are hosted by `Oregon State
|
||||||
University Open Source Lab <https://osuosl.org>`_.
|
University Open Source Lab <https://osuosl.org>`_.
|
||||||
|
|
||||||
|
@ -312,7 +312,7 @@ guaranteed that interfaces will remain the same throughout a series of bugfix
|
||||||
releases.
|
releases.
|
||||||
|
|
||||||
The latest stable releases can always be found on the `Python download page
|
The latest stable releases can always be found on the `Python download page
|
||||||
<http://python.org/download/>`_. There are two recommended production-ready
|
<https://python.org/download/>`_. There are two recommended production-ready
|
||||||
versions at this point in time, because at the moment there are two branches of
|
versions at this point in time, because at the moment there are two branches of
|
||||||
stable releases: 2.x and 3.x. Python 3.x may be less useful than 2.x, since
|
stable releases: 2.x and 3.x. Python 3.x may be less useful than 2.x, since
|
||||||
currently there is more third party software available for Python 2 than for
|
currently there is more third party software available for Python 2 than for
|
||||||
|
@ -336,9 +336,9 @@ the group or even read it.
|
||||||
Have any significant projects been done in Python?
|
Have any significant projects been done in Python?
|
||||||
--------------------------------------------------
|
--------------------------------------------------
|
||||||
|
|
||||||
See http://python.org/about/success for a list of projects that use Python.
|
See https://python.org/about/success for a list of projects that use Python.
|
||||||
Consulting the proceedings for `past Python conferences
|
Consulting the proceedings for `past Python conferences
|
||||||
<http://python.org/community/workshops/>`_ will reveal contributions from many
|
<https://python.org/community/workshops/>`_ will reveal contributions from many
|
||||||
different companies and organizations.
|
different companies and organizations.
|
||||||
|
|
||||||
High-profile Python projects include `the Mailman mailing list manager
|
High-profile Python projects include `the Mailman mailing list manager
|
||||||
|
@ -352,14 +352,14 @@ include Google, Yahoo, and Lucasfilm Ltd.
|
||||||
What new developments are expected for Python in the future?
|
What new developments are expected for Python in the future?
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
|
|
||||||
See http://www.python.org/dev/peps/ for the Python Enhancement Proposals
|
See https://www.python.org/dev/peps/ for the Python Enhancement Proposals
|
||||||
(PEPs). PEPs are design documents describing a suggested new feature for Python,
|
(PEPs). PEPs are design documents describing a suggested new feature for Python,
|
||||||
providing a concise technical specification and a rationale. Look for a PEP
|
providing a concise technical specification and a rationale. Look for a PEP
|
||||||
titled "Python X.Y Release Schedule", where X.Y is a version that hasn't been
|
titled "Python X.Y Release Schedule", where X.Y is a version that hasn't been
|
||||||
publicly released yet.
|
publicly released yet.
|
||||||
|
|
||||||
New development is discussed on `the python-dev mailing list
|
New development is discussed on `the python-dev mailing list
|
||||||
<http://mail.python.org/mailman/listinfo/python-dev/>`_.
|
<https://mail.python.org/mailman/listinfo/python-dev/>`_.
|
||||||
|
|
||||||
|
|
||||||
Is it reasonable to propose incompatible changes to Python?
|
Is it reasonable to propose incompatible changes to Python?
|
||||||
|
@ -451,4 +451,4 @@ of Python editing environments.
|
||||||
|
|
||||||
If you want to discuss Python's use in education, you may be interested in
|
If you want to discuss Python's use in education, you may be interested in
|
||||||
joining `the edu-sig mailing list
|
joining `the edu-sig mailing list
|
||||||
<http://python.org/community/sigs/current/edu-sig>`_.
|
<https://www.python.org/community/sigs/current/edu-sig>`_.
|
||||||
|
|
|
@ -29,7 +29,7 @@ Tkinter
|
||||||
Standard builds of Python include an object-oriented interface to the Tcl/Tk
|
Standard builds of Python include an object-oriented interface to the Tcl/Tk
|
||||||
widget set, called :ref:`tkinter <Tkinter>`. This is probably the easiest to
|
widget set, called :ref:`tkinter <Tkinter>`. This is probably the easiest to
|
||||||
install (since it comes included with most
|
install (since it comes included with most
|
||||||
`binary distributions <http://www.python.org/download/>`_ of Python) and use.
|
`binary distributions <https://www.python.org/download/>`_ of Python) and use.
|
||||||
For more info about Tk, including pointers to the source, see the
|
For more info about Tk, including pointers to the source, see the
|
||||||
`Tcl/Tk home page <http://www.tcl.tk>`_. Tcl/Tk is fully portable to the
|
`Tcl/Tk home page <http://www.tcl.tk>`_. Tcl/Tk is fully portable to the
|
||||||
Mac OS X, Windows, and Unix platforms.
|
Mac OS X, Windows, and Unix platforms.
|
||||||
|
|
|
@ -11,7 +11,7 @@ language because Python is easy to learn, but it's also used by professional
|
||||||
software developers at places such as Google, NASA, and Lucasfilm Ltd.
|
software developers at places such as Google, NASA, and Lucasfilm Ltd.
|
||||||
|
|
||||||
If you wish to learn more about Python, start with the `Beginner's Guide to
|
If you wish to learn more about Python, start with the `Beginner's Guide to
|
||||||
Python <http://wiki.python.org/moin/BeginnersGuide>`_.
|
Python <https://wiki.python.org/moin/BeginnersGuide>`_.
|
||||||
|
|
||||||
|
|
||||||
Why is Python installed on my machine?
|
Why is Python installed on my machine?
|
||||||
|
|
|
@ -19,7 +19,7 @@ standard library module. (Eventually you'll learn what's in the standard
|
||||||
library and will be able to skip this step.)
|
library and will be able to skip this step.)
|
||||||
|
|
||||||
For third-party packages, search the `Python Package Index
|
For third-party packages, search the `Python Package Index
|
||||||
<http://pypi.python.org/pypi>`_ or try `Google <http://www.google.com>`_ or
|
<https://pypi.python.org/pypi>`_ or try `Google <https://www.google.com>`_ or
|
||||||
another Web search engine. Searching for "Python" plus a keyword or two for
|
another Web search engine. Searching for "Python" plus a keyword or two for
|
||||||
your topic of interest will usually find something helpful.
|
your topic of interest will usually find something helpful.
|
||||||
|
|
||||||
|
@ -607,7 +607,7 @@ use ``p.read(n)``.
|
||||||
"expect" library. A Python extension that interfaces to expect is called
|
"expect" library. A Python extension that interfaces to expect is called
|
||||||
"expy" and available from http://expectpy.sourceforge.net. A pure Python
|
"expy" and available from http://expectpy.sourceforge.net. A pure Python
|
||||||
solution that works like expect is `pexpect
|
solution that works like expect is `pexpect
|
||||||
<http://pypi.python.org/pypi/pexpect/>`_.
|
<https://pypi.python.org/pypi/pexpect/>`_.
|
||||||
|
|
||||||
|
|
||||||
How do I access the serial (RS232) port?
|
How do I access the serial (RS232) port?
|
||||||
|
@ -663,7 +663,7 @@ and client-side web systems.
|
||||||
.. XXX check if wiki page is still up to date
|
.. XXX check if wiki page is still up to date
|
||||||
|
|
||||||
A summary of available frameworks is maintained by Paul Boddie at
|
A summary of available frameworks is maintained by Paul Boddie at
|
||||||
http://wiki.python.org/moin/WebProgramming\ .
|
https://wiki.python.org/moin/WebProgramming\ .
|
||||||
|
|
||||||
Cameron Laird maintains a useful set of pages about Python web technologies at
|
Cameron Laird maintains a useful set of pages about Python web technologies at
|
||||||
http://phaseit.net/claird/comp.lang.python/web_python.
|
http://phaseit.net/claird/comp.lang.python/web_python.
|
||||||
|
@ -706,7 +706,7 @@ What module should I use to help with generating HTML?
|
||||||
.. XXX add modern template languages
|
.. XXX add modern template languages
|
||||||
|
|
||||||
You can find a collection of useful links on the `Web Programming wiki page
|
You can find a collection of useful links on the `Web Programming wiki page
|
||||||
<http://wiki.python.org/moin/WebProgramming>`_.
|
<https://wiki.python.org/moin/WebProgramming>`_.
|
||||||
|
|
||||||
|
|
||||||
How do I send mail from a Python script?
|
How do I send mail from a Python script?
|
||||||
|
@ -792,7 +792,7 @@ database.
|
||||||
|
|
||||||
Support for most relational databases is available. See the
|
Support for most relational databases is available. See the
|
||||||
`DatabaseProgramming wiki page
|
`DatabaseProgramming wiki page
|
||||||
<http://wiki.python.org/moin/DatabaseProgramming>`_ for details.
|
<https://wiki.python.org/moin/DatabaseProgramming>`_ for details.
|
||||||
|
|
||||||
|
|
||||||
How do you implement persistent objects in Python?
|
How do you implement persistent objects in Python?
|
||||||
|
|
|
@ -1020,7 +1020,7 @@ performance levels:
|
||||||
as builtins and some extension types. For example, be sure to use
|
as builtins and some extension types. For example, be sure to use
|
||||||
either the :meth:`list.sort` built-in method or the related :func:`sorted`
|
either the :meth:`list.sort` built-in method or the related :func:`sorted`
|
||||||
function to do sorting (and see the
|
function to do sorting (and see the
|
||||||
`sorting mini-HOWTO <http://wiki.python.org/moin/HowTo/Sorting>`_ for examples
|
`sorting mini-HOWTO <https://wiki.python.org/moin/HowTo/Sorting>`_ for examples
|
||||||
of moderately advanced usage).
|
of moderately advanced usage).
|
||||||
|
|
||||||
* Abstractions tend to create indirections and force the interpreter to work
|
* Abstractions tend to create indirections and force the interpreter to work
|
||||||
|
@ -1040,7 +1040,7 @@ yourself.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
The wiki page devoted to `performance tips
|
The wiki page devoted to `performance tips
|
||||||
<http://wiki.python.org/moin/PythonSpeed/PerformanceTips>`_.
|
<https://wiki.python.org/moin/PythonSpeed/PerformanceTips>`_.
|
||||||
|
|
||||||
.. _efficient_string_concatenation:
|
.. _efficient_string_concatenation:
|
||||||
|
|
||||||
|
|
|
@ -76,7 +76,7 @@ Glossary
|
||||||
|
|
||||||
BDFL
|
BDFL
|
||||||
Benevolent Dictator For Life, a.k.a. `Guido van Rossum
|
Benevolent Dictator For Life, a.k.a. `Guido van Rossum
|
||||||
<http://www.python.org/~guido/>`_, Python's creator.
|
<https://www.python.org/~guido/>`_, Python's creator.
|
||||||
|
|
||||||
binary file
|
binary file
|
||||||
A :term:`file object` able to read and write
|
A :term:`file object` able to read and write
|
||||||
|
@ -141,7 +141,7 @@ Glossary
|
||||||
|
|
||||||
CPython
|
CPython
|
||||||
The canonical implementation of the Python programming language, as
|
The canonical implementation of the Python programming language, as
|
||||||
distributed on `python.org <http://python.org>`_. The term "CPython"
|
distributed on `python.org <https://www.python.org>`_. The term "CPython"
|
||||||
is used when necessary to distinguish this implementation from others
|
is used when necessary to distinguish this implementation from others
|
||||||
such as Jython or IronPython.
|
such as Jython or IronPython.
|
||||||
|
|
||||||
|
@ -531,7 +531,7 @@ Glossary
|
||||||
method resolution order
|
method resolution order
|
||||||
Method Resolution Order is the order in which base classes are searched
|
Method Resolution Order is the order in which base classes are searched
|
||||||
for a member during lookup. See `The Python 2.3 Method Resolution Order
|
for a member during lookup. See `The Python 2.3 Method Resolution Order
|
||||||
<http://www.python.org/download/releases/2.3/mro/>`_.
|
<https://www.python.org/download/releases/2.3/mro/>`_.
|
||||||
|
|
||||||
module
|
module
|
||||||
An object that serves as an organizational unit of Python code. Modules
|
An object that serves as an organizational unit of Python code. Modules
|
||||||
|
|
|
@ -538,7 +538,7 @@ the Python interface. Often this isn't because they're difficult to
|
||||||
implement, but because no one has needed them yet. Also, Python
|
implement, but because no one has needed them yet. Also, Python
|
||||||
doesn't yet support the menu library associated with ncurses.
|
doesn't yet support the menu library associated with ncurses.
|
||||||
Patches adding support for these would be welcome; see
|
Patches adding support for these would be welcome; see
|
||||||
`the Python Developer's Guide <http://docs.python.org/devguide/>`_ to
|
`the Python Developer's Guide <https://docs.python.org/devguide/>`_ to
|
||||||
learn more about submitting patches to Python.
|
learn more about submitting patches to Python.
|
||||||
|
|
||||||
* `Writing Programs with NCURSES <http://invisible-island.net/ncurses/ncurses-intro.html>`_:
|
* `Writing Programs with NCURSES <http://invisible-island.net/ncurses/ncurses-intro.html>`_:
|
||||||
|
|
|
@ -127,7 +127,7 @@ The implementation details are in :c:func:`super_getattro()` in
|
||||||
:source:`Objects/typeobject.c`. and a pure Python equivalent can be found in
|
:source:`Objects/typeobject.c`. and a pure Python equivalent can be found in
|
||||||
`Guido's Tutorial`_.
|
`Guido's Tutorial`_.
|
||||||
|
|
||||||
.. _`Guido's Tutorial`: http://www.python.org/2.2.3/descrintro.html#cooperation
|
.. _`Guido's Tutorial`: https://www.python.org/2.2.3/descrintro.html#cooperation
|
||||||
|
|
||||||
The details above show that the mechanism for descriptors is embedded in the
|
The details above show that the mechanism for descriptors is embedded in the
|
||||||
:meth:`__getattribute__()` methods for :class:`object`, :class:`type`, and
|
:meth:`__getattribute__()` methods for :class:`object`, :class:`type`, and
|
||||||
|
|
|
@ -649,7 +649,7 @@ file from your processes. The existing :class:`FileHandler` and subclasses do
|
||||||
not make use of :mod:`multiprocessing` at present, though they may do so in the
|
not make use of :mod:`multiprocessing` at present, though they may do so in the
|
||||||
future. Note that at present, the :mod:`multiprocessing` module does not provide
|
future. Note that at present, the :mod:`multiprocessing` module does not provide
|
||||||
working lock functionality on all platforms (see
|
working lock functionality on all platforms (see
|
||||||
http://bugs.python.org/issue3770).
|
https://bugs.python.org/issue3770).
|
||||||
|
|
||||||
.. currentmodule:: logging.handlers
|
.. currentmodule:: logging.handlers
|
||||||
|
|
||||||
|
|
|
@ -588,7 +588,7 @@ thanks for making public their tips for porting Python 2 code to Python 3 (and
|
||||||
thus helping provide information for this document and its various revisions
|
thus helping provide information for this document and its various revisions
|
||||||
over the years):
|
over the years):
|
||||||
|
|
||||||
* http://wiki.python.org/moin/PortingPythonToPy3k
|
* https://wiki.python.org/moin/PortingPythonToPy3k
|
||||||
* http://python3porting.com/
|
* http://python3porting.com/
|
||||||
* http://docs.pythonsprints.com/python3_porting/py-porting.html
|
* http://docs.pythonsprints.com/python3_porting/py-porting.html
|
||||||
* http://techspot.zzzeek.org/2011/01/24/zzzeek-s-guide-to-python-3-porting/
|
* http://techspot.zzzeek.org/2011/01/24/zzzeek-s-guide-to-python-3-porting/
|
||||||
|
@ -602,23 +602,23 @@ please email the python-porting_ mailing list.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
.. _2to3: http://docs.python.org/2/library/2to3.html
|
.. _2to3: https://docs.python.org/2/library/2to3.html
|
||||||
.. _3to2: https://pypi.python.org/pypi/3to2
|
.. _3to2: https://pypi.python.org/pypi/3to2
|
||||||
.. _Cheeseshop: PyPI_
|
.. _Cheeseshop: PyPI_
|
||||||
.. _coverage: https://pypi.python.org/pypi/coverage
|
.. _coverage: https://pypi.python.org/pypi/coverage
|
||||||
.. _future: http://python-future.org/
|
.. _future: http://python-future.org/
|
||||||
.. _modernize: https://github.com/mitsuhiko/python-modernize
|
.. _modernize: https://github.com/mitsuhiko/python-modernize
|
||||||
.. _Porting to Python 3: http://python3porting.com/
|
.. _Porting to Python 3: http://python3porting.com/
|
||||||
.. _PyPI: http://pypi.python.org/
|
.. _PyPI: https://pypi.python.org/
|
||||||
.. _Python 2.2: http://www.python.org/2.2.x
|
.. _Python 2.2: https://www.python.org/2.2.x
|
||||||
.. _Python 2.5: http://www.python.org/2.5.x
|
.. _Python 2.5: https://www.python.org/2.5.x
|
||||||
.. _Python 2.6: http://www.python.org/2.6.x
|
.. _Python 2.6: https://www.python.org/2.6.x
|
||||||
.. _Python 2.7: http://www.python.org/2.7.x
|
.. _Python 2.7: https://www.python.org/2.7.x
|
||||||
.. _Python 2.5: http://www.python.org/2.5.x
|
.. _Python 2.5: https://www.python.org/2.5.x
|
||||||
.. _Python 3.3: http://www.python.org/3.3.x
|
.. _Python 3.3: https://www.python.org/3.3.x
|
||||||
.. _Python 3 Packages: https://pypi.python.org/pypi?:action=browse&c=533&show=all
|
.. _Python 3 Packages: https://pypi.python.org/pypi?:action=browse&c=533&show=all
|
||||||
.. _Python 3 Q & A: http://ncoghlan-devs-python-notes.readthedocs.org/en/latest/python3/questions_and_answers.html
|
.. _Python 3 Q & A: http://ncoghlan-devs-python-notes.readthedocs.org/en/latest/python3/questions_and_answers.html
|
||||||
.. _python-porting: http://mail.python.org/mailman/listinfo/python-porting
|
.. _python-porting: https://mail.python.org/mailman/listinfo/python-porting
|
||||||
.. _six: https://pypi.python.org/pypi/six
|
.. _six: https://pypi.python.org/pypi/six
|
||||||
.. _tox: https://pypi.python.org/pypi/tox
|
.. _tox: https://pypi.python.org/pypi/tox
|
||||||
.. _trove classifiers: https://pypi.python.org/pypi?%3Aaction=list_classifiers
|
.. _trove classifiers: https://pypi.python.org/pypi?%3Aaction=list_classifiers
|
||||||
|
|
|
@ -26,7 +26,7 @@ Introduction
|
||||||
|
|
||||||
A tutorial on *Basic Authentication*, with examples in Python.
|
A tutorial on *Basic Authentication*, with examples in Python.
|
||||||
|
|
||||||
**urllib.request** is a `Python <http://www.python.org>`_ module for fetching URLs
|
**urllib.request** is a Python module for fetching URLs
|
||||||
(Uniform Resource Locators). It offers a very simple interface, in the form of
|
(Uniform Resource Locators). It offers a very simple interface, in the form of
|
||||||
the *urlopen* function. This is capable of fetching URLs using a variety of
|
the *urlopen* function. This is capable of fetching URLs using a variety of
|
||||||
different protocols. It also offers a slightly more complex interface for
|
different protocols. It also offers a slightly more complex interface for
|
||||||
|
|
|
@ -26,7 +26,7 @@ of the most popular libraries is provided.
|
||||||
While this HOWTO tries to give an overview of Python in the web, it cannot
|
While this HOWTO tries to give an overview of Python in the web, it cannot
|
||||||
always be as up to date as desired. Web development in Python is rapidly
|
always be as up to date as desired. Web development in Python is rapidly
|
||||||
moving forward, so the wiki page on `Web Programming
|
moving forward, so the wiki page on `Web Programming
|
||||||
<http://wiki.python.org/moin/WebProgramming>`_ may be more in sync with
|
<https://wiki.python.org/moin/WebProgramming>`_ may be more in sync with
|
||||||
recent development.
|
recent development.
|
||||||
|
|
||||||
|
|
||||||
|
@ -86,7 +86,7 @@ available.
|
||||||
applications, instead of presenting a "500 Internal Server Error" message
|
applications, instead of presenting a "500 Internal Server Error" message
|
||||||
|
|
||||||
The Python wiki features a page on `CGI scripts
|
The Python wiki features a page on `CGI scripts
|
||||||
<http://wiki.python.org/moin/CgiScripts>`_ with some additional information
|
<https://wiki.python.org/moin/CgiScripts>`_ with some additional information
|
||||||
about CGI in Python.
|
about CGI in Python.
|
||||||
|
|
||||||
|
|
||||||
|
@ -309,7 +309,7 @@ following WSGI-application::
|
||||||
WSGIServer(app).run()
|
WSGIServer(app).run()
|
||||||
|
|
||||||
This is a simple WSGI application, but you need to install `flup
|
This is a simple WSGI application, but you need to install `flup
|
||||||
<http://pypi.python.org/pypi/flup/1.0>`_ first, as flup handles the low level
|
<https://pypi.python.org/pypi/flup/1.0>`_ first, as flup handles the low level
|
||||||
FastCGI access.
|
FastCGI access.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
@ -486,7 +486,7 @@ developing a web site.
|
||||||
|
|
||||||
There are far more components than can be presented here. The Python wiki
|
There are far more components than can be presented here. The Python wiki
|
||||||
has a page about these components, called
|
has a page about these components, called
|
||||||
`Web Components <http://wiki.python.org/moin/WebComponents>`_.
|
`Web Components <https://wiki.python.org/moin/WebComponents>`_.
|
||||||
|
|
||||||
|
|
||||||
Templates
|
Templates
|
||||||
|
@ -528,7 +528,7 @@ Popular template engines include:
|
||||||
|
|
||||||
There are many template engines competing for attention, because it is
|
There are many template engines competing for attention, because it is
|
||||||
pretty easy to create them in Python. The page `Templating
|
pretty easy to create them in Python. The page `Templating
|
||||||
<http://wiki.python.org/moin/Templating>`_ in the wiki lists a big,
|
<https://wiki.python.org/moin/Templating>`_ in the wiki lists a big,
|
||||||
ever-growing number of these. The three listed above are considered "second
|
ever-growing number of these. The three listed above are considered "second
|
||||||
generation" template engines and are a good place to start.
|
generation" template engines and are a good place to start.
|
||||||
|
|
||||||
|
@ -578,11 +578,11 @@ alternate storage mechanism.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
* `Persistence Tools <http://wiki.python.org/moin/PersistenceTools>`_ lists
|
* `Persistence Tools <https://wiki.python.org/moin/PersistenceTools>`_ lists
|
||||||
possibilities on how to save data in the file system. Some of these
|
possibilities on how to save data in the file system. Some of these
|
||||||
modules are part of the standard library
|
modules are part of the standard library
|
||||||
|
|
||||||
* `Database Programming <http://wiki.python.org/moin/DatabaseProgramming>`_
|
* `Database Programming <https://wiki.python.org/moin/DatabaseProgramming>`_
|
||||||
helps with choosing a method for saving data
|
helps with choosing a method for saving data
|
||||||
|
|
||||||
* `SQLAlchemy <http://www.sqlalchemy.org/>`_, the most powerful OR-Mapper
|
* `SQLAlchemy <http://www.sqlalchemy.org/>`_, the most powerful OR-Mapper
|
||||||
|
@ -732,9 +732,9 @@ found in the Python wiki.
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
The Python wiki contains an extensive list of `web frameworks
|
The Python wiki contains an extensive list of `web frameworks
|
||||||
<http://wiki.python.org/moin/WebFrameworks>`_.
|
<https://wiki.python.org/moin/WebFrameworks>`_.
|
||||||
|
|
||||||
Most frameworks also have their own mailing lists and IRC channels, look out
|
Most frameworks also have their own mailing lists and IRC channels, look out
|
||||||
for these on the projects' web sites. There is also a general "Python in the
|
for these on the projects' web sites. There is also a general "Python in the
|
||||||
Web" IRC channel on freenode called `#python.web
|
Web" IRC channel on freenode called `#python.web
|
||||||
<http://wiki.python.org/moin/PoundPythonWeb>`_.
|
<https://wiki.python.org/moin/PoundPythonWeb>`_.
|
||||||
|
|
|
@ -17,14 +17,14 @@ msg['From'] = me
|
||||||
msg['To'] = you
|
msg['To'] = you
|
||||||
|
|
||||||
# Create the body of the message (a plain-text and an HTML version).
|
# Create the body of the message (a plain-text and an HTML version).
|
||||||
text = "Hi!\nHow are you?\nHere is the link you wanted:\nhttp://www.python.org"
|
text = "Hi!\nHow are you?\nHere is the link you wanted:\nhttps://www.python.org"
|
||||||
html = """\
|
html = """\
|
||||||
<html>
|
<html>
|
||||||
<head></head>
|
<head></head>
|
||||||
<body>
|
<body>
|
||||||
<p>Hi!<br>
|
<p>Hi!<br>
|
||||||
How are you?<br>
|
How are you?<br>
|
||||||
Here is the <a href="http://www.python.org">link</a> you wanted.
|
Here is the <a href="https://www.python.org">link</a> you wanted.
|
||||||
</p>
|
</p>
|
||||||
</body>
|
</body>
|
||||||
</html>
|
</html>
|
||||||
|
|
|
@ -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
|
||||||
<http://packaging.python.org/en/latest/future.html>`__ are the group of
|
<https://packaging.python.org/en/latest/future.html>`__ 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
|
||||||
|
@ -96,7 +96,7 @@ explicitly::
|
||||||
python -m pip install --upgrade SomePackage
|
python -m pip install --upgrade SomePackage
|
||||||
|
|
||||||
More information and resources regarding ``pip`` and its capabilities can be
|
More information and resources regarding ``pip`` and its capabilities can be
|
||||||
found in the `Python Packaging User Guide <http://packaging.python.org>`__.
|
found in the `Python Packaging User Guide <https://packaging.python.org>`__.
|
||||||
|
|
||||||
``pyvenv`` has its own documentation at :ref:`scripts-pyvenv`. Installing
|
``pyvenv`` has its own documentation at :ref:`scripts-pyvenv`. Installing
|
||||||
into an active virtual environment uses the commands shown above.
|
into an active virtual environment uses the commands shown above.
|
||||||
|
@ -141,13 +141,13 @@ A number of scientific Python packages have complex binary dependencies, and
|
||||||
aren't currently easy to install using ``pip`` directly. At this point in
|
aren't currently easy to install using ``pip`` directly. At this point in
|
||||||
time, it will often be easier for users to install these packages by
|
time, it will often be easier for users to install these packages by
|
||||||
`other means
|
`other means
|
||||||
<http://packaging.python.org/en/latest/platforms.html#installing-scientific-packages>`__
|
<https://packaging.python.org/en/latest/platforms.html#installing-scientific-packages>`__
|
||||||
rather than attempting to install them with ``pip``.
|
rather than attempting to install them with ``pip``.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Python Packaging User Guide: Installing Scientific Packages
|
`Python Packaging User Guide: Installing Scientific Packages
|
||||||
<http://packaging.python.org/en/latest/platforms.html#installing-scientific-packages>`__
|
<https://packaging.python.org/en/latest/platforms.html#installing-scientific-packages>`__
|
||||||
|
|
||||||
|
|
||||||
... work with multiple versions of Python installed in parallel?
|
... work with multiple versions of Python installed in parallel?
|
||||||
|
@ -177,7 +177,7 @@ switch::
|
||||||
Once the Development & Deployment part of PPUG is fleshed out, some of
|
Once the Development & Deployment part of PPUG is fleshed out, some of
|
||||||
those sections should be linked from new questions here (most notably,
|
those sections should be linked from new questions here (most notably,
|
||||||
we should have a question about avoiding depending on PyPI that links to
|
we should have a question about avoiding depending on PyPI that links to
|
||||||
http://packaging.python.org/en/latest/deployment.html#pypi-mirrors-and-caches)
|
https://packaging.python.org/en/latest/deployment.html#pypi-mirrors-and-caches)
|
||||||
|
|
||||||
|
|
||||||
Common installation issues
|
Common installation issues
|
||||||
|
@ -210,11 +210,11 @@ as users are more regularly able to install pre-built extensions rather
|
||||||
than needing to build them themselves.
|
than needing to build them themselves.
|
||||||
|
|
||||||
Some of the solutions for installing `scientific software
|
Some of the solutions for installing `scientific software
|
||||||
<http://packaging.python.org/en/latest/platforms.html#installing-scientific-packages>`__
|
<https://packaging.python.org/en/latest/platforms.html#installing-scientific-packages>`__
|
||||||
that is not yet available as pre-built ``wheel`` files may also help with
|
that is not yet available as pre-built ``wheel`` files may also help with
|
||||||
obtaining other binary extensions without needing to build them locally.
|
obtaining other binary extensions without needing to build them locally.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Python Packaging User Guide: Binary Extensions
|
`Python Packaging User Guide: Binary Extensions
|
||||||
<http://packaging.python.org/en/latest/extensions.html>`__
|
<https://packaging.python.org/en/latest/extensions.html>`__
|
||||||
|
|
|
@ -1691,7 +1691,7 @@ only EST (fixed offset -5 hours), or only EDT (fixed offset -4 hours)).
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`pytz <http://pypi.python.org/pypi/pytz/>`_
|
`pytz <https://pypi.python.org/pypi/pytz/>`_
|
||||||
The standard library has :class:`timezone` class for handling arbitrary
|
The standard library has :class:`timezone` class for handling arbitrary
|
||||||
fixed offsets from UTC and :attr:`timezone.utc` as UTC timezone instance.
|
fixed offsets from UTC and :attr:`timezone.utc` as UTC timezone instance.
|
||||||
|
|
||||||
|
|
|
@ -30,7 +30,7 @@ enhanced alternative to :mod:`distutils` that provides:
|
||||||
The recommended `pip <https://pip.pypa.io/>`__ installer runs all
|
The recommended `pip <https://pip.pypa.io/>`__ installer runs all
|
||||||
``setup.py`` scripts with ``setuptools``, even if the script itself only
|
``setup.py`` scripts with ``setuptools``, even if the script itself only
|
||||||
imports ``distutils``. Refer to the
|
imports ``distutils``. Refer to the
|
||||||
`Python Packaging User Guide <http://packaging.python.org>`_ for more
|
`Python Packaging User Guide <https://packaging.python.org>`_ for more
|
||||||
information.
|
information.
|
||||||
|
|
||||||
For the benefits of packaging tool authors and users seeking a deeper
|
For the benefits of packaging tool authors and users seeking a deeper
|
||||||
|
|
|
@ -1292,7 +1292,7 @@ are always available. They are listed here in alphabetical order.
|
||||||
example, sort by department, then by salary grade).
|
example, sort by department, then by salary grade).
|
||||||
|
|
||||||
For sorting examples and a brief sorting tutorial, see `Sorting HowTo
|
For sorting examples and a brief sorting tutorial, see `Sorting HowTo
|
||||||
<http://wiki.python.org/moin/HowTo/Sorting/>`_\.
|
<https://wiki.python.org/moin/HowTo/Sorting/>`_\.
|
||||||
|
|
||||||
.. function:: staticmethod(function)
|
.. function:: staticmethod(function)
|
||||||
|
|
||||||
|
|
|
@ -29,7 +29,7 @@ generically as an :term:`importer`) to participate in the import process.
|
||||||
:ref:`import`
|
:ref:`import`
|
||||||
The language reference for the :keyword:`import` statement.
|
The language reference for the :keyword:`import` statement.
|
||||||
|
|
||||||
`Packages specification <http://www.python.org/doc/essays/packages.html>`__
|
`Packages specification <https://www.python.org/doc/essays/packages.html>`__
|
||||||
Original specification of packages. Some semantics have changed since
|
Original specification of packages. Some semantics have changed since
|
||||||
the writing of this document (e.g. redirecting based on ``None``
|
the writing of this document (e.g. redirecting based on ``None``
|
||||||
in :data:`sys.modules`).
|
in :data:`sys.modules`).
|
||||||
|
|
|
@ -30,7 +30,7 @@ optional components.
|
||||||
In addition to the standard library, there is a growing collection of
|
In addition to the standard library, there is a growing collection of
|
||||||
several thousand components (from individual programs and modules to
|
several thousand components (from individual programs and modules to
|
||||||
packages and entire application development frameworks), available from
|
packages and entire application development frameworks), available from
|
||||||
the `Python Package Index <http://pypi.python.org/pypi>`_.
|
the `Python Package Index <https://pypi.python.org/pypi>`_.
|
||||||
|
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
|
|
@ -56,7 +56,7 @@ available for Python:
|
||||||
PyGTK, PyQt, and wxPython, all have a modern look and feel and more
|
PyGTK, PyQt, and wxPython, all have a modern look and feel and more
|
||||||
widgets than Tkinter. In addition, there are many other GUI toolkits for
|
widgets than Tkinter. In addition, there are many other GUI toolkits for
|
||||||
Python, both cross-platform, and platform-specific. See the `GUI Programming
|
Python, both cross-platform, and platform-specific. See the `GUI Programming
|
||||||
<http://wiki.python.org/moin/GuiProgramming>`_ page in the Python Wiki for a
|
<https://wiki.python.org/moin/GuiProgramming>`_ page in the Python Wiki for a
|
||||||
much more complete list, and also for links to documents where the
|
much more complete list, and also for links to documents where the
|
||||||
different GUI toolkits are compared.
|
different GUI toolkits are compared.
|
||||||
|
|
||||||
|
|
|
@ -76,7 +76,7 @@ documents precisely the version of the module you would get if you started the
|
||||||
Python interpreter and typed ``import spam``.
|
Python interpreter and typed ``import spam``.
|
||||||
|
|
||||||
Module docs for core modules are assumed to reside in
|
Module docs for core modules are assumed to reside in
|
||||||
``http://docs.python.org/X.Y/library/`` where ``X`` and ``Y`` are the
|
``https://docs.python.org/X.Y/library/`` where ``X`` and ``Y`` are the
|
||||||
major and minor version numbers of the Python interpreter. This can
|
major and minor version numbers of the Python interpreter. This can
|
||||||
be overridden by setting the :envvar:`PYTHONDOCS` environment variable
|
be overridden by setting the :envvar:`PYTHONDOCS` environment variable
|
||||||
to a different URL or to a local directory containing the Library
|
to a different URL or to a local directory containing the Library
|
||||||
|
|
|
@ -513,7 +513,7 @@ Partial mocking
|
||||||
~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
In some tests I wanted to mock out a call to `datetime.date.today()
|
In some tests I wanted to mock out a call to `datetime.date.today()
|
||||||
<http://docs.python.org/library/datetime.html#datetime.date.today>`_ to return
|
<https://docs.python.org/library/datetime.html#datetime.date.today>`_ to return
|
||||||
a known date, but I didn't want to prevent the code under test from
|
a known date, but I didn't want to prevent the code under test from
|
||||||
creating new date objects. Unfortunately `datetime.date` is written in C, and
|
creating new date objects. Unfortunately `datetime.date` is written in C, and
|
||||||
so I couldn't just monkey-patch out the static `date.today` method.
|
so I couldn't just monkey-patch out the static `date.today` method.
|
||||||
|
@ -557,13 +557,13 @@ Mocking a Generator Method
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
A Python generator is a function or method that uses the `yield statement
|
A Python generator is a function or method that uses the `yield statement
|
||||||
<http://docs.python.org/reference/simple_stmts.html#the-yield-statement>`_ to
|
<https://docs.python.org/reference/simple_stmts.html#the-yield-statement>`_ to
|
||||||
return a series of values when iterated over [#]_.
|
return a series of values when iterated over [#]_.
|
||||||
|
|
||||||
A generator method / function is called to return the generator object. It is
|
A generator method / function is called to return the generator object. It is
|
||||||
the generator object that is then iterated over. The protocol method for
|
the generator object that is then iterated over. The protocol method for
|
||||||
iteration is `__iter__
|
iteration is `__iter__
|
||||||
<http://docs.python.org/library/stdtypes.html#container.__iter__>`_, so we can
|
<https://docs.python.org/library/stdtypes.html#container.__iter__>`_, so we can
|
||||||
mock this using a `MagicMock`.
|
mock this using a `MagicMock`.
|
||||||
|
|
||||||
Here's an example class with an "iter" method implemented as a generator:
|
Here's an example class with an "iter" method implemented as a generator:
|
||||||
|
@ -1254,7 +1254,7 @@ With a bit of tweaking you could have the comparison function raise the
|
||||||
`AssertionError` directly and provide a more useful failure message.
|
`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
|
||||||
<http://pypi.python.org/pypi/PyHamcrest>`_ provides similar functionality,
|
<https://pypi.python.org/pypi/PyHamcrest>`_ 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
|
||||||
<http://packages.python.org/PyHamcrest/integration.html#hamcrest.library.integration.match_equality>`_).
|
<http://pythonhosted.org/PyHamcrest/integration.html#hamcrest.library.integration.match_equality>`_).
|
||||||
|
|
|
@ -30,7 +30,7 @@ is based on the 'action -> assertion' pattern instead of `'record -> replay'`
|
||||||
used by many mocking frameworks.
|
used by many mocking frameworks.
|
||||||
|
|
||||||
There is a backport of `unittest.mock` for earlier versions of Python,
|
There is a backport of `unittest.mock` for earlier versions of Python,
|
||||||
available as `mock on PyPI <http://pypi.python.org/pypi/mock>`_.
|
available as `mock on PyPI <https://pypi.python.org/pypi/mock>`_.
|
||||||
|
|
||||||
**Source code:** :source:`Lib/unittest/mock.py`
|
**Source code:** :source:`Lib/unittest/mock.py`
|
||||||
|
|
||||||
|
|
|
@ -55,7 +55,7 @@ test runner
|
||||||
Third-party unittest frameworks with a lighter-weight syntax for writing
|
Third-party unittest frameworks with a lighter-weight syntax for writing
|
||||||
tests. For example, ``assert func(10) == 42``.
|
tests. For example, ``assert func(10) == 42``.
|
||||||
|
|
||||||
`The Python Testing Tools Taxonomy <http://wiki.python.org/moin/PythonTestingToolsTaxonomy>`_
|
`The Python Testing Tools Taxonomy <https://wiki.python.org/moin/PythonTestingToolsTaxonomy>`_
|
||||||
An extensive list of Python testing tools including functional testing
|
An extensive list of Python testing tools including functional testing
|
||||||
frameworks and mock object libraries.
|
frameworks and mock object libraries.
|
||||||
|
|
||||||
|
|
|
@ -23,7 +23,7 @@ In May 2000, Guido and the Python core development team moved to BeOpen.com to
|
||||||
form the BeOpen PythonLabs team. In October of the same year, the PythonLabs
|
form the BeOpen PythonLabs team. In October of the same year, the PythonLabs
|
||||||
team moved to Digital Creations (now Zope Corporation; see
|
team moved to Digital Creations (now Zope Corporation; see
|
||||||
http://www.zope.com/). In 2001, the Python Software Foundation (PSF, see
|
http://www.zope.com/). In 2001, the Python Software Foundation (PSF, see
|
||||||
http://www.python.org/psf/) was formed, a non-profit organization created
|
https://www.python.org/psf/) was formed, a non-profit organization created
|
||||||
specifically to own Python-related Intellectual Property. Zope Corporation is a
|
specifically to own Python-related Intellectual Property. Zope Corporation is a
|
||||||
sponsoring member of the PSF.
|
sponsoring member of the PSF.
|
||||||
|
|
||||||
|
|
|
@ -709,7 +709,7 @@ Custom classes
|
||||||
where there are multiple inheritance paths leading back to a common ancestor.
|
where there are multiple inheritance paths leading back to a common ancestor.
|
||||||
Additional details on the C3 MRO used by Python can be found in the
|
Additional details on the C3 MRO used by Python can be found in the
|
||||||
documentation accompanying the 2.3 release at
|
documentation accompanying the 2.3 release at
|
||||||
http://www.python.org/download/releases/2.3/mro/.
|
https://www.python.org/download/releases/2.3/mro/.
|
||||||
|
|
||||||
.. XXX: Could we add that MRO doc as an appendix to the language ref?
|
.. XXX: Could we add that MRO doc as an appendix to the language ref?
|
||||||
|
|
||||||
|
|
|
@ -901,7 +901,7 @@ References
|
||||||
|
|
||||||
The import machinery has evolved considerably since Python's early days. The
|
The import machinery has evolved considerably since Python's early days. The
|
||||||
original `specification for packages
|
original `specification for packages
|
||||||
<http://www.python.org/doc/essays/packages.html>`_ is still available to read,
|
<https://www.python.org/doc/essays/packages.html>`_ is still available to read,
|
||||||
although some details have changed since the writing of that document.
|
although some details have changed since the writing of that document.
|
||||||
|
|
||||||
The original specification for :data:`sys.meta_path` was :pep:`302`, with
|
The original specification for :data:`sys.meta_path` was :pep:`302`, with
|
||||||
|
|
|
@ -50,7 +50,7 @@
|
||||||
window.location.href = new_url;
|
window.location.href = new_url;
|
||||||
},
|
},
|
||||||
error: function() {
|
error: function() {
|
||||||
window.location.href = 'http://docs.python.org/' + selected;
|
window.location.href = 'https://docs.python.org/' + selected;
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
{% if daily is defined %}
|
{% if daily is defined %}
|
||||||
{% set dlbase = pathto('archives', 1) %}
|
{% set dlbase = pathto('archives', 1) %}
|
||||||
{% else %}
|
{% else %}
|
||||||
{% set dlbase = 'http://docs.python.org/ftp/python/doc/' + release %}
|
{% set dlbase = 'https://docs.python.org/ftp/python/doc/' + release %}
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
|
||||||
{% block body %}
|
{% block body %}
|
||||||
|
@ -42,7 +42,7 @@ in the table are the size of the download files in megabytes.</p>
|
||||||
<p>These archives contain all the content in the documentation.</p>
|
<p>These archives contain all the content in the documentation.</p>
|
||||||
|
|
||||||
<p>HTML Help (<tt>.chm</tt>) files are made available in the "Windows" section
|
<p>HTML Help (<tt>.chm</tt>) files are made available in the "Windows" section
|
||||||
on the <a href="http://python.org/download/releases/{{ release[:5] }}/">Python
|
on the <a href="https://www.python.org/download/releases/{{ release[:5] }}/">Python
|
||||||
download page</a>.</p>
|
download page</a>.</p>
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -2,16 +2,16 @@
|
||||||
<p><a href="{{ pathto('download') }}">Download these documents</a></p>
|
<p><a href="{{ pathto('download') }}">Download these documents</a></p>
|
||||||
<h3>Docs for other versions</h3>
|
<h3>Docs for other versions</h3>
|
||||||
<ul>
|
<ul>
|
||||||
<li><a href="http://docs.python.org/2.7/">Python 2.7 (stable)</a></li>
|
<li><a href="https://docs.python.org/2.7/">Python 2.7 (stable)</a></li>
|
||||||
<li><a href="http://docs.python.org/3.4/">Python 3.4 (stable)</a></li>
|
<li><a href="https://docs.python.org/3.4/">Python 3.4 (stable)</a></li>
|
||||||
<li><a href="http://www.python.org/doc/versions/">Old versions</a></li>
|
<li><a href="https://www.python.org/doc/versions/">Old versions</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<h3>Other resources</h3>
|
<h3>Other resources</h3>
|
||||||
<ul>
|
<ul>
|
||||||
{# XXX: many of these should probably be merged in the main docs #}
|
{# XXX: many of these should probably be merged in the main docs #}
|
||||||
<li><a href="http://www.python.org/dev/peps/">PEP Index</a></li>
|
<li><a href="https://www.python.org/dev/peps/">PEP Index</a></li>
|
||||||
<li><a href="http://wiki.python.org/moin/BeginnersGuide">Beginner's Guide</a></li>
|
<li><a href="https://wiki.python.org/moin/BeginnersGuide">Beginner's Guide</a></li>
|
||||||
<li><a href="http://wiki.python.org/moin/PythonBooks">Book List</a></li>
|
<li><a href="https://wiki.python.org/moin/PythonBooks">Book List</a></li>
|
||||||
<li><a href="http://www.python.org/doc/av/">Audio/Visual Talks</a></li>
|
<li><a href="https://www.python.org/doc/av/">Audio/Visual Talks</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
{% block rootrellink %}
|
{% block rootrellink %}
|
||||||
<li><img src="{{ pathto('_static/py.png', 1) }}" alt=""
|
<li><img src="{{ pathto('_static/py.png', 1) }}" alt=""
|
||||||
style="vertical-align: middle; margin-top: -1px"/></li>
|
style="vertical-align: middle; margin-top: -1px"/></li>
|
||||||
<li><a href="http://www.python.org/">Python</a>{{ reldelim1 }}</li>
|
<li><a href="https://www.python.org/">Python</a>{{ reldelim1 }}</li>
|
||||||
<li>
|
<li>
|
||||||
{%- if versionswitcher is defined %}
|
{%- if versionswitcher is defined %}
|
||||||
<span class="version_switcher_placeholder">{{ release }}</span>
|
<span class="version_switcher_placeholder">{{ release }}</span>
|
||||||
|
@ -82,7 +82,7 @@
|
||||||
© <a href="{{ pathto('copyright') }}">Copyright</a> {{ copyright|e }}.
|
© <a href="{{ pathto('copyright') }}">Copyright</a> {{ copyright|e }}.
|
||||||
<br />
|
<br />
|
||||||
The Python Software Foundation is a non-profit corporation.
|
The Python Software Foundation is a non-profit corporation.
|
||||||
<a href="http://www.python.org/psf/donations/">Please donate.</a>
|
<a href="https://www.python.org/psf/donations/">Please donate.</a>
|
||||||
<br />
|
<br />
|
||||||
Last updated on {{ last_updated|e }}.
|
Last updated on {{ last_updated|e }}.
|
||||||
<a href="{{ pathto('bugs') }}">Found a bug</a>?
|
<a href="{{ pathto('bugs') }}">Found a bug</a>?
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
{% extends "!opensearch.xml" %}
|
{% extends "!opensearch.xml" %}
|
||||||
{% block extra -%}
|
{% block extra -%}
|
||||||
<Image height="16" width="16" type="image/x-icon">http://www.python.org/images/favicon16x16.ico</Image>
|
<Image height="16" width="16" type="image/x-icon">https://www.python.org/images/favicon16x16.ico</Image>
|
||||||
{%- endblock %}
|
{%- endblock %}
|
||||||
|
|
|
@ -643,7 +643,7 @@ class, that calls each parent only once, and that is monotonic (meaning that a
|
||||||
class can be subclassed without affecting the precedence order of its parents).
|
class can be subclassed without affecting the precedence order of its parents).
|
||||||
Taken together, these properties make it possible to design reliable and
|
Taken together, these properties make it possible to design reliable and
|
||||||
extensible classes with multiple inheritance. For more detail, see
|
extensible classes with multiple inheritance. For more detail, see
|
||||||
http://www.python.org/download/releases/2.3/mro/.
|
https://www.python.org/download/releases/2.3/mro/.
|
||||||
|
|
||||||
|
|
||||||
.. _tut-private:
|
.. _tut-private:
|
||||||
|
|
|
@ -12,7 +12,7 @@ and rapid application development in many areas on most platforms.
|
||||||
|
|
||||||
The Python interpreter and the extensive standard library are freely available
|
The Python interpreter and the extensive standard library are freely available
|
||||||
in source or binary form for all major platforms from the Python Web site,
|
in source or binary form for all major platforms from the Python Web site,
|
||||||
http://www.python.org/, and may be freely distributed. The same site also
|
https://www.python.org/, and may be freely distributed. The same site also
|
||||||
contains distributions of and pointers to many free third party Python modules,
|
contains distributions of and pointers to many free third party Python modules,
|
||||||
programs and tools, and additional documentation.
|
programs and tools, and additional documentation.
|
||||||
|
|
||||||
|
|
|
@ -30,15 +30,15 @@ the set are:
|
||||||
|
|
||||||
More Python resources:
|
More Python resources:
|
||||||
|
|
||||||
* http://www.python.org: The major Python Web site. It contains code,
|
* https://www.python.org: The major Python Web site. It contains code,
|
||||||
documentation, and pointers to Python-related pages around the Web. This Web
|
documentation, and pointers to Python-related pages around the Web. This Web
|
||||||
site is mirrored in various places around the world, such as Europe, Japan, and
|
site is mirrored in various places around the world, such as Europe, Japan, and
|
||||||
Australia; a mirror may be faster than the main site, depending on your
|
Australia; a mirror may be faster than the main site, depending on your
|
||||||
geographical location.
|
geographical location.
|
||||||
|
|
||||||
* http://docs.python.org: Fast access to Python's documentation.
|
* https://docs.python.org: Fast access to Python's documentation.
|
||||||
|
|
||||||
* http://pypi.python.org: The Python Package Index, previously also nicknamed
|
* https://pypi.python.org: The Python Package Index, previously also nicknamed
|
||||||
the Cheese Shop, is an index of user-created Python modules that are available
|
the Cheese Shop, is an index of user-created Python modules that are available
|
||||||
for download. Once you begin releasing code, you can register it here so that
|
for download. Once you begin releasing code, you can register it here so that
|
||||||
others can find it.
|
others can find it.
|
||||||
|
@ -61,7 +61,7 @@ around 120 postings a day (with peaks up to several hundred), asking (and
|
||||||
answering) questions, suggesting new features, and announcing new modules.
|
answering) questions, suggesting new features, and announcing new modules.
|
||||||
Before posting, be sure to check the list of :ref:`Frequently Asked Questions
|
Before posting, be sure to check the list of :ref:`Frequently Asked Questions
|
||||||
<faq-index>` (also called the FAQ).
|
<faq-index>` (also called the FAQ).
|
||||||
Mailing list archives are available at http://mail.python.org/pipermail/.
|
Mailing list archives are available at https://mail.python.org/pipermail/.
|
||||||
The FAQ answers many of the questions that come up again and again,
|
The FAQ answers many of the questions that come up again and again,
|
||||||
and may already contain the solution for your problem.
|
and may already contain the solution for your problem.
|
||||||
|
|
||||||
|
|
|
@ -19,7 +19,7 @@ Getting and Installing MacPython
|
||||||
|
|
||||||
Mac OS X 10.8 comes with Python 2.7 pre-installed by Apple. If you wish, you
|
Mac OS X 10.8 comes with Python 2.7 pre-installed by Apple. If you wish, you
|
||||||
are invited to install the most recent version of Python 3 from the Python
|
are invited to install the most recent version of Python 3 from the Python
|
||||||
website (http://www.python.org). A current "universal binary" build of Python,
|
website (https://www.python.org). A current "universal binary" build of Python,
|
||||||
which runs natively on the Mac's new Intel and legacy PPC CPU's, is available
|
which runs natively on the Mac's new Intel and legacy PPC CPU's, is available
|
||||||
there.
|
there.
|
||||||
|
|
||||||
|
@ -174,9 +174,9 @@ Other Resources
|
||||||
The MacPython mailing list is an excellent support resource for Python users and
|
The MacPython mailing list is an excellent support resource for Python users and
|
||||||
developers on the Mac:
|
developers on the Mac:
|
||||||
|
|
||||||
http://www.python.org/community/sigs/current/pythonmac-sig/
|
https://www.python.org/community/sigs/current/pythonmac-sig/
|
||||||
|
|
||||||
Another useful resource is the MacPython wiki:
|
Another useful resource is the MacPython wiki:
|
||||||
|
|
||||||
http://wiki.python.org/moin/MacPython
|
https://wiki.python.org/moin/MacPython
|
||||||
|
|
||||||
|
|
|
@ -65,9 +65,9 @@ Building Python
|
||||||
===============
|
===============
|
||||||
|
|
||||||
If you want to compile CPython yourself, first thing you should do is get the
|
If you want to compile CPython yourself, first thing you should do is get the
|
||||||
`source <http://python.org/download/source/>`_. You can download either the
|
`source <https://www.python.org/download/source/>`_. You can download either the
|
||||||
latest release's source or just grab a fresh `clone
|
latest release's source or just grab a fresh `clone
|
||||||
<http://docs.python.org/devguide/setup#getting-the-source-code>`_. (If you want
|
<https://docs.python.org/devguide/setup#getting-the-source-code>`_. (If you want
|
||||||
to contribute patches, you will need a clone.)
|
to contribute patches, you will need a clone.)
|
||||||
|
|
||||||
The build process consists in the usual ::
|
The build process consists in the usual ::
|
||||||
|
|
|
@ -14,7 +14,7 @@ subdirectory (on Windows, this is ``Lib\site-packages``).
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Python Packaging User Guide: Creating and using virtual environments
|
`Python Packaging User Guide: Creating and using virtual environments
|
||||||
<http://packaging.python.org/en/latest/tutorial.html#creating-and-using-virtual-environments>`__
|
<https://packaging.python.org/en/latest/tutorial.html#creating-and-using-virtual-environments>`__
|
||||||
|
|
||||||
.. highlight:: none
|
.. highlight:: none
|
||||||
|
|
||||||
|
|
|
@ -22,7 +22,7 @@ Installing Python
|
||||||
Unlike most Unix systems and services, Windows does not require Python natively
|
Unlike most Unix systems and services, Windows does not require Python natively
|
||||||
and thus does not pre-install a version of Python. However, the CPython team
|
and thus does not pre-install a version of Python. However, the CPython team
|
||||||
has compiled Windows installers (MSI packages) with every `release
|
has compiled Windows installers (MSI packages) with every `release
|
||||||
<http://www.python.org/download/releases/>`_ for many years.
|
<https://www.python.org/download/releases/>`_ for many years.
|
||||||
|
|
||||||
With ongoing development of Python, some platforms that used to be supported
|
With ongoing development of Python, some platforms that used to be supported
|
||||||
earlier are no longer supported (due to the lack of users or developers).
|
earlier are no longer supported (due to the lack of users or developers).
|
||||||
|
@ -36,7 +36,7 @@ Check :pep:`11` for details on all unsupported platforms.
|
||||||
release/python>`_, `Maintainer releases
|
release/python>`_, `Maintainer releases
|
||||||
<http://www.tishler.net/jason/software/python/>`_)
|
<http://www.tishler.net/jason/software/python/>`_)
|
||||||
|
|
||||||
See `Python for Windows <http://www.python.org/download/windows/>`_
|
See `Python for Windows <https://www.python.org/download/windows/>`_
|
||||||
for detailed information about platforms with pre-compiled installers.
|
for detailed information about platforms with pre-compiled installers.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
@ -515,7 +515,7 @@ utilities for:
|
||||||
user interfaces
|
user interfaces
|
||||||
|
|
||||||
`PythonWin <http://web.archive.org/web/20060524042422/
|
`PythonWin <http://web.archive.org/web/20060524042422/
|
||||||
http://www.python.org/windows/pythonwin/>`_ is a sample MFC application
|
https://www.python.org/windows/pythonwin/>`_ is a sample MFC application
|
||||||
shipped with PyWin32. It is an embeddable IDE with a built-in debugger.
|
shipped with PyWin32. It is an embeddable IDE with a built-in debugger.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
@ -553,9 +553,9 @@ Compiling Python on Windows
|
||||||
===========================
|
===========================
|
||||||
|
|
||||||
If you want to compile CPython yourself, first thing you should do is get the
|
If you want to compile CPython yourself, first thing you should do is get the
|
||||||
`source <http://python.org/download/source/>`_. You can download either the
|
`source <https://www.python.org/download/source/>`_. You can download either the
|
||||||
latest release's source or just grab a fresh `checkout
|
latest release's source or just grab a fresh `checkout
|
||||||
<http://docs.python.org/devguide/setup#checking-out-the-code>`_.
|
<https://docs.python.org/devguide/setup#checking-out-the-code>`_.
|
||||||
|
|
||||||
The source tree contains a build solution and project files for Microsoft
|
The source tree contains a build solution and project files for Microsoft
|
||||||
Visual C++, which is the compiler used to build the official Python releases.
|
Visual C++, which is the compiler used to build the official Python releases.
|
||||||
|
|
|
@ -130,7 +130,7 @@ Guidelines":
|
||||||
Read the rest of PEP 1 for the details of the PEP editorial process, style, and
|
Read the rest of PEP 1 for the details of the PEP editorial process, style, and
|
||||||
format. PEPs are kept in the Python CVS tree on SourceForge, though they're not
|
format. PEPs are kept in the Python CVS tree on SourceForge, though they're not
|
||||||
part of the Python 2.0 distribution, and are also available in HTML form from
|
part of the Python 2.0 distribution, and are also available in HTML form from
|
||||||
http://www.python.org/peps/. As of September 2000, there are 25 PEPS, ranging
|
https://www.python.org/peps/. As of September 2000, there are 25 PEPS, ranging
|
||||||
from PEP 201, "Lockstep Iteration", to PEP 225, "Elementwise/Objectwise
|
from PEP 201, "Lockstep Iteration", to PEP 225, "Elementwise/Objectwise
|
||||||
Operators".
|
Operators".
|
||||||
|
|
||||||
|
@ -566,7 +566,7 @@ such as ``cmp(a,b)`` would always produce an answer, even if a user-defined
|
||||||
simply be silently swallowed.
|
simply be silently swallowed.
|
||||||
|
|
||||||
.. Starting URL:
|
.. Starting URL:
|
||||||
.. http://www.python.org/pipermail/python-dev/2000-April/004834.html
|
.. https://www.python.org/pipermail/python-dev/2000-April/004834.html
|
||||||
|
|
||||||
Work has been done on porting Python to 64-bit Windows on the Itanium processor,
|
Work has been done on porting Python to 64-bit Windows on the Itanium processor,
|
||||||
mostly by Trent Mick of ActiveState. (Confusingly, ``sys.platform`` is still
|
mostly by Trent Mick of ActiveState. (Confusingly, ``sys.platform`` is still
|
||||||
|
@ -1003,7 +1003,7 @@ Relationship to PyXML
|
||||||
|
|
||||||
The XML Special Interest Group has been working on XML-related Python code for a
|
The XML Special Interest Group has been working on XML-related Python code for a
|
||||||
while. Its code distribution, called PyXML, is available from the SIG's Web
|
while. Its code distribution, called PyXML, is available from the SIG's Web
|
||||||
pages at http://www.python.org/sigs/xml-sig/. The PyXML distribution also used
|
pages at https://www.python.org/sigs/xml-sig/. The PyXML distribution also used
|
||||||
the package name ``xml``. If you've written programs that used PyXML, you're
|
the package name ``xml``. If you've written programs that used PyXML, you're
|
||||||
probably wondering about its compatibility with the 2.0 :mod:`xml` package.
|
probably wondering about its compatibility with the 2.0 :mod:`xml` package.
|
||||||
|
|
||||||
|
|
|
@ -562,7 +562,7 @@ You can start creating packages containing :file:`PKG-INFO` even if you're not
|
||||||
using Python 2.1, since a new release of the Distutils will be made for users of
|
using Python 2.1, since a new release of the Distutils will be made for users of
|
||||||
earlier Python versions. Version 1.0.2 of the Distutils includes the changes
|
earlier Python versions. Version 1.0.2 of the Distutils includes the changes
|
||||||
described in PEP 241, as well as various bugfixes and enhancements. It will be
|
described in PEP 241, as well as various bugfixes and enhancements. It will be
|
||||||
available from the Distutils SIG at http://www.python.org/sigs/distutils-sig/.
|
available from the Distutils SIG at https://www.python.org/sigs/distutils-sig/.
|
||||||
|
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
@ -731,7 +731,7 @@ of the more notable changes are:
|
||||||
...
|
...
|
||||||
|
|
||||||
For a fuller discussion of the line I/O changes, see the python-dev summary for
|
For a fuller discussion of the line I/O changes, see the python-dev summary for
|
||||||
January 1-15, 2001 at http://www.python.org/dev/summary/2001-01-1/.
|
January 1-15, 2001 at https://www.python.org/dev/summary/2001-01-1/.
|
||||||
|
|
||||||
* A new method, :meth:`popitem`, was added to dictionaries to enable
|
* A new method, :meth:`popitem`, was added to dictionaries to enable
|
||||||
destructively iterating through the contents of a dictionary; this can be faster
|
destructively iterating through the contents of a dictionary; this can be faster
|
||||||
|
|
|
@ -24,8 +24,8 @@ up irregularities and dark corners of the language design.
|
||||||
This article doesn't attempt to provide a complete specification of the new
|
This article doesn't attempt to provide a complete specification of the new
|
||||||
features, but instead provides a convenient overview. For full details, you
|
features, but instead provides a convenient overview. For full details, you
|
||||||
should refer to the documentation for Python 2.2, such as the `Python Library
|
should refer to the documentation for Python 2.2, such as the `Python Library
|
||||||
Reference <http://www.python.org/doc/2.2/lib/lib.html>`_ and the `Python
|
Reference <https://www.python.org/doc/2.2/lib/lib.html>`_ and the `Python
|
||||||
Reference Manual <http://www.python.org/doc/2.2/ref/ref.html>`_. If you want to
|
Reference Manual <https://www.python.org/doc/2.2/ref/ref.html>`_. If you want to
|
||||||
understand the complete implementation and design rationale for a change, refer
|
understand the complete implementation and design rationale for a change, refer
|
||||||
to the PEP for a particular new feature.
|
to the PEP for a particular new feature.
|
||||||
|
|
||||||
|
@ -395,7 +395,7 @@ This section has just been a quick overview of the new features, giving enough
|
||||||
of an explanation to start you programming, but many details have been
|
of an explanation to start you programming, but many details have been
|
||||||
simplified or ignored. Where should you go to get a more complete picture?
|
simplified or ignored. Where should you go to get a more complete picture?
|
||||||
|
|
||||||
http://www.python.org/2.2/descrintro.html is a lengthy tutorial introduction to
|
https://www.python.org/2.2/descrintro.html is a lengthy tutorial introduction to
|
||||||
the descriptor features, written by Guido van Rossum. If my description has
|
the descriptor features, written by Guido van Rossum. If my description has
|
||||||
whetted your appetite, go read this tutorial next, because it goes into much
|
whetted your appetite, go read this tutorial next, because it goes into much
|
||||||
more detail about the new features while still remaining quite easy to read.
|
more detail about the new features while still remaining quite easy to read.
|
||||||
|
|
|
@ -657,7 +657,7 @@ The heart of the catalog is the new Distutils :command:`register` command.
|
||||||
Running ``python setup.py register`` will collect the metadata describing a
|
Running ``python setup.py register`` will collect the metadata describing a
|
||||||
package, such as its name, version, maintainer, description, &c., and send it to
|
package, such as its name, version, maintainer, description, &c., and send it to
|
||||||
a central catalog server. The resulting catalog is available from
|
a central catalog server. The resulting catalog is available from
|
||||||
http://www.python.org/pypi.
|
https://pypi.python.org/pypi.
|
||||||
|
|
||||||
To make the catalog a bit more useful, a new optional *classifiers* keyword
|
To make the catalog a bit more useful, a new optional *classifiers* keyword
|
||||||
argument has been added to the Distutils :func:`setup` function. A list of
|
argument has been added to the Distutils :func:`setup` function. A list of
|
||||||
|
@ -1082,9 +1082,9 @@ Here are all of the changes that Python 2.3 makes to the core Python language.
|
||||||
C3 algorithm as described in the paper `"A Monotonic Superclass Linearization
|
C3 algorithm as described in the paper `"A Monotonic Superclass Linearization
|
||||||
for Dylan" <http://www.webcom.com/haahr/dylan/linearization-oopsla96.html>`_. To
|
for Dylan" <http://www.webcom.com/haahr/dylan/linearization-oopsla96.html>`_. To
|
||||||
understand the motivation for this change, read Michele Simionato's article
|
understand the motivation for this change, read Michele Simionato's article
|
||||||
`"Python 2.3 Method Resolution Order" <http://www.python.org/2.3/mro.html>`_, or
|
`"Python 2.3 Method Resolution Order" <https://www.python.org/2.3/mro.html>`_, or
|
||||||
read the thread on python-dev starting with the message at
|
read the thread on python-dev starting with the message at
|
||||||
http://mail.python.org/pipermail/python-dev/2002-October/029035.html. Samuele
|
https://mail.python.org/pipermail/python-dev/2002-October/029035.html. Samuele
|
||||||
Pedroni first pointed out the problem and also implemented the fix by coding the
|
Pedroni first pointed out the problem and also implemented the fix by coding the
|
||||||
C3 algorithm.
|
C3 algorithm.
|
||||||
|
|
||||||
|
@ -1564,7 +1564,7 @@ complete list of changes, or look through the CVS logs for all the details.
|
||||||
to the correct thread, and waiting for the results. Other interfaces can't be
|
to the correct thread, and waiting for the results. Other interfaces can't be
|
||||||
handled automatically but :mod:`Tkinter` will now raise an exception on such an
|
handled automatically but :mod:`Tkinter` will now raise an exception on such an
|
||||||
access so that you can at least find out about the problem. See
|
access so that you can at least find out about the problem. See
|
||||||
http://mail.python.org/pipermail/python-dev/2002-December/031107.html for a more
|
https://mail.python.org/pipermail/python-dev/2002-December/031107.html for a more
|
||||||
detailed explanation of this change. (Implemented by Martin von Löwis.)
|
detailed explanation of this change. (Implemented by Martin von Löwis.)
|
||||||
|
|
||||||
* Calling Tcl methods through :mod:`_tkinter` no longer returns only strings.
|
* Calling Tcl methods through :mod:`_tkinter` no longer returns only strings.
|
||||||
|
@ -1858,7 +1858,7 @@ and bundle it with the source of your extension.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
http://svn.python.org/view/python/trunk/Objects/obmalloc.c
|
https://svn.python.org/view/python/trunk/Objects/obmalloc.c
|
||||||
For the full details of the pymalloc implementation, see the comments at
|
For the full details of the pymalloc implementation, see the comments at
|
||||||
the top of the file :file:`Objects/obmalloc.c` in the Python source code.
|
the top of the file :file:`Objects/obmalloc.c` in the Python source code.
|
||||||
The above link points to the file within the python.org SVN browser.
|
The above link points to the file within the python.org SVN browser.
|
||||||
|
|
|
@ -337,7 +337,7 @@ returned.
|
||||||
wrote patches implementing function decorators, but the one that was actually
|
wrote patches implementing function decorators, but the one that was actually
|
||||||
checked in was patch #979728, written by Mark Russell.
|
checked in was patch #979728, written by Mark Russell.
|
||||||
|
|
||||||
http://www.python.org/moin/PythonDecoratorLibrary
|
https://www.python.org/moin/PythonDecoratorLibrary
|
||||||
This Wiki page contains several examples of decorators.
|
This Wiki page contains several examples of decorators.
|
||||||
|
|
||||||
.. ======================================================================
|
.. ======================================================================
|
||||||
|
|
|
@ -39,7 +39,7 @@ finds there were 353 patches applied and 458 bugs fixed between Python 2.4 and
|
||||||
This article doesn't try to be a complete specification of the new features;
|
This article doesn't try to be a complete specification of the new features;
|
||||||
instead changes are briefly introduced using helpful examples. For full
|
instead changes are briefly introduced using helpful examples. For full
|
||||||
details, you should always refer to the documentation for Python 2.5 at
|
details, you should always refer to the documentation for Python 2.5 at
|
||||||
http://docs.python.org. If you want to understand the complete implementation
|
https://docs.python.org. If you want to understand the complete implementation
|
||||||
and design rationale, refer to the PEP for a particular new feature.
|
and design rationale, refer to the PEP for a particular new feature.
|
||||||
|
|
||||||
Comments, suggestions, and error reports for this document are welcome; please
|
Comments, suggestions, and error reports for this document are welcome; please
|
||||||
|
@ -229,7 +229,7 @@ required packages. ::
|
||||||
)
|
)
|
||||||
|
|
||||||
Another new enhancement to the Python package index at
|
Another new enhancement to the Python package index at
|
||||||
http://cheeseshop.python.org is storing source and binary archives for a
|
https://pypi.python.org is storing source and binary archives for a
|
||||||
package. The new :command:`upload` Distutils command will upload a package to
|
package. The new :command:`upload` Distutils command will upload a package to
|
||||||
the repository.
|
the repository.
|
||||||
|
|
||||||
|
@ -2130,7 +2130,7 @@ Changes to Python's build process and to the C API include:
|
||||||
such as PyCon.
|
such as PyCon.
|
||||||
|
|
||||||
.. List of names taken from Jeremy's python-dev post at
|
.. List of names taken from Jeremy's python-dev post at
|
||||||
.. http://mail.python.org/pipermail/python-dev/2005-October/057500.html
|
.. https://mail.python.org/pipermail/python-dev/2005-October/057500.html
|
||||||
|
|
||||||
* Evan Jones's patch to obmalloc, first described in a talk at PyCon DC 2005,
|
* Evan Jones's patch to obmalloc, first described in a talk at PyCon DC 2005,
|
||||||
was applied. Python 2.4 allocated small objects in 256K-sized arenas, but never
|
was applied. Python 2.4 allocated small objects in 256K-sized arenas, but never
|
||||||
|
|
|
@ -164,7 +164,7 @@ is an open-source project that requires volunteers
|
||||||
to administer it and a server to host it.
|
to administer it and a server to host it.
|
||||||
|
|
||||||
After posting a call for volunteers, a new Roundup installation was
|
After posting a call for volunteers, a new Roundup installation was
|
||||||
set up at http://bugs.python.org. One installation of Roundup can
|
set up at https://bugs.python.org. One installation of Roundup can
|
||||||
host multiple trackers, and this server now also hosts issue trackers
|
host multiple trackers, and this server now also hosts issue trackers
|
||||||
for Jython and for the Python web site. It will surely find
|
for Jython and for the Python web site. It will surely find
|
||||||
other uses in the future. Where possible,
|
other uses in the future. Where possible,
|
||||||
|
@ -181,7 +181,7 @@ other projects wishing to move from SourceForge to Roundup.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
http://bugs.python.org
|
https://bugs.python.org
|
||||||
The Python bug tracker.
|
The Python bug tracker.
|
||||||
|
|
||||||
http://bugs.jython.org:
|
http://bugs.jython.org:
|
||||||
|
@ -227,15 +227,15 @@ the Python community.
|
||||||
|
|
||||||
Sphinx is a standalone package that can be used for writing, and
|
Sphinx is a standalone package that can be used for writing, and
|
||||||
almost two dozen other projects
|
almost two dozen other projects
|
||||||
(`listed on the Sphinx web site <http://sphinx.pocoo.org/examples.html>`__)
|
(`listed on the Sphinx web site <http://sphinx-doc.org/examples.html>`__)
|
||||||
have adopted Sphinx as their documentation tool.
|
have adopted Sphinx as their documentation tool.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
`Documenting Python <http://docs.python.org/devguide/documenting.html>`__
|
`Documenting Python <https://docs.python.org/devguide/documenting.html>`__
|
||||||
Describes how to write for Python's documentation.
|
Describes how to write for Python's documentation.
|
||||||
|
|
||||||
`Sphinx <http://sphinx.pocoo.org/>`__
|
`Sphinx <http://sphinx-doc.org/>`__
|
||||||
Documentation and code for the Sphinx toolchain.
|
Documentation and code for the Sphinx toolchain.
|
||||||
|
|
||||||
`Docutils <http://docutils.sf.net>`__
|
`Docutils <http://docutils.sf.net>`__
|
||||||
|
|
|
@ -68,9 +68,9 @@ included in 2.7.
|
||||||
This article doesn't attempt to provide a complete specification of
|
This article doesn't attempt to provide a complete specification of
|
||||||
the new features, but instead provides a convenient overview. For
|
the new features, but instead provides a convenient overview. For
|
||||||
full details, you should refer to the documentation for Python 2.7 at
|
full details, you should refer to the documentation for Python 2.7 at
|
||||||
http://docs.python.org. If you want to understand the rationale for
|
https://docs.python.org. If you want to understand the rationale for
|
||||||
the design and implementation, refer to the PEP for a particular new
|
the design and implementation, refer to the PEP for a particular new
|
||||||
feature or the issue on http://bugs.python.org in which a change was
|
feature or the issue on https://bugs.python.org in which a change was
|
||||||
discussed. Whenever possible, "What's New in Python" links to the
|
discussed. Whenever possible, "What's New in Python" links to the
|
||||||
bug/patch item for each change.
|
bug/patch item for each change.
|
||||||
|
|
||||||
|
@ -1767,7 +1767,7 @@ a complete list of functions.
|
||||||
|
|
||||||
The Distutils package and :mod:`sysconfig` are now maintained by Tarek
|
The Distutils package and :mod:`sysconfig` are now maintained by Tarek
|
||||||
Ziadé, who has also started a Distutils2 package (source repository at
|
Ziadé, who has also started a Distutils2 package (source repository at
|
||||||
http://hg.python.org/distutils2/) for developing a next-generation
|
https://hg.python.org/distutils2/) for developing a next-generation
|
||||||
version of Distutils.
|
version of Distutils.
|
||||||
|
|
||||||
|
|
||||||
|
@ -1804,7 +1804,7 @@ new features were added. Most of these features were implemented
|
||||||
by Michael Foord, unless otherwise noted. The enhanced version of
|
by Michael Foord, unless otherwise noted. The enhanced version of
|
||||||
the module is downloadable separately for use with Python versions 2.4 to 2.6,
|
the module is downloadable separately for use with Python versions 2.4 to 2.6,
|
||||||
packaged as the :mod:`unittest2` package, from
|
packaged as the :mod:`unittest2` package, from
|
||||||
http://pypi.python.org/pypi/unittest2.
|
https://pypi.python.org/pypi/unittest2.
|
||||||
|
|
||||||
When used from the command line, the module can automatically discover
|
When used from the command line, the module can automatically discover
|
||||||
tests. It's not as fancy as `py.test <http://pytest.org>`__ or
|
tests. It's not as fancy as `py.test <http://pytest.org>`__ or
|
||||||
|
|
|
@ -50,7 +50,7 @@
|
||||||
|
|
||||||
This article explains the new features in Python 3.2 as compared to 3.1. It
|
This article explains the new features in Python 3.2 as compared to 3.1. It
|
||||||
focuses on a few highlights and gives a few examples. For full details, see the
|
focuses on a few highlights and gives a few examples. For full details, see the
|
||||||
`Misc/NEWS <http://hg.python.org/cpython/file/3.2/Misc/NEWS>`_ file.
|
`Misc/NEWS <https://hg.python.org/cpython/file/3.2/Misc/NEWS>`_ file.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
|
@ -816,7 +816,7 @@ functools
|
||||||
>>> sorted(iterable, key=cmp_to_key(locale.strcoll))
|
>>> sorted(iterable, key=cmp_to_key(locale.strcoll))
|
||||||
|
|
||||||
For sorting examples and a brief sorting tutorial, see the `Sorting HowTo
|
For sorting examples and a brief sorting tutorial, see the `Sorting HowTo
|
||||||
<http://wiki.python.org/moin/HowTo/Sorting/>`_ tutorial.
|
<https://wiki.python.org/moin/HowTo/Sorting/>`_ tutorial.
|
||||||
|
|
||||||
(Contributed by Raymond Hettinger.)
|
(Contributed by Raymond Hettinger.)
|
||||||
|
|
||||||
|
@ -1020,7 +1020,7 @@ datetime and time
|
||||||
:issue:`5094`, :issue:`6641`, :issue:`2706`, :issue:`1777412`, :issue:`8013`,
|
:issue:`5094`, :issue:`6641`, :issue:`2706`, :issue:`1777412`, :issue:`8013`,
|
||||||
and :issue:`10827`.)
|
and :issue:`10827`.)
|
||||||
|
|
||||||
.. XXX http://bugs.python.org/issue?%40search_text=datetime&%40sort=-activity
|
.. XXX https://bugs.python.org/issue?%40search_text=datetime&%40sort=-activity
|
||||||
|
|
||||||
math
|
math
|
||||||
----
|
----
|
||||||
|
@ -2283,7 +2283,7 @@ Multi-threading
|
||||||
|
|
||||||
Additional details about the implementation can be read from a `python-dev
|
Additional details about the implementation can be read from a `python-dev
|
||||||
mailing-list message
|
mailing-list message
|
||||||
<http://mail.python.org/pipermail/python-dev/2009-October/093321.html>`_
|
<https://mail.python.org/pipermail/python-dev/2009-October/093321.html>`_
|
||||||
(however, "priority requests" as exposed in this message have not been kept
|
(however, "priority requests" as exposed in this message have not been kept
|
||||||
for inclusion).
|
for inclusion).
|
||||||
|
|
||||||
|
@ -2469,7 +2469,7 @@ Code Repository
|
||||||
|
|
||||||
In addition to the existing Subversion code repository at http://svn.python.org
|
In addition to the existing Subversion code repository at http://svn.python.org
|
||||||
there is now a `Mercurial <http://mercurial.selenic.com/>`_ repository at
|
there is now a `Mercurial <http://mercurial.selenic.com/>`_ repository at
|
||||||
http://hg.python.org/\ .
|
https://hg.python.org/\ .
|
||||||
|
|
||||||
After the 3.2 release, there are plans to switch to Mercurial as the primary
|
After the 3.2 release, there are plans to switch to Mercurial as the primary
|
||||||
repository. This distributed version control system should make it easier for
|
repository. This distributed version control system should make it easier for
|
||||||
|
@ -2560,7 +2560,7 @@ Also, there were a number of updates to the Mac OS X build, see
|
||||||
build, there is a known problem with the default Tcl/Tk on Mac OS X 10.6.
|
build, there is a known problem with the default Tcl/Tk on Mac OS X 10.6.
|
||||||
Accordingly, we recommend installing an updated alternative such as
|
Accordingly, we recommend installing an updated alternative such as
|
||||||
`ActiveState Tcl/Tk 8.5.9 <http://www.activestate.com/activetcl/downloads>`_\.
|
`ActiveState Tcl/Tk 8.5.9 <http://www.activestate.com/activetcl/downloads>`_\.
|
||||||
See http://www.python.org/download/mac/tcltk/ for additional details.
|
See https://www.python.org/download/mac/tcltk/ for additional details.
|
||||||
|
|
||||||
Porting to Python 3.2
|
Porting to Python 3.2
|
||||||
=====================
|
=====================
|
||||||
|
|
|
@ -44,7 +44,7 @@
|
||||||
|
|
||||||
This article explains the new features in Python 3.3, compared to 3.2.
|
This article explains the new features in Python 3.3, compared to 3.2.
|
||||||
Python 3.3 was released on September 29, 2012. For full details,
|
Python 3.3 was released on September 29, 2012. For full details,
|
||||||
see the `changelog <http://docs.python.org/3.3/whatsnew/changelog.html>`_.
|
see the `changelog <https://docs.python.org/3.3/whatsnew/changelog.html>`_.
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
|
||||||
|
@ -2103,7 +2103,7 @@ The :class:`~urllib.request.Request` class, now accepts a *method* argument
|
||||||
used by :meth:`~urllib.request.Request.get_method` to determine what HTTP method
|
used by :meth:`~urllib.request.Request.get_method` to determine what HTTP method
|
||||||
should be used. For example, this will send a ``'HEAD'`` request::
|
should be used. For example, this will send a ``'HEAD'`` request::
|
||||||
|
|
||||||
>>> urlopen(Request('http://www.python.org', method='HEAD'))
|
>>> urlopen(Request('https://www.python.org', method='HEAD'))
|
||||||
|
|
||||||
(:issue:`1673007`)
|
(:issue:`1673007`)
|
||||||
|
|
||||||
|
|
|
@ -62,7 +62,7 @@
|
||||||
|
|
||||||
This article explains the new features in Python 3.4, compared to 3.3.
|
This article explains the new features in Python 3.4, compared to 3.3.
|
||||||
Python 3.4 was released on March 16, 2014. For full details, see the
|
Python 3.4 was released on March 16, 2014. For full details, see the
|
||||||
`changelog <http://docs.python.org/3.4/whatsnew/changelog.html>`_.
|
`changelog <https://docs.python.org/3.4/whatsnew/changelog.html>`_.
|
||||||
|
|
||||||
|
|
||||||
.. seealso::
|
.. seealso::
|
||||||
|
@ -220,7 +220,7 @@ these commands by default, as long as, when invoked, they provide clear and
|
||||||
simple directions on how to install them on that platform (usually using
|
simple directions on how to install them on that platform (usually using
|
||||||
the system package manager).
|
the system package manager).
|
||||||
|
|
||||||
__ http://www.python.org/dev/peps/pep-0453/#recommendations-for-downstream-distributors
|
__ https://www.python.org/dev/peps/pep-0453/#recommendations-for-downstream-distributors
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
@ -242,7 +242,7 @@ As part of this change, the :ref:`installing-index` and
|
||||||
completely redesigned as short getting started and FAQ documents. Most
|
completely redesigned as short getting started and FAQ documents. Most
|
||||||
packaging documentation has now been moved out to the Python Packaging
|
packaging documentation has now been moved out to the Python Packaging
|
||||||
Authority maintained `Python Packaging User Guide
|
Authority maintained `Python Packaging User Guide
|
||||||
<http://packaging.python.org>`__ and the documentation of the individual
|
<https://packaging.python.org>`__ and the documentation of the individual
|
||||||
projects.
|
projects.
|
||||||
|
|
||||||
However, as this migration is currently still incomplete, the legacy
|
However, as this migration is currently still incomplete, the legacy
|
||||||
|
@ -1950,7 +1950,7 @@ Other Improvements
|
||||||
``.py`` extension. (Contributed by Paul Moore in :issue:`18569`.)
|
``.py`` extension. (Contributed by Paul Moore in :issue:`18569`.)
|
||||||
|
|
||||||
* A new ``make`` target `coverage-report
|
* A new ``make`` target `coverage-report
|
||||||
<http://docs.python.org/devguide/coverage.html#measuring-coverage-of-c-code-with-gcov-and-lcov>`_
|
<https://docs.python.org/devguide/coverage.html#measuring-coverage-of-c-code-with-gcov-and-lcov>`_
|
||||||
will build python, run the test suite, and generate an HTML coverage report
|
will build python, run the test suite, and generate an HTML coverage report
|
||||||
for the C codebase using ``gcov`` and `lcov
|
for the C codebase using ``gcov`` and `lcov
|
||||||
<http://ltp.sourceforge.net/coverage/lcov.php>`_.
|
<http://ltp.sourceforge.net/coverage/lcov.php>`_.
|
||||||
|
@ -2166,7 +2166,7 @@ The following obsolete and previously deprecated APIs and features have been
|
||||||
removed:
|
removed:
|
||||||
|
|
||||||
* The unmaintained ``Misc/TextMate`` and ``Misc/vim`` directories have been
|
* The unmaintained ``Misc/TextMate`` and ``Misc/vim`` directories have been
|
||||||
removed (see the `devguide <http://docs.python.org/devguide>`_
|
removed (see the `devguide <https://docs.python.org/devguide>`_
|
||||||
for suggestions on what to use instead).
|
for suggestions on what to use instead).
|
||||||
|
|
||||||
* The ``SO`` makefile macro is removed (it was replaced by the
|
* The ``SO`` makefile macro is removed (it was replaced by the
|
||||||
|
|
Loading…
Reference in New Issue