blob: fc32fb5926b207c548d04bf8750b75ebc0831048 [file] [log] [blame]
Yury Selivanovd1da5072015-05-27 22:09:10 -04001****************************
2 What's New In Python 3.6
3****************************
4
5:Release: |release|
6:Date: |today|
7
8.. Rules for maintenance:
9
10 * Anyone can add text to this document. Do not spend very much time
11 on the wording of your changes, because your text will probably
12 get rewritten to some degree.
13
14 * The maintainer will go through Misc/NEWS periodically and add
15 changes; it's therefore more important to add your changes to
16 Misc/NEWS than to this file.
17
18 * This is not a complete list of every single change; completeness
19 is the purpose of Misc/NEWS. Some changes I consider too small
20 or esoteric to include. If such a change is added to the text,
21 I'll just remove it. (This is another reason you shouldn't spend
22 too much time on writing your addition.)
23
24 * If you want to draw your new text to the attention of the
25 maintainer, add 'XXX' to the beginning of the paragraph or
26 section.
27
28 * It's OK to just add a fragmentary note about a change. For
29 example: "XXX Describe the transmogrify() function added to the
30 socket module." The maintainer will research the change and
31 write the necessary text.
32
33 * You can comment out your additions if you like, but it's not
34 necessary (especially when a final release is some months away).
35
36 * Credit the author of a patch or bugfix. Just the name is
37 sufficient; the e-mail address isn't necessary.
38
39 * It's helpful to add the bug/patch number as a comment:
40
41 XXX Describe the transmogrify() function added to the socket
42 module.
43 (Contributed by P.Y. Developer in :issue:`12345`.)
44
45 This saves the maintainer the effort of going through the Mercurial log
46 when researching a change.
47
48This article explains the new features in Python 3.6, compared to 3.5.
49
50For full details, see the :source:`Misc/NEWS` file.
51
52.. note::
53
54 Prerelease users should be aware that this document is currently in draft
55 form. It will be updated substantially as Python 3.6 moves towards release,
56 so it's worth checking back even after reading earlier versions.
57
58
59Summary -- Release highlights
60=============================
61
62.. This section singles out the most important changes in Python 3.6.
63 Brevity is key.
64
65* None yet.
66
67.. PEP-sized items next.
68
69.. _pep-4XX:
70
71.. PEP 4XX: Virtual Environments
72.. =============================
73
74
75.. (Implemented by Foo Bar.)
76
77.. .. seealso::
78
79 :pep:`4XX` - Python Virtual Environments
80 PEP written by Carl Meyer
81
82
83Other Language Changes
84======================
85
86* None yet.
87
88
89New Modules
90===========
91
92* None yet.
93
94
95Improved Modules
96================
97
Berker Peksagb6c95722015-10-08 13:58:49 +030098datetime
99--------
100
Martin Panterfad4b602015-11-14 01:29:17 +0000101The :meth:`datetime.strftime() <datetime.datetime.strftime>` and
102:meth:`date.strftime() <datetime.date.strftime>` methods now support ISO 8601 date
Berker Peksagb6c95722015-10-08 13:58:49 +0300103directives ``%G``, ``%u`` and ``%V``.
104(Contributed by Ashley Anderson in :issue:`12006`.)
105
106
Serhiy Storchaka0d554d72015-10-10 22:42:18 +0300107pickle
108------
109
Martin Panterfad4b602015-11-14 01:29:17 +0000110Objects that need calling ``__new__`` with keyword arguments can now be pickled
Serhiy Storchaka0d554d72015-10-10 22:42:18 +0300111using :ref:`pickle protocols <pickle-protocols>` older than protocol version 4.
112Protocol version 4 already supports this case. (Contributed by Serhiy
113Storchaka in :issue:`24164`.)
114
115
Martin Panterfad4b602015-11-14 01:29:17 +0000116rlcompleter
117-----------
Serhiy Storchakaab824222015-09-27 13:43:50 +0300118
119Private and special attribute names now are omitted unless the prefix starts
Martin Panterfad4b602015-11-14 01:29:17 +0000120with underscores. A space or a colon is added after some completed keywords.
Serhiy Storchakaab824222015-09-27 13:43:50 +0300121(Contributed by Serhiy Storchaka in :issue:`25011` and :issue:`25209`.)
122
Martin Panter6fe39262015-11-13 23:54:02 +0000123Names of most attributes listed by :func:`dir` are now completed.
124Previously, names of properties and slots which were not yet created on
125an instance were excluded. (Contributed by Martin Panter in :issue:`25590`.)
126
Serhiy Storchakaab824222015-09-27 13:43:50 +0300127
R David Murray4f098062015-11-28 12:24:52 -0500128telnetlib
129---------
130
131:class:`~telnetlib.Telnet` is now a context manager (contributed by
132Stéphane Wirtel in :issue:`25485`).
133
134
Berker Peksag960e8482015-10-08 12:27:06 +0300135urllib.robotparser
136------------------
137
Martin Panterfad4b602015-11-14 01:29:17 +0000138:class:`~urllib.robotparser.RobotFileParser` now supports the ``Crawl-delay`` and
Berker Peksag960e8482015-10-08 12:27:06 +0300139``Request-rate`` extensions.
140(Contributed by Nikolay Bogoychev in :issue:`16099`.)
141
142
Yury Selivanovd1da5072015-05-27 22:09:10 -0400143Optimizations
144=============
145
Martin Panterfad4b602015-11-14 01:29:17 +0000146* The ASCII decoder is now up to 60 times as fast for error handlers
Victor Stinnerebcf9ed2015-10-14 10:10:00 +0200147 ``surrogateescape``, ``ignore`` and ``replace`` (Contributed
148 by Victor Stinner in :issue:`24870`).
Yury Selivanovd1da5072015-05-27 22:09:10 -0400149
Terry Jan Reedy6dc9ce12015-10-20 01:07:53 -0400150* The ASCII and the Latin1 encoders are now up to 3 times as fast for the
Martin Panterfad4b602015-11-14 01:29:17 +0000151 error handler ``surrogateescape`` (Contributed by Victor Stinner in :issue:`25227`).
Victor Stinnerc3713e92015-09-29 12:32:13 +0200152
Martin Panterfad4b602015-11-14 01:29:17 +0000153* The UTF-8 encoder is now up to 75 times as fast for error handlers
Victor Stinnerebcf9ed2015-10-14 10:10:00 +0200154 ``ignore``, ``replace``, ``surrogateescape``, ``surrogatepass`` (Contributed
155 by Victor Stinner in :issue:`25267`).
Victor Stinner01ada392015-10-01 21:54:51 +0200156
Martin Panterfad4b602015-11-14 01:29:17 +0000157* The UTF-8 decoder is now up to 15 times as fast for error handlers
Victor Stinnerebcf9ed2015-10-14 10:10:00 +0200158 ``ignore``, ``replace`` and ``surrogateescape`` (Contributed
159 by Victor Stinner in :issue:`25301`).
160
161* ``bytes % args`` is now up to 2 times faster. (Contributed by Victor Stinner
162 in :issue:`25349`).
163
164* ``bytearray % args`` is now between 2.5 and 5 times faster. (Contributed by
165 Victor Stinner in :issue:`25399`).
Victor Stinner1d65d912015-10-05 13:43:50 +0200166
Victor Stinner2bf89932015-10-14 11:25:33 +0200167* Optimize :meth:`bytes.fromhex` and :meth:`bytearray.fromhex`: they are now
168 between 2x and 3.5x faster. (Contributed by Victor Stinner in :issue:`25401`).
169
Yury Selivanovd1da5072015-05-27 22:09:10 -0400170
171Build and C API Changes
172=======================
173
174* None yet.
175
176
177Deprecated
178==========
179
Yury Selivanov7a219112015-05-28 17:10:29 -0400180New Keywords
181------------
182
Yury Selivanov62f27b52015-08-03 14:57:21 -0400183``async`` and ``await`` are not recommended to be used as variable, class,
184function or module names. Introduced by :pep:`492` in Python 3.5, they will
185become proper keywords in Python 3.7.
Yury Selivanov7a219112015-05-28 17:10:29 -0400186
187
Yury Selivanovd1da5072015-05-27 22:09:10 -0400188Deprecated Python modules, functions and methods
189------------------------------------------------
190
191* None yet.
192
193
194Deprecated functions and types of the C API
195-------------------------------------------
196
197* None yet.
198
199
200Deprecated features
201-------------------
202
Brett Cannon9b638682015-10-16 15:14:27 -0700203* The ``pyvenv`` script has been deprecated in favour of ``python3 -m venv``.
204 This prevents confusion as to what Python interpreter ``pyvenv`` is
205 connected to and thus what Python interpreter will be used by the virtual
206 environment. See :issue:`25154`.
Yury Selivanovd1da5072015-05-27 22:09:10 -0400207
208
209Removed
210=======
211
212API and Feature Removals
213------------------------
214
Yury Selivanovf1b5ccb2015-07-23 17:36:02 +0300215* ``inspect.getargspec()`` was removed (was deprecated since CPython 3.0).
216 :func:`inspect.getfullargspec` is an almost drop in replacement.
Yury Selivanovd1da5072015-05-27 22:09:10 -0400217
Yury Selivanov56613162015-07-23 17:51:34 +0300218* ``inspect.getmoduleinfo()`` was removed (was deprecated since CPython 3.3).
Yury Selivanov6dfbc5d2015-07-23 17:49:00 +0300219 :func:`inspect.getmodulename` should be used for obtaining the module
220 name for a given path.
221
Yury Selivanovd1da5072015-05-27 22:09:10 -0400222
223Porting to Python 3.6
224=====================
225
226This section lists previously described changes and other bugfixes
227that may require changes to your code.
228
229Changes in the Python API
230-------------------------
231
Robert Collinsdfa95c92015-08-10 09:53:30 +1200232* Reading the :attr:`~urllib.parse.SplitResult.port` attribute of
233 :func:`urllib.parse.urlsplit` and :func:`~urllib.parse.urlparse` results
234 now raises :exc:`ValueError` for out-of-range values, rather than
235 returning :const:`None`. See :issue:`20059`.
Yury Selivanovd1da5072015-05-27 22:09:10 -0400236
Brett Cannonc0d91af2015-10-16 12:21:37 -0700237* The :mod:`imp` module now raises a :exc:`DeprecationWarning` instead of
238 :exc:`PendingDeprecationWarning`.
239
Martin Panter28a465c2015-11-14 12:52:08 +0000240* The following modules have had missing APIs added to their :attr:`__all__`
241 attributes to match the documented APIs: :mod:`csv`, :mod:`enum`,
242 :mod:`ftplib`, :mod:`logging`, :mod:`optparse`, :mod:`threading` and
243 :mod:`wave`. This means they will export new symbols when ``import *``
244 is used. See :issue:`23883`.
245
Yury Selivanovd1da5072015-05-27 22:09:10 -0400246
247Changes in the C API
248--------------------
249
250* None yet.