mirror of https://github.com/python/cpython
merge default
This commit is contained in:
commit
dfc23974ed
|
@ -15,6 +15,7 @@ multitasking) Here's an overview:
|
||||||
|
|
||||||
threading.rst
|
threading.rst
|
||||||
multiprocessing.rst
|
multiprocessing.rst
|
||||||
|
concurrent.rst
|
||||||
concurrent.futures.rst
|
concurrent.futures.rst
|
||||||
subprocess.rst
|
subprocess.rst
|
||||||
sched.rst
|
sched.rst
|
||||||
|
|
|
@ -0,0 +1,6 @@
|
||||||
|
The :mod:`concurrent` package
|
||||||
|
=============================
|
||||||
|
|
||||||
|
Currently, there is only one module in this package:
|
||||||
|
|
||||||
|
* :mod:`concurrent.futures` -- Launching parallel tasks
|
|
@ -19,3 +19,10 @@ This module defines utilities to manipulate HTML.
|
||||||
attribute value delimited by quotes, as in ``<a href="...">``.
|
attribute value delimited by quotes, as in ``<a href="...">``.
|
||||||
|
|
||||||
.. versionadded:: 3.2
|
.. versionadded:: 3.2
|
||||||
|
|
||||||
|
--------------
|
||||||
|
|
||||||
|
Submodules in the ``html`` package are:
|
||||||
|
|
||||||
|
* :mod:`html.parser` -- HTML/XHTML parser with lenient parsing mode
|
||||||
|
* :mod:`html.entities` -- HTML entity definitions
|
||||||
|
|
|
@ -0,0 +1,11 @@
|
||||||
|
:mod:`http` --- HTTP modules
|
||||||
|
============================
|
||||||
|
|
||||||
|
``http`` is a package that collects several modules for working with the
|
||||||
|
HyperText Transfer Protocol:
|
||||||
|
|
||||||
|
* :mod:`http.client` is a low-level HTTP protocol client; for high-level URL
|
||||||
|
opening use :mod:`urllib.request`
|
||||||
|
* :mod:`http.server` contains basic HTTP server classes based on :mod:`socketserver`
|
||||||
|
* :mod:`http.cookies` has utilities for implementing state management with cookies
|
||||||
|
* :mod:`http.cookiejar` provides persistence of cookies
|
|
@ -23,10 +23,12 @@ is currently supported on most popular platforms. Here is an overview:
|
||||||
cgi.rst
|
cgi.rst
|
||||||
cgitb.rst
|
cgitb.rst
|
||||||
wsgiref.rst
|
wsgiref.rst
|
||||||
|
urllib.rst
|
||||||
urllib.request.rst
|
urllib.request.rst
|
||||||
urllib.parse.rst
|
urllib.parse.rst
|
||||||
urllib.error.rst
|
urllib.error.rst
|
||||||
urllib.robotparser.rst
|
urllib.robotparser.rst
|
||||||
|
http.rst
|
||||||
http.client.rst
|
http.client.rst
|
||||||
ftplib.rst
|
ftplib.rst
|
||||||
poplib.rst
|
poplib.rst
|
||||||
|
@ -40,6 +42,7 @@ is currently supported on most popular platforms. Here is an overview:
|
||||||
http.server.rst
|
http.server.rst
|
||||||
http.cookies.rst
|
http.cookies.rst
|
||||||
http.cookiejar.rst
|
http.cookiejar.rst
|
||||||
|
xmlrpc.rst
|
||||||
xmlrpc.client.rst
|
xmlrpc.client.rst
|
||||||
xmlrpc.server.rst
|
xmlrpc.server.rst
|
||||||
ipaddress.rst
|
ipaddress.rst
|
||||||
|
|
|
@ -9,20 +9,13 @@ data markup. This includes modules to work with the Standard Generalized Markup
|
||||||
Language (SGML) and the Hypertext Markup Language (HTML), and several interfaces
|
Language (SGML) and the Hypertext Markup Language (HTML), and several interfaces
|
||||||
for working with the Extensible Markup Language (XML).
|
for working with the Extensible Markup Language (XML).
|
||||||
|
|
||||||
It is important to note that modules in the :mod:`xml` package require that
|
|
||||||
there be at least one SAX-compliant XML parser available. The Expat parser is
|
|
||||||
included with Python, so the :mod:`xml.parsers.expat` module will always be
|
|
||||||
available.
|
|
||||||
|
|
||||||
The documentation for the :mod:`xml.dom` and :mod:`xml.sax` packages are the
|
|
||||||
definition of the Python bindings for the DOM and SAX interfaces.
|
|
||||||
|
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
|
||||||
html.rst
|
html.rst
|
||||||
html.parser.rst
|
html.parser.rst
|
||||||
html.entities.rst
|
html.entities.rst
|
||||||
|
xml.rst
|
||||||
xml.etree.elementtree.rst
|
xml.etree.elementtree.rst
|
||||||
xml.dom.rst
|
xml.dom.rst
|
||||||
xml.dom.minidom.rst
|
xml.dom.minidom.rst
|
||||||
|
|
|
@ -0,0 +1,9 @@
|
||||||
|
:mod:`urllib` --- URL handling modules
|
||||||
|
======================================
|
||||||
|
|
||||||
|
``urllib`` is a package that collects several modules for working with URLs:
|
||||||
|
|
||||||
|
* :mod:`urllib.request` for opening and reading URLs
|
||||||
|
* :mod:`urllib.error` containing the exceptions raised by :mod:`urllib.request`
|
||||||
|
* :mod:`urllib.parse` for parsing URLs
|
||||||
|
* :mod:`urllib.robotparser` for parsing ``robots.txt`` files
|
|
@ -0,0 +1,29 @@
|
||||||
|
.. _xml:
|
||||||
|
|
||||||
|
XML Processing Modules
|
||||||
|
======================
|
||||||
|
|
||||||
|
Python's interfaces for processing XML are grouped in the ``xml`` package.
|
||||||
|
|
||||||
|
It is important to note that modules in the :mod:`xml` package require that
|
||||||
|
there be at least one SAX-compliant XML parser available. The Expat parser is
|
||||||
|
included with Python, so the :mod:`xml.parsers.expat` module will always be
|
||||||
|
available.
|
||||||
|
|
||||||
|
The documentation for the :mod:`xml.dom` and :mod:`xml.sax` packages are the
|
||||||
|
definition of the Python bindings for the DOM and SAX interfaces.
|
||||||
|
|
||||||
|
The XML handling submodules are:
|
||||||
|
|
||||||
|
* :mod:`xml.etree.ElementTree`: the ElementTree API, a simple and lightweight
|
||||||
|
|
||||||
|
..
|
||||||
|
|
||||||
|
* :mod:`xml.dom`: the DOM API definition
|
||||||
|
* :mod:`xml.dom.minidom`: a lightweight DOM implementation
|
||||||
|
* :mod:`xml.dom.pulldom`: support for building partial DOM trees
|
||||||
|
|
||||||
|
..
|
||||||
|
|
||||||
|
* :mod:`xml.sax`: SAX2 base classes and convenience functions
|
||||||
|
* :mod:`xml.parsers.expat`: the Expat parser binding
|
|
@ -0,0 +1,12 @@
|
||||||
|
:mod:`xmlrpc` --- XMLRPC server and client modules
|
||||||
|
==================================================
|
||||||
|
|
||||||
|
XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP as a
|
||||||
|
transport. With it, a client can call methods with parameters on a remote
|
||||||
|
server (the server is named by a URI) and get back structured data.
|
||||||
|
|
||||||
|
``xmlrpc`` is a package that collects server and client modules implementing
|
||||||
|
XML-RPC. The modules are:
|
||||||
|
|
||||||
|
* :mod:`xmlrpc.client`
|
||||||
|
* :mod:`xmlrpc.server`
|
|
@ -1094,16 +1094,10 @@ Comparison of objects of the same type depends on the type:
|
||||||
another one is made arbitrarily but consistently within one execution of a
|
another one is made arbitrarily but consistently within one execution of a
|
||||||
program.
|
program.
|
||||||
|
|
||||||
Comparison of objects of the differing types depends on whether either
|
Comparison of objects of the differing types depends on whether either of the
|
||||||
of the types provide explicit support for the comparison. Most numeric types
|
types provide explicit support for the comparison. Most numeric types can be
|
||||||
can be compared with one another, but comparisons of :class:`float` and
|
compared with one another. When cross-type comparison is not supported, the
|
||||||
:class:`Decimal` are not supported to avoid the inevitable confusion arising
|
comparison method returns ``NotImplemented``.
|
||||||
from representation issues such as ``float('1.1')`` being inexactly represented
|
|
||||||
and therefore not exactly equal to ``Decimal('1.1')`` which is. When
|
|
||||||
cross-type comparison is not supported, the comparison method returns
|
|
||||||
``NotImplemented``. This can create the illusion of non-transitivity between
|
|
||||||
supported cross-type comparisons and unsupported comparisons. For example,
|
|
||||||
``Decimal(2) == 2`` and ``2 == float(2)`` but ``Decimal(2) != float(2)``.
|
|
||||||
|
|
||||||
.. _membership-test-details:
|
.. _membership-test-details:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue