Skip to content

Commit 27305ca

Browse files
committed
Update docs/quickstart.rst on standard library imports
1 parent 04fa865 commit 27305ca

File tree

1 file changed

+19
-32
lines changed

1 file changed

+19
-32
lines changed

docs/quickstart.rst

Lines changed: 19 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -85,46 +85,32 @@ be accessed under their Python 3 names and locations in Python 2::
8585
import socketserver
8686
import queue
8787
import configparser
88-
import test.support
89-
import html.parser
9088
from collections import UserList
9189
from itertools import filterfalse, zip_longest
92-
from http.client import HttpConnection
93-
# and other moved modules and definitions
94-
95-
:mod:`future` also includes backports for these stdlib modules from Py3
96-
that were heavily refactored versus Py2::
97-
98-
import html
99-
import html.entities
100-
import html.parser
101-
102-
import http
103-
import http.client
104-
import http.server
105-
import http.cookies
106-
import http.cookiejar
10790

108-
import urllib
109-
import urllib.parse
110-
import urllib.request
111-
import urllib.error
91+
import html
92+
import html.entities
93+
import html.parser
11294

113-
import xmlrpc.client
114-
import xmlrpc.server
95+
import http
96+
import http.client
97+
import http.server
98+
import http.cookies
99+
import http.cookiejar
115100

101+
import xmlrpc.client
102+
import xmlrpc.server
116103

117-
The following modules are currently not supported, but we aim to support them in
118-
the future::
119-
120-
If you need one of these, please open an issue `here
121-
<https://github.com/PythonCharmers/python-future>`_.
104+
``urllib`` currently requires explicit imports because the name clashes with that on Python 2::
122105

123-
For other forms of imports from the standard library, see
124-
:ref:`standard-library-imports`.
106+
from future.standard_library import import_
107+
urllib = import_('urllib')
108+
import_('urllib.parse')
109+
import_('urllib.request')
110+
import_('urllib.error')
125111

126-
For more information on interfaces that have changed in the standard library
127-
between Python 2 and Python 3, see :ref:`stdlib-incompatibilities`.
112+
For an explanation of these and other forms of imports from the standard
113+
library, see :ref:`standard-library-imports`.
128114

129115

130116
.. _py2-dependencies:
@@ -156,6 +142,7 @@ mailing list.
156142

157143
For more information on the automatic translation feature, see :ref:`translation`.
158144

145+
159146
Next steps
160147
----------
161148
For more information about writing Py3/2-compatible code, see :ref:`what-else`.

0 commit comments

Comments
 (0)